Skip to main content
GET
/
api
/
data
/
news
List news articles
curl --request GET \
  --url https://api-next.dealroom.co/api/data/news \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 9876543,
      "url": "https://techcrunch.com/2024/06/15/example-startup-raises-50m",
      "slug": "example-startup-raises-50m-series-b-2024",
      "title": "Example Startup raises $50M Series B led by Sequoia",
      "summary": "Example Startup announced a $50M Series B round…",
      "image_url": "https://images.example.com/news/article-9876543.jpg",
      "source": "techcrunch",
      "article_type": "vc_round",
      "publish_date": "2024-06-15",
      "amount": 50000000,
      "round_type": "SERIES_B",
      "deal_date": "2024-06-14",
      "sector": "Fintech",
      "hq_country": "United States",
      "enriched_summary": "Example Startup, a San Francisco-based fintech…",
      "importance_score": 87.5,
      "is_pinned": false,
      "entities": [
        {
          "uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
          "name": "<string>",
          "mention_role": "<string>",
          "is_primary": true,
          "sector": "<string>",
          "hq_country": "<string>",
          "industries": [
            "Fintech",
            "Enterprise Software"
          ]
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "total": 123,
    "capped": true,
    "ecosystem": "<string>"
  },
  "currency": "<string>"
}

Authorizations

Authorization
string
header
required

OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations.

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
integer<int32>
default:25

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

Required range: 1 <= x <= 2000
Example:

25

offset
integer<int32>
default:0

Number of results to skip before returning data. Combine with limit for offset-based pagination.

Required range: x >= 0
Example:

0

cursor
string

Opaque cursor token from a previous response's page.next_cursor or page.prev_cursor. Round-trip it as-is — do not decode or modify.

Example:

"eyJ2IjoxLCJkIjoibmV4dCJ9"

sort
string

Sort by one or more keys. Prefix with - for descending order; comma-separated for multi-key sorts.

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

"-publish_date"

include_total
boolean

Pass true to include page.total (the matching record count) in the response. Default omits the total to avoid a count query.

Example:

true

currency
string

ISO 4217 currency code for monetary field conversion. Defaults to USD.

Example:

"EUR"

Response

List of news articles

data
object[]
required
page
object
required
currency
string
required