List Articles

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

string

required

Your Rushed API keyFormat: rsh_live_xxxxxxxxxxxx

Query Parameters

string

Comma-separated enrichment modules. Options: sentiment, market_impact, entities, translations, scoring, classification, metaExample: sentiment,entities

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

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

string

Filter by urgency: CRITICAL, HIGH, MEDIUM, LOW

string

Filter by content type: BREAKING, REPORT, ANALYSIS, INTERVIEW, NEWS, PRESS, RUMOR

boolean

Filter for breaking news only

string

Filter by language: pt, en, es

string

Filter by source domain (comma-separated). Example: reuters.com,bloomberg.com

string

ISO 8601 datetime. Only articles published after this date.

string

ISO 8601 datetime. Only articles published before this date.

string

Full-text search across title, subtitle, and summary

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.

integer

default:"20"

Results per page (1–100)

integer

default:"0"

Number of results to skip

Response

boolean

required

Always true on success

array

required

Array of article objects

Show Article object

string

UUID

string

Original article URL

string

Source name (e.g., Reuters)

string

Article title

string

Article subtitle

string

AI-generated summary

string

ISO 8601 publication date

string

Primary sector code

string

Primary topic code

string

Content type (BREAKING, NEWS, etc.)

string

CRITICAL, HIGH, MEDIUM, LOW

boolean

Whether this is breaking news

string

Article image URL

string

Article language (pt, en, es)

object

required

Show Pagination

integer

Requested limit

integer

Current offset

integer

Total matching articles

boolean

More results available

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
}

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
}

Overview

Articles

Personalized Feed

Preferences

Entities

Subscriptions

Health

Description

Headers

Query Parameters

Response

​Description

​Headers

​Query Parameters

​Response

Description

Headers

Query Parameters

Response