Skip to main content
GET
/
api
/
articles
curl "https://worker.rushed.com.br/api/articles?primarySector=FIN&urgencyLevel=HIGH&include=sentiment&limit=5" \
  -H "X-API-Key: rsh_live_xxxxxxxxxxxx"

const res = await fetch(
  'https://worker.rushed.com.br/api/articles?primarySector=FIN&include=sentiment&limit=5',
  { headers: { 'X-API-Key': 'rsh_live_xxxxxxxxxxxx' } }
);
const { data, pagination } = await res.json();

import requests

res = requests.get(
    'https://worker.rushed.com.br/api/articles',
    params={'primarySector': 'FIN', 'include': 'sentiment', 'limit': 5},
    headers={'X-API-Key': 'rsh_live_xxxxxxxxxxxx'}
)
articles = res.json()['data']

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "sourceUrl": "https://reuters.com/business/petrobras-dividend",
      "sourceName": "Reuters",
      "title": "Petrobras announces record dividend payout of R$72B",
      "subtitle": "State oil company surprises market with largest-ever distribution",
      "summary": "Petrobras declared its largest-ever dividend distribution of R$72 billion, exceeding analyst expectations by 40%.",
      "publishedAt": "2026-03-28T14:30:00Z",
      "primarySector": "FIN",
      "primaryTopic": "DIV",
      "contentType": "BREAKING",
      "urgencyLevel": "HIGH",
      "isBreaking": true,
      "imageUrl": "https://reuters.com/images/petrobras.jpg",
      "language": "en",
      "sentimentScore": 0.82,
      "sentimentLabel": "MUITO_POSITIVO",
      "sentimentConfidence": 0.91
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 347,
    "hasMore": true
  }
}

{
  "success": false,
  "error": "Invalid or missing API key. Get your key at https://dash.therushed.com.br/api-keys",
  "statusCode": 401
}

{
  "success": false,
  "error": "Rate limit exceeded. Try again in 32 seconds.",
  "statusCode": 429
}

​
Description

Returns a paginated list of articles. Every article includes base fields by default. Use the include parameter to request additional enrichment modules like sentiment, entities, or market impact.

​
Headers

​
X-API-Key
string
required
Your Rushed API keyFormat: rsh_live_xxxxxxxxxxxx

​
Query Parameters

​
include
string
Comma-separated enrichment modules. Options: sentiment, market_impact, entities, translations, scoring, classification, metaExample: sentiment,entities
​
primarySector
string
Filter by primary sector codeOptions: FIN, TEC, SAU, ENE, MAT, IND, CON, IMO, AGR, TRA, COM, SER, GOV, ESP, CRY, FIP, CIE, DEF, CUL, EDU, AMB, SOC, TUR
​
primaryTopic
string
Filter by primary topic codeOptions: M&A, IPO, RES, DIV, REG, POL, MAC, ESG, INO, CRI, EXE, TRB, INT, JUR, EXP, PAR, DEB, TRF, CPT, INF, CLI, SEG, SAP, ELE, TRI, CIB, EDI
​
urgencyLevel
string
Filter by urgency: CRITICAL, HIGH, MEDIUM, LOW
​
contentType
string
Filter by content type: BREAKING, REPORT, ANALYSIS, INTERVIEW, NEWS, PRESS, RUMOR
​
isBreaking
boolean
Filter for breaking news only
​
language
string
Filter by language: pt, en, es
​
source
string
Filter by source domain (comma-separated). Example: reuters.com,bloomberg.com
​
publishedAfter
string
ISO 8601 datetime. Only articles published after this date.
​
publishedBefore
string
ISO 8601 datetime. Only articles published before this date.
​
q
string
Full-text search across title, subtitle, and summary
​
sort
string
default:"publishedAt"
Sort order:
  • publishedAt — most recent first (default)
  • baseScore — highest quality score first
  • urgencyLevel — most urgent first (CRITICAL > HIGH > MEDIUM > LOW)
  • relevance — composite of score + recency. Best for feeds that need both quality and freshness. A score-60 article from 1h ago ranks higher than a score-80 article from 2 days ago.
​
limit
integer
default:"20"
Results per page (1–100)
​
offset
integer
default:"0"
Number of results to skip

​
Response

​
success
boolean
required
Always true on success
​
data
array
required
Array of article objects
​
pagination
object
required
curl "https://worker.rushed.com.br/api/articles?primarySector=FIN&urgencyLevel=HIGH&include=sentiment&limit=5" \
  -H "X-API-Key: rsh_live_xxxxxxxxxxxx"

const res = await fetch(
  'https://worker.rushed.com.br/api/articles?primarySector=FIN&include=sentiment&limit=5',
  { headers: { 'X-API-Key': 'rsh_live_xxxxxxxxxxxx' } }
);
const { data, pagination } = await res.json();

import requests

res = requests.get(
    'https://worker.rushed.com.br/api/articles',
    params={'primarySector': 'FIN', 'include': 'sentiment', 'limit': 5},
    headers={'X-API-Key': 'rsh_live_xxxxxxxxxxxx'}
)
articles = res.json()['data']

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "sourceUrl": "https://reuters.com/business/petrobras-dividend",
      "sourceName": "Reuters",
      "title": "Petrobras announces record dividend payout of R$72B",
      "subtitle": "State oil company surprises market with largest-ever distribution",
      "summary": "Petrobras declared its largest-ever dividend distribution of R$72 billion, exceeding analyst expectations by 40%.",
      "publishedAt": "2026-03-28T14:30:00Z",
      "primarySector": "FIN",
      "primaryTopic": "DIV",
      "contentType": "BREAKING",
      "urgencyLevel": "HIGH",
      "isBreaking": true,
      "imageUrl": "https://reuters.com/images/petrobras.jpg",
      "language": "en",
      "sentimentScore": 0.82,
      "sentimentLabel": "MUITO_POSITIVO",
      "sentimentConfidence": 0.91
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 347,
    "hasMore": true
  }
}

{
  "success": false,
  "error": "Invalid or missing API key. Get your key at https://dash.therushed.com.br/api-keys",
  "statusCode": 401
}

{
  "success": false,
  "error": "Rate limit exceeded. Try again in 32 seconds.",
  "statusCode": 429
}