News

Get raw articles (before parsing & enrichment)

Returns raw articles straight from the discovery stage, before HTML parsing and NLP enrichment. This is a fast-churning staging feed (rows are continuously consumed by the pipeline and expire within ~1 day). Enrichment fields (language, categories, topics, entities, sentiment, etc.) are not available at this stage. Supports pagination, source filtering, a published date range, and basic sorting.

post/v1/news/raw

Request

  • Base URL: https://api.apitube.io
  • URL: https://api.apitube.io/v1/news/raw
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Request body

pageinteger

Page number (default 1).

per_pageinteger

Results per page (default 100, max 250; Free is capped at 10, Starter at 50, Basic at 200).

source.idstring

Comma-separated source (sitemap) IDs (max 3).

ignore.source.idstring

Comma-separated source IDs to exclude (max 3).

published_atstring

Single day filter (creates a 24h range). ISO 8601 / YYYY-MM-DD / relative.

published_at.startstring

Start of the publication date range.

published_at.endstring

End of the publication date range.

sort.by'id' | 'published_at' | 'created_at'

Sort field (default id).

sort.order'asc' | 'desc'

Sort direction (default desc).

promptstring

Plain-language description of the news you want. Only PARTIALLY applied here: this endpoint understands published_at.start, published_at.end, sort.order and per_page, so anything else the prompt produced is reported in meta.prompt.ignored with reason "unsupported_on_endpoint". The 2-point translation fee still applies on a cache miss. Available on Basic and above — on Free and Starter the request fails with 403 ER0706.

Example request

{
  "page": 1,
  "per_page": 100,
  "source.id": "123",
  "ignore.source.id": "789",
  "published_at": "2026-05-27",
  "published_at.start": "2026-05-26",
  "published_at.end": "2026-05-27",
  "sort.by": "id",
  "sort.order": "desc"
}

Response

Successful response with raw articles

status'ok'

Response status

limitinteger

Results per page

pathstring

Current request URL

pageinteger

Current page number

has_next_pagesboolean

Whether more pages are available

next_pagestring

URL for the next page (empty if none)

has_previous_pageboolean

Whether a previous page exists

previous_pagestring

URL for the previous page (empty if none)

request_idstring

Unique request identifier

Changes

No recorded changes to this operation across all 1 revision of this API.