Articles

Publisher Article search, retrieval, related reading, and monitoring.

List top headlines

GET

https://api.cafecito.tech

/beans/news/top-headlines

Returns news Articles from the recent 24-hour window, ordered by attention. Fixed to news; does not accept content_type, ids, urls, from, or to. Unknown or inapplicable query parameters return HTTP 400.

List top headlines › query Parameters

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

full_content

boolean

Request available body content. Availability is not a grant of republication, redistribution, archival, training, or other downstream rights. Handle a missing content value, preserve the canonical url, and follow https://cafecito.tech/docs/third-party-content-policy/.

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

List top headlines › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List top headlines › Responses

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/news/top-headlines

curl https://api.cafecito.tech/beans/news/top-headlines \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJzIjoidHJlbmRfc2NvcmUiLCJpZCI6IjVjZjk3NDAwLTY1ZTAtNTllZi1hZWMxLWFiNGU3YjA3ZTljMCIsInRzIjowfQ"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:40.160758718Z"
  },
  "data": [
    {
      "id": "5cf97400-65e0-59ef-aec1-ab4e7b07e9c0",
      "url": "https://www.theguardian.com/us-news/2026/aug/23/hakeem-jeffries-jared-kushner-meeting",
      "content_type": "news",
      "published_at": "2026-08-23T17:55:52Z",
      "author": null,
      "image_url": "https://i.guim.co.uk/img/media/9c27978883c3099f3b215f8e74787e2ead13ad64/0_0_5000_4000/master/5000.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2cleft&overlay-width=100p&overlay-base64=l2ltzy9zdgf0awmvb3zlcmxhexmvdgctzgvmyxvsdc5wbmc&enable=upscale&s=fa0ea6e83cfaf04224f9cf17d1d4ca89",
      "title": "Democrats incredulous over Hakeem Jeffries and Jared Kushner meeting",
      "summary": null,
      "categories": [
        "internet_culture_and_social_media",
        "elections_and_voting"
      ],
      "regions": [
        "maryland",
        "illinois",
        "iran"
      ],
      "entities": null,
      "sentiments": [
        "contemplative",
        "observant"
      ],
      "tags": [
        "internet_culture_and_social_media",
        "elections_and_voting",
        "maryland",
        "illinois",
        "iran"
      ],
      "story_id": "3e44a72a-be72-5465-82b6-c5ffd43d474e",
      "source": null
    }
  ]
}

json

application/json

List latest news

GET

https://api.cafecito.tech

/beans/news/latest

Returns news Articles ordered newest first. News-scoped shortcut equivalent to GET /beans/articles/latest?content_type=news. Does not accept content_type, ids, urls, from, or to. Unknown or inapplicable query parameters return HTTP 400.

List latest news › query Parameters

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

List latest news › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List latest news › Responses

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/news/latest

curl https://api.cafecito.tech/beans/news/latest \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZCIsImlkIjoiM2E0NzllM2MtYTg3ZC01OTFlLWJiNmMtNWM4M2MwM2I2YTQwIiwiYyI6IjIwMjYtMDgtMjRUMDI6MDA6NDNaIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:39.633280927Z"
  },
  "data": [
    {
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai",
      "content_type": "news",
      "published_at": "2026-08-24T02:00:43Z",
      "author": "Carrington Malin",
      "image_url": null,
      "title": "UAE AI Programme adds Agentic AI focus",
      "summary": "Listen now | Middle East AI News Minute - 24-Aug-26",
      "categories": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models"
      ],
      "regions": null,
      "entities": [
        "carrington_malin"
      ],
      "sentiments": [
        "disturbed",
        "anxious"
      ],
      "tags": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models",
        "carrington_malin"
      ],
      "story_id": "06860aaa-a43c-585f-9cb3-a6710a93a74a",
      "source": null
    }
  ]
}

json

application/json

GET

https://api.cafecito.tech

/beans/news/trending

Returns attention-ranked news Articles with trend metrics when available. News-scoped shortcut equivalent to GET /beans/articles/trending?content_type=news. Does not accept content_type, ids, urls, from, or to. Unknown or inapplicable query parameters return HTTP 400.

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/news/trending

curl https://api.cafecito.tech/beans/news/trending \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJzIjoidHJlbmRfc2NvcmUiLCJpZCI6IjVjZjk3NDAwLTY1ZTAtNTllZi1hZWMxLWFiNGU3YjA3ZTljMCIsInRzIjowfQ"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:40.160758718Z"
  },
  "data": [
    {
      "id": "5cf97400-65e0-59ef-aec1-ab4e7b07e9c0",
      "url": "https://www.theguardian.com/us-news/2026/aug/23/hakeem-jeffries-jared-kushner-meeting",
      "content_type": "news",
      "published_at": "2026-08-23T17:55:52Z",
      "author": null,
      "image_url": "https://i.guim.co.uk/img/media/9c27978883c3099f3b215f8e74787e2ead13ad64/0_0_5000_4000/master/5000.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2cleft&overlay-width=100p&overlay-base64=l2ltzy9zdgf0awmvb3zlcmxhexmvdgctzgvmyxvsdc5wbmc&enable=upscale&s=fa0ea6e83cfaf04224f9cf17d1d4ca89",
      "title": "Democrats incredulous over Hakeem Jeffries and Jared Kushner meeting",
      "summary": null,
      "categories": [
        "internet_culture_and_social_media",
        "elections_and_voting"
      ],
      "regions": [
        "maryland",
        "illinois",
        "iran"
      ],
      "entities": null,
      "sentiments": [
        "contemplative",
        "observant"
      ],
      "tags": [
        "internet_culture_and_social_media",
        "elections_and_voting",
        "maryland",
        "illinois",
        "iran"
      ],
      "story_id": "3e44a72a-be72-5465-82b6-c5ffd43d474e",
      "source": null,
      "trend": {
        "likes": 542,
        "comments": 56805,
        "mentions": 2,
        "audiences": 0,
        "related": 0,
        "trend_score": 1420406
      }
    }
  ]
}

json

application/json

List latest Articles

GET

https://api.cafecito.tech

/beans/articles/latest

Returns Articles ordered newest first. Does not accept ids, urls, from, or to. Unknown or inapplicable query parameters return HTTP 400.

List latest Articles › query Parameters

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

content_type

string · enum

Filterable Article type. post is response-only: content_type=post returns HTTP 400. The other 14 stored types remain filterable. Omit to include every stored type.

Enum values:

blog

contract

earnings_report

enforcement_action

financial_report

lawsuit

news

official_statement

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

List latest Articles › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List latest Articles › Responses

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/articles/latest

curl https://api.cafecito.tech/beans/articles/latest \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZCIsImlkIjoiM2E0NzllM2MtYTg3ZC01OTFlLWJiNmMtNWM4M2MwM2I2YTQwIiwiYyI6IjIwMjYtMDgtMjRUMDI6MDA6NDNaIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:39.633280927Z"
  },
  "data": [
    {
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai",
      "content_type": "news",
      "published_at": "2026-08-24T02:00:43Z",
      "author": "Carrington Malin",
      "image_url": null,
      "title": "UAE AI Programme adds Agentic AI focus",
      "summary": "Listen now | Middle East AI News Minute - 24-Aug-26",
      "categories": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models"
      ],
      "regions": null,
      "entities": [
        "carrington_malin"
      ],
      "sentiments": [
        "disturbed",
        "anxious"
      ],
      "tags": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models",
        "carrington_malin"
      ],
      "story_id": "06860aaa-a43c-585f-9cb3-a6710a93a74a",
      "source": null
    }
  ]
}

json

application/json

GET

https://api.cafecito.tech

/beans/articles/trending

Returns attention-ranked Articles with trend metrics when available. Does not accept ids, urls, from, or to. Unknown or inapplicable query parameters return HTTP 400.

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

content_type

string · enum

Filterable Article type. post is response-only: content_type=post returns HTTP 400. The other 14 stored types remain filterable. Omit to include every stored type.

Enum values:

blog

contract

earnings_report

enforcement_action

financial_report

lawsuit

news

official_statement

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/articles/trending

curl https://api.cafecito.tech/beans/articles/trending \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJzIjoidHJlbmRfc2NvcmUiLCJpZCI6Ijg2NWQxZWJiLTFkMWYtNWQ5MS05MmMxLWZhYzA1YjNjNGMzOCIsInRzIjoxNDIwNDA2fQ"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:39.843232871Z"
  },
  "data": [
    {
      "id": "865d1ebb-1d1f-5d91-92c1-fac05b3c4c38",
      "url": "https://www.reddit.com/r/PS5/comments/1h4tety/ps5_help_and_questions_megathread_game/",
      "content_type": "post",
      "published_at": "2024-12-02T12:02:22Z",
      "author": "tinselsnips",
      "image_url": null,
      "title": "PS5 Help and Questions Megathread | Game Recommendations, Simple Questions, and Tech Support",
      "summary": null,
      "categories": [
        "Video Games and Game Development",
        "Interactive Entertainment and Streaming"
      ],
      "regions": null,
      "entities": [
        "PlayStation",
        "Google"
      ],
      "sentiments": [
        "frustrated",
        "doubtful"
      ],
      "tags": [
        "Video Games and Game Development",
        "Interactive Entertainment and Streaming",
        "PlayStation",
        "Google"
      ],
      "story_id": "865d1ebb-1d1f-5d91-92c1-fac05b3c4c38",
      "source": null,
      "trend": {
        "likes": 542,
        "comments": 56805,
        "mentions": 2,
        "audiences": 0,
        "related": 0,
        "trend_score": 1420406
      }
    }
  ]
}

json

application/json

Search Articles

GET

https://api.cafecito.tech

/beans/articles/search

Returns Articles matching an optional relevance query, exact Article IDs or URLs, and filters. Without q, results are newest first. content_type=post returns HTTP 400. Unknown query parameters return HTTP 400.

Search Articles › query Parameters

q

string · maxLength: 512

Optional relevance query. When supplied, score_threshold may be omitted. score_threshold without q returns HTTP 400. On Sources and label routes, a case-insensitive prefix query.

score_threshold

number · min: 0 · max: 1

Optional relevance threshold used only with q. Rejected when q is absent.

ids

string[] · maxItems: 100 · style: form

Exact Article UUIDs (CSV).

urls

string[] · maxItems: 100 · style: form

Exact Article URLs (CSV).

content_type

string · enum

Filterable Article type. post is response-only: content_type=post returns HTTP 400. The other 14 stored types remain filterable. Omit to include every stored type.

Enum values:

blog

contract

earnings_report

enforcement_action

financial_report

lawsuit

news

official_statement

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

from

string · date

UTC lower timestamp bound. YYYY-MM-DD means 00:00:00Z.

to

string · date

UTC upper timestamp bound. YYYY-MM-DD means 00:00:00Z.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

Search Articles › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search Articles › Responses

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/articles/search

curl https://api.cafecito.tech/beans/articles/search \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJpZCI6IjNhNDc5ZTNjLWE4N2QtNTkxZS1iYjZjLTVjODNjMDNiNmE0MCIsImMiOiIyMDI2LTA4LTI0VDAyOjAwOjQzWiJ9"
  },
  "meta": {
    "as_of": "2026-08-24T20:42:39.854289295Z"
  },
  "data": [
    {
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai",
      "content_type": "news",
      "published_at": "2026-08-24T02:00:43Z",
      "author": "Carrington Malin",
      "image_url": null,
      "title": "UAE AI Programme adds Agentic AI focus",
      "summary": "Listen now | Middle East AI News Minute - 24-Aug-26",
      "categories": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models"
      ],
      "regions": null,
      "entities": [
        "carrington_malin"
      ],
      "sentiments": [
        "disturbed",
        "anxious"
      ],
      "tags": [
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models",
        "carrington_malin"
      ],
      "story_id": "06860aaa-a43c-585f-9cb3-a6710a93a74a",
      "source": null
    }
  ]
}

json

application/json

Get an Article

GET

https://api.cafecito.tech

/beans/articles/{id}

Returns one Article selected by UUID. Set full_content=true to request available body content. Availability is not a grant of republication, redistribution, archival, training, or other downstream rights; preserve the canonical URL and follow https://cafecito.tech/docs/third-party-content-policy/.

Get an Article › path Parameters

id

string · uuid · required

Article or Source UUID.

Get an Article › query Parameters

full_content

boolean

Default: false

Get an Article › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get an Article › Responses

Successful response.

ArticleDetailResponse

ArticleDetail · required

GET/beans/articles/{id}

curl https://api.cafecito.tech/beans/articles/:id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
    "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai",
    "content_type": "news",
    "published_at": "2026-08-24T02:00:43Z",
    "author": "Carrington Malin",
    "image_url": null,
    "title": "UAE AI Programme adds Agentic AI focus",
    "summary": "Listen now | Middle East AI News Minute - 24-Aug-26",
    "categories": [
      "artificial_intelligence_and_machine_learning",
      "generative_ai_and_foundation_models"
    ],
    "regions": null,
    "entities": [
      "carrington_malin"
    ],
    "sentiments": [
      "disturbed",
      "anxious"
    ],
    "tags": [
      "artificial_intelligence_and_machine_learning",
      "generative_ai_and_foundation_models",
      "carrington_malin"
    ],
    "story_id": "06860aaa-a43c-585f-9cb3-a6710a93a74a",
    "source": null,
    "trend": {
      "likes": 0,
      "comments": 0,
      "mentions": 0,
      "audiences": 0,
      "related": 53,
      "trend_score": 2650
    },
    "links": {
      "similar": "/articles/3a479e3c-a87d-591e-bb6c-5c83c03b6a40/similar",
      "mentions": "/articles/3a479e3c-a87d-591e-bb6c-5c83c03b6a40/mentions",
      "story": "/stories/06860aaa-a43c-585f-9cb3-a6710a93a74a"
    }
  }
}

json

application/json

GET

https://api.cafecito.tech

/beans/articles/{id}/similar

Returns related Articles for a selected Article UUID, ordered newest first. It is not a relevance-ranked search route.

id

string · uuid · required

Article or Source UUID.

content_type

string · enum

Filterable Article type. post is response-only: content_type=post returns HTTP 400. The other 14 stored types remain filterable. Omit to include every stored type.

Enum values:

blog

contract

earnings_report

enforcement_action

financial_report

lawsuit

news

official_statement

sources

string[] · maxItems: 128 · style: form

Source UUIDs to include (CSV).

exclude_sources

string[] · maxItems: 128 · style: form

Source UUIDs to exclude (CSV).

domains

string[] · maxItems: 100 · style: form

Source domain values to include (CSV).

exclude_domains

string[] · maxItems: 100 · style: form

Source domain values to exclude (CSV).

authors

string[] · maxItems: 100 · style: form

Author text filters. Every supplied value must match (CSV).

categories

string[] · maxItems: 100 · style: form

Category values to include (CSV).

exclude_categories

string[] · maxItems: 100 · style: form

Category values to exclude (CSV).

regions

string[] · maxItems: 100 · style: form

Region values to include (CSV).

entities

string[] · maxItems: 100 · style: form

Entity values to include (CSV).

sentiments

string[] · maxItems: 100 · style: form

Sentiment values to include (CSV).

tags

string[] · maxItems: 100 · style: form

Normalized tag terms. Every supplied term must match (CSV).

languages

string[] · maxItems: 100 · style: form

ISO 639 language codes to include (CSV). Any listed value matches. A stored language matches if it equals a listed code or starts with that code.

from

string · date

UTC lower timestamp bound. YYYY-MM-DD means 00:00:00Z.

to

string · date

UTC upper timestamp bound. YYYY-MM-DD means 00:00:00Z.

full_content

boolean

Default: false

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Successful response.

ArticleCollectionResponse

Pagination · required

ResponseMeta · required

Article[] · required

GET/beans/articles/{id}/similar

curl https://api.cafecito.tech/beans/articles/:id/similar \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pagination": {
    "limit": 0,
    "num_results": 0,
    "next_cursor": "next_cursor"
  },
  "meta": {
    "as_of": "2024-08-25T15:00:00Z"
  },
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "url": "url",
      "content_type": "blog",
      "published_at": "2024-08-25T15:00:00Z",
      "author": "author",
      "image_url": "image_url",
      "title": "title",
      "summary": "summary",
      "content": "content",
      "language": "language",
      "categories": [
        "string"
      ],
      "regions": [
        "string"
      ],
      "entities": [
        "string"
      ],
      "sentiments": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "story_id": "00000000-0000-0000-0000-000000000000",
      "source": {
        "id": "00000000-0000-0000-0000-000000000000",
        "url": "url",
        "domain": "domain",
        "name": "name",
        "description": "description",
        "favicon_url": "favicon_url",
        "rss_feed_url": "rss_feed_url"
      },
      "trend": {
        "likes": 0,
        "comments": 0,
        "mentions": 0,
        "related": 0,
        "trend_score": 0,
        "audiences": 0
      }
    }
  ]
}

json

application/json

List Article mentions

GET

https://api.cafecito.tech

/beans/articles/{id}/mentions

Returns external platform or forum observations for the selected Article UUID, ordered by observation time.

List Article mentions › path Parameters

id

string · uuid · required

Article or Source UUID.

List Article mentions › query Parameters

platforms

string[] · maxItems: 100 · style: form

Mention platforms to include (CSV).

forums

string[] · maxItems: 100 · style: form

Mention forums to include (CSV).

from

string · date

UTC lower timestamp bound. YYYY-MM-DD means 00:00:00Z.

to

string · date

UTC upper timestamp bound. YYYY-MM-DD means 00:00:00Z.

limit

integer · min: 1 · max: 100

Maximum records in the page.

Default: 20

cursor

string

Opaque continuation token from pagination.next_cursor. Send it unchanged as the next request cursor. Never construct or decode cursor tokens.

List Article mentions › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List Article mentions › Responses

Successful response.

MentionCollectionResponse

Pagination · required

ResponseMeta · required

Mention[] · required

Sources

Articles

List top headlines

List top headlines › query Parameters

List top headlines › Headers

List top headlines › Responses

List latest news

List latest news › query Parameters

List latest news › Headers

List latest news › Responses

List trending news

List trending news › query Parameters

List trending news › Headers

List trending news › Responses

List latest Articles

List latest Articles › query Parameters

List latest Articles › Headers

List latest Articles › Responses

List trending Articles

List trending Articles › query Parameters

List trending Articles › Headers

List trending Articles › Responses

Search Articles

Search Articles › query Parameters

Search Articles › Headers

Search Articles › Responses

Get an Article

Get an Article › path Parameters

Get an Article › query Parameters

Get an Article › Headers

Get an Article › Responses

List related Articles

List related Articles › path Parameters

List related Articles › query Parameters

List related Articles › Headers

List related Articles › Responses

List Article mentions

List Article mentions › path Parameters

List Article mentions › query Parameters

List Article mentions › Headers

List Article mentions › Responses