List Content

Retrieve a list of all content items

GET /v1/content

cURL

curl https://api.raily.ai/v1/content?limit=10&type=article \
  -H "Authorization: Bearer raily_sk_xxxxx"

Response

{
  "object": "list",
  "data": [
    {
      "id": "cnt_abc123xyz",
      "object": "content",
      "externalId": "article-123",
      "title": "Introduction to AI",
      "type": "article",
      "source": "https://example.com/articles/ai-intro",
      "policyId": "pol_default",
      "metadata": {
        "author": "Jane Smith",
        "category": "Technology",
        "wordCount": 2500
      },
      "created": "2024-01-15T10:30:00Z",
      "updated": "2024-01-15T10:30:00Z"
    },
    {
      "id": "cnt_def456abc",
      "object": "content",
      "externalId": "article-124",
      "title": "Machine Learning Basics",
      "type": "article",
      "source": "https://example.com/articles/ml-basics",
      "policyId": "pol_premium",
      "metadata": {
        "author": "John Doe",
        "category": "Technology",
        "wordCount": 3200
      },
      "created": "2024-01-14T09:00:00Z",
      "updated": "2024-01-14T09:00:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cnt_ghi789",
  "totalCount": 156
}

Request

limit · integer · default: "20"

Number of items to return (1-100)

cursor · string

Pagination cursor from previous response

type · string

Filter by content type: article, report, image, dataset, video

policyId · string

Filter by policy ID

created[gte] · string

Filter by creation date (ISO 8601)

created[lte] · string

Filter by creation date (ISO 8601)

expand · string

Expand related objects: policy

Response

object · string

Always list

data · array

Array of content objects

Show Content Object

id · string

Unique identifier (e.g., cnt_abc123)

object · string

Always content

externalId · string

Your external identifier

title · string

Content title

type · string

Content type

source · string

Source URL

policyId · string

Applied policy ID

metadata · object

Custom metadata

created · string

ISO 8601 timestamp

updated · string

ISO 8601 timestamp

hasMore · boolean

Whether more items exist

nextCursor · string

Cursor for next page

totalCount · integer

Total number of matching items

cURL

curl https://api.raily.ai/v1/content?limit=10&type=article \
  -H "Authorization: Bearer raily_sk_xxxxx"

Response

{
  "object": "list",
  "data": [
    {
      "id": "cnt_abc123xyz",
      "object": "content",
      "externalId": "article-123",
      "title": "Introduction to AI",
      "type": "article",
      "source": "https://example.com/articles/ai-intro",
      "policyId": "pol_default",
      "metadata": {
        "author": "Jane Smith",
        "category": "Technology",
        "wordCount": 2500
      },
      "created": "2024-01-15T10:30:00Z",
      "updated": "2024-01-15T10:30:00Z"
    },
    {
      "id": "cnt_def456abc",
      "object": "content",
      "externalId": "article-124",
      "title": "Machine Learning Basics",
      "type": "article",
      "source": "https://example.com/articles/ml-basics",
      "policyId": "pol_premium",
      "metadata": {
        "author": "John Doe",
        "category": "Technology",
        "wordCount": 3200
      },
      "created": "2024-01-14T09:00:00Z",
      "updated": "2024-01-14T09:00:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cnt_ghi789",
  "totalCount": 156
}