> ## 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.

# Get Articles Mentioning Entity

> Retrieve articles where a specific entity was mentioned, with mention metadata

## Description

Returns articles that mention a specific entity. Each article includes the standard base fields plus optional enrichments via `include`. Useful for tracking news about a specific company, person, or ticker.

## Headers

<ParamField header="X-API-Key" type="string" required>
  Your Rushed API key
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  Entity UUID
</ParamField>

## Query Parameters

<ParamField query="include" type="string">
  Comma-separated enrichment modules
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Results per page (1–100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://worker.rushed.com.br/api/entities/a1b2c3d4-e5f6-7890-abcd-ef1234567890/articles?include=sentiment&limit=5" \
    -H "X-API-Key: rsh_live_xxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  import requests
  res = requests.get(
      'https://worker.rushed.com.br/api/entities/a1b2c3d4-e5f6-7890-abcd-ef1234567890/articles',
      params={'include': 'sentiment', 'limit': 5},
      headers={'X-API-Key': 'rsh_live_xxxxxxxxxxxx'}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "sourceName": "Reuters",
        "title": "Petrobras announces record dividend payout of R$72B",
        "publishedAt": "2026-03-28T14:30:00Z",
        "primarySector": "FIN",
        "primaryTopic": "DIV",
        "isBreaking": true,
        "sentimentScore": 0.82,
        "sentimentLabel": "MUITO_POSITIVO"
      }
    ],
    "pagination": { "limit": 5, "offset": 0, "total": 47, "hasMore": true }
  }
  ```
</ResponseExample>