> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rushed.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your API key and start fetching AI-classified financial news in 5 minutes.

## 1. Get your API key

Sign in to the [Rushed Dashboard](https://dash.therushed.com.br) and create an API key. Your key looks like:

```
rsh_live_xxxxxxxxxxxxxxxxxxxx
```

## 2. Fetch your first articles

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://worker.rushed.com.br/api/articles?limit=5" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch('https://worker.rushed.com.br/api/articles?limit=5', {
    headers: { 'X-API-Key': 'YOUR_API_KEY' }
  });
  const { data } = await res.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      'https://worker.rushed.com.br/api/articles',
      params={'limit': 5},
      headers={'X-API-Key': 'YOUR_API_KEY'}
  )
  articles = res.json()['data']
  ```
</CodeGroup>

Response:

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "550e8400-...",
      "title": "Petrobras announces record dividend payout",
      "publishedAt": "2026-03-28T14:30:00Z",
      "primarySector": "FIN",
      "primaryTopic": "DIV",
      "contentType": "BREAKING",
      "urgencyLevel": "HIGH",
      "isBreaking": true,
      "language": "en"
    }
  ],
  "pagination": { "limit": 5, "offset": 0, "total": 1847, "hasMore": true }
}
```

## 3. Add filters

```bash theme={null}
# Finance sector articles from today
curl "https://worker.rushed.com.br/api/articles?primarySector=FIN&publishedAfter=2026-03-28T00:00:00Z" \
  -H "X-API-Key: YOUR_API_KEY"

# Only breaking news
curl "https://worker.rushed.com.br/api/articles/breaking?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

# Articles about technology M&A
curl "https://worker.rushed.com.br/api/articles?primarySector=TEC&primaryTopic=M%26A" \
  -H "X-API-Key: YOUR_API_KEY"
```

## 4. Request enrichments

Use the `include` parameter to get sentiment, entities, market impact, and more:

```bash theme={null}
curl "https://worker.rushed.com.br/api/articles?include=sentiment,entities&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"
```

Now each article includes:

```json theme={null}
{
  "title": "Petrobras announces record dividend payout",
  "primarySector": "FIN",
  "sentimentScore": 0.82,
  "sentimentLabel": "MUITO_POSITIVO",
  "entities": [
    {
      "canonicalName": "Petrobras",
      "ticker": "PETR4",
      "mentionCount": 12,
      "prominenceScore": 0.95,
      "isInTitle": true
    }
  ]
}
```

<Note>
  Some modules require a Pro plan. See [Include Fields](/guides/include-fields) for the full list.
</Note>

## 5. Search articles

```bash theme={null}
curl "https://worker.rushed.com.br/api/articles/search?q=petrobras+dividendos&include=translations" \
  -H "X-API-Key: YOUR_API_KEY"
```

## 6. Look up entities

```bash theme={null}
# Search for a company
curl "https://worker.rushed.com.br/api/entities/search?q=petrobras" \
  -H "X-API-Key: YOUR_API_KEY"

# Get by stock ticker
curl "https://worker.rushed.com.br/api/entities/by-ticker/PETR4" \
  -H "X-API-Key: YOUR_API_KEY"

# Get articles mentioning an entity
curl "https://worker.rushed.com.br/api/entities/{entityId}/articles?include=sentiment" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Next steps

* [Authentication](/guides/authentication) — Key scopes, expiration, and rotation
* [Include Fields](/guides/include-fields) — All enrichment modules explained
* [AI Classification](/guides/classification) — 25 sectors, 28 topics, sentiment, market impact
* [API Reference](/api-reference/introduction) — Full endpoint documentation with playground