Skip to main content
GET
/
api
/
news
List news articles with filters
curl --request GET \
  --url https://api.example.com/api/news \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "url": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "image_url": "<string>",
      "source": "<string>",
      "article_type": "<string>",
      "publish_date": "<string>",
      "language": "<string>",
      "amount_usd": "<string>",
      "round_type": "<string>",
      "deal_date": "<string>",
      "sector": "<string>",
      "hq_country": "<string>",
      "relevance_score": 123,
      "hub_score": 123,
      "enriched_summary": "<string>",
      "entities": [
        {
          "id": 123,
          "name": "<string>",
          "mention_role": "<string>",
          "is_primary": true,
          "sector": "<string>",
          "hq_country": "<string>"
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Auth0 JWT access token

Query Parameters

filter
string

Filter expression for news articles.

Examples:

  • Single: source[eq]:perplexity
  • AND: and(article_type[eq]:vc_round,amount_usd[gte]:1000000)
  • OR: or(source[eq]:perplexity,source[eq]:substack)

Operators: eq, neq, gte, lte, gt, lt, in_any, nin_any Default ref: 'news'

Example:

"and(article_type[eq]:vc_round,amount_usd[gte]:1000000)"

limit
string

Number of results to return (1-2000, default 25)

Example:

"25"

offset
string
Example:

"0"

sort
string
Pattern: ^-?[\w,]+$
Example:

"-publish_date"

include_total
enum<string>
Available options:
true,
false
Example:

"true"

Response

List of news articles

data
object[]
required
page
object
required