REST API

The REST API lets your own code read a project’s articles, mark them published, and track external URLs for AI citation attribution. Webhooks tell your code when an article is ready for review or has been published. Set it up in Integrations → REST API. Each API key belongs to one project. To work across all your projects, or from an AI assistant, use the MCP server. The two kinds of key aren’t interchangeable.

Create an API key

Go to Integrations → REST API.
Click Create API Key.
Copy the key shown under Your API Key. It won’t be shown again.

Keys start with cf_. A project has one key at a time. Regenerate (the refresh icon) replaces it and the old key stops working immediately. Remove (the trash icon) revokes it. Viewers can’t manage keys or webhooks. Keep the key in a secret store, out of version control and client-side code.

Authentication

Send the key in either header:

Authorization: Bearer YOUR_API_KEY

X-API-Key: YOUR_API_KEY

An ?api_key=YOUR_API_KEY query parameter also works, but prefer a header.

Base URL

https://chatfeatured.com/api/v1

Rate limit

Each API key allows 100 requests per minute. Over the limit, requests fail with 429 Too Many Requests and {"error": "Rate limit exceeded."}. Wait a minute before retrying.

Endpoints

List articles

GET /articles

Lists the project’s articles in one status, newest first.

Parameter	Type	Description
`status`	string	`published` (default), `review`, `awaiting_approval`, `approved` or `scheduled`. Any other value returns `400`.
`limit`	number	Results per page. Default 20, maximum 100.
`offset`	number	Pagination offset. Default 0.

curl "https://chatfeatured.com/api/v1/articles?status=published&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "data": [
    {
      "id": "abc123",
      "title": "How to Optimize for AI Search",
      "slug": "how-to-optimize-for-ai-search",
      "status": "published",
      "excerpt": "A guide to...",
      "metaDescription": "Learn how to optimize...",
      "content": "<p>Full HTML content...</p>",
      "featuredImageUrl": "https://example.com/image.jpg",
      "scheduledAt": null,
      "publishedAt": "2026-03-20T12:00:00.000Z",
      "priority": "medium",
      "wordCount": 1200,
      "readingTimeMinutes": 5,
      "createdAt": "2026-03-19T10:00:00.000Z",
      "updatedAt": "2026-03-20T12:00:00.000Z",
      "metadata": {
        "articleType": "guide",
        "description": "A guide to AI search optimization"
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 10,
    "offset": 0
  }
}

content is HTML. metadata is free-form, so don’t rely on its shape.

Get one article

GET /articles/{idOrSlug}

Fetches one article by ID or slug, in any status.

curl https://chatfeatured.com/api/v1/articles/how-to-optimize-for-ai-search \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is a data object with the same fields as the list. It returns 404 if no article in the project matches.

Mark an article published

POST /articles/{idOrSlug}/publish

This marks the article published in ChatFeatured (and on a live Blog CMS). It doesn’t send it to a connected CMS such as WordPress or Webflow. Put the article live on your site first, then call this with the live URL.

Only articles in review or approved can be published. Any other status returns 400, including one that’s already published. Optional JSON body:

Parameter	Type	Description
`externalUrls`	string[]	Live http or https URLs where the article is published. Used to attribute AI citations to the article and submitted for indexing.

curl -X POST https://chatfeatured.com/api/v1/articles/abc123/publish \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalUrls": ["https://example.com/blog/my-article"]}'

Response:

{
  "success": true,
  "data": {
    "id": "abc123",
    "status": "published",
    "publishedAt": "2026-03-20T12:00:00.000Z"
  }
}

Publishing also sends the article.published webhook if you’ve turned it on.

Track external content

POST /tracked-content

Tracks a URL you published somewhere else, a LinkedIn post for example, so AI citations of it count toward your project. Tracked URLs appear in the Content impact widget on the dashboard.

Parameter	Type	Description
`url`	string	Required. An http or https URL.
`publishedAt`	string	Optional ISO 8601 date. Overrides the date read from the page.

curl -X POST https://chatfeatured.com/api/v1/tracked-content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/pulse/my-article"}'

Response (201):

{
  "success": true,
  "data": {
    "id": "abc123",
    "url": "https://www.linkedin.com/pulse/my-article",
    "normalizedUrl": "https://linkedin.com/pulse/my-article",
    "title": "My Article",
    "description": "A post about AI search...",
    "imageUrl": "https://example.com/image.jpg",
    "publishedAt": "2026-03-20T12:00:00.000Z",
    "domain": "linkedin.com",
    "createdAt": "2026-03-20T12:00:00.000Z",
    "updatedAt": "2026-03-20T12:00:00.000Z"
  }
}

Returns 409 if the URL is already tracked or linked to an article.

List tracked content

GET /tracked-content

Lists the project’s tracked URLs, most recently added first. Takes limit (default 20, maximum 100) and offset.

curl "https://chatfeatured.com/api/v1/tracked-content?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is a data array with the same fields as above, plus the pagination object.

Webhooks

ChatFeatured sends a POST to your URL when an article is ready for review or has been published.

Set up a webhook

Create an API key first; the Webhooks card appears after.

Go to Integrations → REST API.
In Webhooks, enter your Webhook URL.
Optionally enter a Signing Secret (optional). ChatFeatured uses it to sign each request.
Under Events, turn on Article ready for review, Article published, or both.
Click Save Webhook Settings.

Once a URL is saved, Send Test sends a sample article.published payload with placeholder content.

When each event fires

article.review fires when ChatFeatured finishes writing an article and it moves to review. article.published fires every time an article moves to published, however it got there: a CMS or Blog CMS publish from the dashboard or MCP, marking it published by hand, the REST API’s publish endpoint, or a scheduled publish reaching its time.

Payload

Both events send the same shape, with the full article. content is HTML.

{
  "event": "article.published",
  "timestamp": "2026-03-20T12:00:00.000Z",
  "data": {
    "id": "abc123",
    "title": "Your Article Title",
    "slug": "your-article-title",
    "status": "published",
    "excerpt": "A brief excerpt...",
    "metaDescription": "Meta description...",
    "content": "<p>Full HTML content...</p>",
    "featuredImageUrl": "https://example.com/image.jpg",
    "scheduledAt": null,
    "publishedAt": "2026-03-20T12:00:00.000Z",
    "priority": "medium",
    "wordCount": 1200,
    "readingTimeMinutes": 5,
    "createdAt": "2026-03-19T10:00:00.000Z",
    "updatedAt": "2026-03-20T12:00:00.000Z",
    "metadata": {
      "articleType": "guide",
      "description": "A brief excerpt..."
    }
  }
}

Delivery

Each event is sent once. Your endpoint has 10 seconds to answer with a 2xx; otherwise the event is dropped, not retried. Answer quickly and do the work in the background.

Verify the signature

With a signing secret, each request carries an X-Webhook-Signature header: the hex-encoded HMAC-SHA256 of the raw request body, keyed with your secret. Compute it over the raw bytes, before JSON parsing.

import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")

const crypto = require("crypto");

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("hex");
  if (typeof signature !== "string" || signature.length !== expected.length) {
    return false;
  }
  return crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(signature, "hex")
  );
}

Errors

Errors return JSON with an error field:

{
  "error": "Article not found"
}

Status	When
`400`	Invalid parameter, or publishing an article that isn’t in `review` or `approved`
`401`	Missing, invalid or removed key. Check the header format and that the key wasn’t regenerated.
`403`	Not this project’s REST API key, for example an MCP key (`"This API key is not authorized for the articles API"`)
`404`	No article in the project matches the ID or slug
`409`	The URL is already tracked or already linked to an article
`429`	The key went over 100 requests per minute (`"Rate limit exceeded."`)
`500`	Server error

Example: publish on your own site

Publish approved articles to your own site, then record each one in ChatFeatured so the live URL is tracked for citations.

import os
import requests

API = "https://chatfeatured.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CHATFEATURED_API_KEY']}"}

def publish_on_my_site(article) -> str:
    # Your own publishing code. Return the live URL.
    raise NotImplementedError

response = requests.get(
    f"{API}/articles",
    params={"status": "approved", "limit": 100},
    headers=HEADERS,
)
response.raise_for_status()

for article in response.json()["data"]:
    live_url = publish_on_my_site(article)
    requests.post(
        f"{API}/articles/{article['id']}/publish",
        json={"externalUrls": [live_url]},
        headers=HEADERS,
    ).raise_for_status()

Troubleshooting

Webhook never arrives

Check the event is on and you clicked Save Webhook Settings, and that the URL is public and answers with a 2xx within 10 seconds. Send Test shows the status code your endpoint returned.

Getting started

Using ChatFeatured

Index submissions

AI agent

Integrations

Account

Create an API key

Authentication

Base URL

Rate limit

Endpoints

List articles

Get one article

Mark an article published

Track external content

List tracked content

Webhooks

Set up a webhook

When each event fires

Payload

Delivery

Verify the signature

Errors

Example: publish on your own site

Troubleshooting

​Create an API key

​Authentication

​Base URL

​Rate limit

​Endpoints

​List articles

​Get one article

​Mark an article published

​Track external content

​List tracked content

​Webhooks

​Set up a webhook

​When each event fires

​Payload

​Delivery

​Verify the signature

​Errors

​Example: publish on your own site

​Troubleshooting

Create an API key

Authentication

Base URL

Rate limit

Endpoints

List articles

Get one article

Mark an article published

Track external content

List tracked content

Webhooks

Set up a webhook

When each event fires

Payload

Delivery

Verify the signature

Errors

Example: publish on your own site

Troubleshooting