Developer docs · v1

Radio Content Pro API reference

Everything you need to pull Radio Content Pro stories into your own site, app or CMS: authentication, every endpoint, every field and every error, with examples you can paste.

Make your first request What you can build

Version 1 · JSON over HTTPS · HTTP Basic auth

On this page

Overview

A small REST API over HTTPS

Three GET endpoints return the stories your subscription includes as JSON, plus their images. It’s the same API the Radio Content Pro WordPress plugin uses.

Base URL

https://app.radiocontentpro.com/wp-json/rcp/v1

The API at a glance
Format	JSON over HTTPS. Images come back as files.
Auth	HTTP Basic: your account email and your API password.
Methods	GET only. The API reads; it never changes your account.
Window	Posts from the last 7 days.
Pages	20 posts a page by default, up to 50.
Rate limit	Up to 100 requests a minute per username.
Errors	WordPress REST style: { code, message, data: { status } }.

Already using the API?

From November 9, 2026 it runs on the new Radio Content Pro platform. The base URL, your login and the response shape stay the same, so there’s nothing to change.

Quickstart

Your first request in three steps

Get your API password.
Email support@radiocontentpro.com from your account email. Your username is that email.
Call GET /feed.
With HTTP Basic auth, from your server.
Publish what comes back.
Each post has a headline, a blog post in HTML, an image and categories.

Your first request · cURL

curl -u you@station.com:YOUR_API_PASSWORD \
  'https://app.radiocontentpro.com/wp-json/rcp/v1/feed?per_page=5&fields=id,title,published,link,blog_post_title,blog_post_html,featured_image,categories'

Response · 200 OK

[
  {
    "id": 1000000000482,
    "title": "Surprise reunion tops the awards show",
    "published": "2026-11-09T11:00:00+00:00",
    "link": "https://app.radiocontentpro.com/app/story/48213",
    "blog_post_title": "A surprise reunion stole the awards show",
    "blog_post_html": "<p>The band hadn’t shared a stage in ten years. Last night they did.</p><p>Here’s what happened, and why fans can’t stop talking about it.</p>",
    "featured_image": {
      "url": "https://images.example.com/awards-reunion.jpg",
      "title": "Surprise reunion tops the awards show",
      "alt": "The band on stage at the awards show",
      "caption": "",
      "description": "",
      "width": 1200,
      "height": 800,
      "download_url": "https://app.radiocontentpro.com/wp-json/rcp/v1/media/1000000000482"
    },
    "categories": [
      {
        "id": 7,
        "slug": "pop-culture-news",
        "name": "Pop Culture News"
      }
    ]
  }
]

Authentication

HTTP Basic, with your account email

Send an Authorization header on every request. There are no tokens to fetch or refresh.

Credentials
Username	Your Radio Content Pro account email. Sites set up before the new platform can keep the username they already use.
Password	Your API password. It isn’t your sign-in password. Spaces in it are ignored, so a grouped paste works.

Get an API password

Email support@radiocontentpro.com from your account email and we’ll send one. Ask the same address to replace it if it leaks. Existing plugin and API logins carry over to the new platform; if yours stops working, email us for a new one.

The header

Authorization: Basic base64(you@station.com:YOUR_API_PASSWORD)

Keep it on your server

Your API password reads your subscription’s content. Call the API from your server or CMS, not from browser code: the API sends no CORS headers, so a browser on another site can’t call it anyway.

A missing or wrong credential gets a 401 with the code rest_auth. An account whose subscription includes no stories still authenticates: its feed is an empty list.

Endpoints

All under https://app.radiocontentpro.com/wp-json/rcp/v1.

Every endpoint
Endpoint	What it does
GET /feed	List the posts your subscription includes, newest first.
GET /posts/{id}	Get one post by its ID.
GET /media/{id}	Download a post’s featured image.

GET`/feed`

The posts from the last 7 days in the categories your subscription includes, newest first. An account whose subscription includes none gets an empty list with a 200, never an error.

Endpoint

GET https://app.radiocontentpro.com/wp-json/rcp/v1/feed

Parameters

Parameters for GET /feed
Name	In	Type	Default	Description
`per_page`	query	integer	20	Posts per page, 1 to 50. Anything else is a 400.
`page`	query	integer	1	Which page. Past the last page you get an empty list.
`after`	query	string (ISO 8601)	—	Only posts published after this time. Anything earlier than 7 days ago reads as 7 days ago, and a value that isn’t a date is ignored.
`fields`	query	string	the default set	Comma-separated field names, or all. Unknown names are skipped, not an error.

Response

200 OK. A JSON array of post objects (no wrapper object).

Response headers for GET /feed
Header	Meaning
`X-WP-Total`	How many posts match, across all pages.
`X-WP-TotalPages`	How many pages that makes at this per_page.
`Cache-Control`	max-age=300: the page can be reused for 5 minutes.

Errors

Errors for GET /feed
Status	Code	When
400	`rest_invalid_param`	per_page isn’t a number from 1 to 50.
401	`rest_auth`	The Authorization header is missing, isn’t Basic, or the username and password don’t match.
429	`rate_limit_exceeded`	Too many requests in one minute for the same username (the limit is up to 100). Wait for the next minute.

Example

GET /feed · cURL

curl -u you@station.com:YOUR_API_PASSWORD \
  'https://app.radiocontentpro.com/wp-json/rcp/v1/feed?per_page=5&fields=id,title,published,link,blog_post_title,blog_post_html,featured_image,categories'

Example response

[
  {
    "id": 1000000000482,
    "title": "Surprise reunion tops the awards show",
    "published": "2026-11-09T11:00:00+00:00",
    "link": "https://app.radiocontentpro.com/app/story/48213",
    "blog_post_title": "A surprise reunion stole the awards show",
    "blog_post_html": "<p>The band hadn’t shared a stage in ten years. Last night they did.</p><p>Here’s what happened, and why fans can’t stop talking about it.</p>",
    "featured_image": {
      "url": "https://images.example.com/awards-reunion.jpg",
      "title": "Surprise reunion tops the awards show",
      "alt": "The band on stage at the awards show",
      "caption": "",
      "description": "",
      "width": 1200,
      "height": 800,
      "download_url": "https://app.radiocontentpro.com/wp-json/rcp/v1/media/1000000000482"
    },
    "categories": [
      {
        "id": 7,
        "slug": "pop-culture-news",
        "name": "Pop Culture News"
      }
    ]
  }
]

GET`/posts/{id}`

One post object. A post older than 7 days is a 404, like a post that doesn’t exist.

Endpoint

GET https://app.radiocontentpro.com/wp-json/rcp/v1/posts/{id}

Parameters

Parameters for GET /posts/{id}
Name	In	Type	Default	Description
`id` (required)	path	integer	—	The post’s id, from the feed.
`fields`	query	string	the default set	As on /feed.

Response

200 OK. A JSON post object.

Response headers for GET /posts/{id}
Header	Meaning
`Cache-Control`	max-age=600: the post can be reused for 10 minutes.
`Last-Modified`	When the post last changed.

Errors

Errors for GET /posts/{id}
Status	Code	When
401	`rest_auth`	The Authorization header is missing, isn’t Basic, or the username and password don’t match.
403	`forbidden`	The post exists but isn’t in a category your subscription includes.
404	`not_found`	No post has that ID, it’s older than 7 days, or the ID isn’t a positive whole number.
429	`rate_limit_exceeded`	Too many requests in one minute for the same username (the limit is up to 100). Wait for the next minute.

Example

GET /posts/{id} · cURL

curl -u you@station.com:YOUR_API_PASSWORD \
  'https://app.radiocontentpro.com/wp-json/rcp/v1/posts/1000000000482?fields=id,title,blog_post_html'

Example response

{
  "id": 1000000000482,
  "title": "Surprise reunion tops the awards show",
  "blog_post_html": "<p>The band hadn’t shared a stage in ten years. Last night they did.</p><p>Here’s what happened, and why fans can’t stop talking about it.</p>"
}

GET`/media/{id}`

The image file itself, not JSON. You don’t build this URL: it’s featured_image.download_url on a post. Fetch it with the same credentials, from your server.

Endpoint

GET https://app.radiocontentpro.com/wp-json/rcp/v1/media/{id}

Parameters

Parameters for GET /media/{id}
Name	In	Type	Default	Description
`id` (required)	path	integer	—	The image’s id, the last part of featured_image.download_url.

Response

200 OK. The image bytes.

Response headers for GET /media/{id}
Header	Meaning
`Content-Type`	The image’s type, such as image/jpeg.
`Content-Disposition`	attachment, with the file name.

Errors

Errors for GET /media/{id}
Status	Code	When
401	`rest_auth`	The Authorization header is missing, isn’t Basic, or the username and password don’t match.
403	`forbidden`	The image belongs only to posts outside your subscription’s categories.
404	`not_found`	No post you can see uses that image, or the image can’t be fetched.
429	`rate_limit_exceeded`	Too many requests in one minute for the same username (the limit is up to 100). Wait for the next minute.

Example

GET /media/{id} · cURL

curl -u you@station.com:YOUR_API_PASSWORD -o story.jpg \
  'https://app.radiocontentpro.com/wp-json/rcp/v1/media/1000000000482'

Reference

The post object

Every field a post can carry (65). Text is never null: a field a post doesn’t have is an empty string. Only featured_image and featured_image_html can be null.

The story

The story: fields
Field	Type	Description
`id`Default	integer	The post’s ID. Use it with /posts/{id}, and to skip posts you already have.
`slug`	string	A URL-friendly version of the title.
`title`Default	string	The headline.
`published`Default	string (ISO 8601)	When the post was published, with a UTC offset.
`modified`	string (ISO 8601)	When the post last changed.
`link`Default	string (URL)	The story in Radio Content Pro.
`excerpt`	string	The first 40 words of the post, as plain text.
`content_html`	string (HTML)	The whole post.
`content_text`	string	The whole post as plain text.

The blog post

What the WordPress plugin publishes. Build on these.

The blog post: fields
Field	Type	Description
`blog_post_title`Default	string	The blog post’s headline.
`blog_post_html`Default	string (HTML)	The blog post, ready to publish.
`blog_post_text`	string	The blog post as plain text.

Image and categories

Image and categories: fields
Field	Type	Description
`featured_image`Default	object or null	url, title, alt, caption, description, width, height and download_url. download_url is /media/{id} on this API: fetch it with the same credentials. null when the post has no image.
`featured_image_html`Default	string (HTML) or null	A ready-made <img> tag. null when the post has no image.
`categories`Default	array	The post’s categories, each { id, slug, name }.

On-air and social pieces

Kept so integrations built on them keep working. Many posts don’t carry them, and then they’re empty strings. Check before you use one.

On-air and social pieces: fields
Field	Type	Description
`tease_1`Default	string (HTML)	An on-air tease.
`tease_1_text`	string	An on-air tease. Plain text.
`tease_2`Default	string (HTML)	A second tease.
`tease_2_text`	string	A second tease. Plain text.
`tease_3`Default	string (HTML)	A third tease.
`tease_3_text`	string	A third tease. Plain text.
`10_second_script`Default	string (HTML)	A 10-second read.
`10_second_script_text`	string	A 10-second read. Plain text.
`20_second_script`Default	string (HTML)	A 20-second read.
`20_second_script_text`	string	A 20-second read. Plain text.
`commentary_video_script`Default	string (HTML)	A video commentary script.
`commentary_video_script_text`	string	A video commentary script. Plain text.
`edgy_response`Default	string (HTML)	An edgier take.
`edgy_response_text`	string	An edgier take. Plain text.
`mainstream_response`Default	string (HTML)	A mainstream take.
`mainstream_response_text`	string	A mainstream take. Plain text.
`family_friendly_response`Default	string (HTML)	A family-friendly take.
`family_friendly_response_text`	string	A family-friendly take. Plain text.
`phone_topic_1`Default	string (HTML)	A caller topic.
`phone_topic_1_text`	string	A caller topic. Plain text.
`phone_topic_2`Default	string (HTML)	A second caller topic.
`phone_topic_2_text`	string	A second caller topic. Plain text.
`phone_topic_3`Default	string (HTML)	A third caller topic.
`phone_topic_3_text`	string	A third caller topic. Plain text.
`phone_topic_4`Default	string (HTML)	A fourth caller topic.
`phone_topic_4_text`	string	A fourth caller topic. Plain text.
`facebook_post`	string (HTML)	A Facebook post.
`facebook_post_text`	string	A Facebook post. Plain text.
`instagram_post`	string (HTML)	An Instagram caption.
`instagram_post_text`	string	An Instagram caption. Plain text.
`x_post_edgy`	string (HTML)	An X post, edgy.
`x_post_edgy_text`	string	An X post, edgy. Plain text.
`x_post_mainstream`	string (HTML)	An X post, mainstream.
`x_post_mainstream_text`	string	An X post, mainstream. Plain text.
`x_post_family_friendly`	string (HTML)	An X post, family-friendly.
`x_post_family_friendly_text`	string	An X post, family-friendly. Plain text.
`other_social_thought_starter_edgy_1`	string (HTML)	A social prompt, edgy.
`other_social_thought_starter_edgy_1_text`	string	A social prompt, edgy. Plain text.
`other_social_thought_starter_edgy_2`	string (HTML)	A second social prompt, edgy.
`other_social_thought_starter_edgy_2_text`	string	A second social prompt, edgy. Plain text.
`other_social_thought_starter_mainstream_1`	string (HTML)	A social prompt, mainstream.
`other_social_thought_starter_mainstream_1_text`	string	A social prompt, mainstream. Plain text.
`other_social_thought_starter_mainstream_2`	string (HTML)	A second social prompt, mainstream.
`other_social_thought_starter_mainstream_2_text`	string	A second social prompt, mainstream. Plain text.
`other_social_thought_starter_family_friendly_1`	string (HTML)	A social prompt, family-friendly.
`other_social_thought_starter_family_friendly_1_text`	string	A social prompt, family-friendly. Plain text.
`other_social_thought_starter_family_friendly_2`	string (HTML)	A second social prompt, family-friendly.
`other_social_thought_starter_family_friendly_2_text`	string	A second social prompt, family-friendly. Plain text.
`ai_image_generation_prompt`Default	string	A description of an image for the story. Plain text.
`ai_image_generation_prompt_text`	string	The same, plain text.

Reference

Choosing fields

Add fields to /feed or /posts/{id} to get only what you use. Smaller responses, faster pages.

The fields parameter
Request	Returns
`/feed`	The default set. No fields parameter: the 23 most-used fields.
`/feed?fields=all`	Every field. all (or *) returns all 65.
`/feed?fields=id,title,blog_post_html,featured_image`	Just what a website needs. A list of names, comma-separated.

Names you misspell, or that don’t exist, are skipped without an error, so check your first response. The fields marked Default in the post object are the default set.

Reference

Pagination and new posts

The feed is newest first, 20 posts a page unless you set per_page (up to 50). The totals come back as headers.

Paging the feed
`X-WP-Total`	How many posts match.
`X-WP-TotalPages`	How many pages at your per_page. A page past the last returns [].

Read every page · JavaScript

// Read the whole 7-day window, page by page
async function allPosts(auth) {
  const posts = []
  for (let page = 1; ; page++) {
    const res = await fetch(`https://app.radiocontentpro.com/wp-json/rcp/v1/feed?per_page=50&page=${page}`, {
      headers: { Authorization: `Basic ${auth}` },
    })
    posts.push(...(await res.json()))
    if (page >= Number(res.headers.get('X-WP-TotalPages'))) return posts
  }
}

Only what’s new

Pass the time of your last check as after to get only posts published since. Keep the ids of posts you’ve already used, and skip them.

Posts since 6am UTC · cURL

curl -u you@station.com:YOUR_API_PASSWORD \
  'https://app.radiocontentpro.com/wp-json/rcp/v1/feed?after=2026-11-09T06:00:00Z'

Reference

Errors

Every error has the same JSON shape, with the HTTP status repeated inside it.

Error body

{
  "code": "rest_auth",
  "message": "Authentication required",
  "data": {
    "status": 401
  }
}

Every error the API returns
Status	Code	Message	When
400	`rest_invalid_param`	Invalid parameter(s): per_page	per_page isn’t a number from 1 to 50.
401	`rest_auth`	Authentication required	The Authorization header is missing, isn’t Basic, or the username and password don’t match.
403	`forbidden`	Not permitted to view this post	The post exists but isn’t in a category your subscription includes.
403	`forbidden`	Not permitted to access this file	The image belongs only to posts outside your subscription’s categories.
404	`not_found`	Post not found	No post has that ID, it’s older than 7 days, or the ID isn’t a positive whole number.
404	`not_found`	Media not found	No post you can see uses that image, or the image can’t be fetched.
429	`rate_limit_exceeded`	Too many requests. Please slow down.	Too many requests in one minute for the same username (the limit is up to 100). Wait for the next minute.

Reference

Limits and caching

Limits
Rate limit	Up to 100 requests a minute per username. Over it, you get a `429` until the next minute.
Window	The last 7 days. Older posts leave the feed and `/posts/{id}` returns `404` for them, so keep your own copy of anything you publish.
Page size	Up to 50 posts a request.
Caching	A feed page can be reused for 5 minutes and a post for 10 (`Cache-Control`). Checking every few minutes is plenty.

Reference

Changelog

Version 1. Changes that affect integrations are listed here.

2026-11-09
The API moves to the new platform
Same base URL, same login, same response shape. Integrations that already work need no changes.

On WordPress? The WordPress plugin uses this API for you, with no code. Questions about the API: support@radiocontentpro.com.

Ava Hart smiling, ready to help with your show

Ask Ava

Stuck on an endpoint? Ask me about this page.

Not a member yet?

The API is included with Radio Content Pro. Start your free trial, then email support for your API password.

Start your 7-day free trial Book a demo

No card needed · Cancel anytime

Radio Content Pro API reference

A small REST API over HTTPS

Your first request in three steps

Get your API password.

Call GET /feed.

Publish what comes back.

HTTP Basic, with your account email

Get an API password

Endpoints

GET/feed

Parameters

Response

Errors

Example

GET/posts/{id}

Parameters

Response

Errors

Example

GET/media/{id}

Parameters

Response

Errors

Example

The post object

The story

The blog post

Image and categories

On-air and social pieces

Choosing fields

Pagination and new posts

Only what’s new

Errors

Limits and caching

Changelog

The API moves to the new platform

Not a member yet?

GET`/feed`

GET`/posts/{id}`

GET`/media/{id}`