> ## 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 by Sector

> Retrieve articles filtered by primary sector

## Description

Returns a paginated list of articles for a specific sector. Useful for building sector-specific feeds (e.g., a Finance dashboard, Technology news widget).

## Headers

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

## Path Parameters

<ParamField path="sector" type="string" required>
  Sector code: `FIN`, `TEC`, `SAU`, `ENE`, `MAT`, `IND`, `CON`, `IMO`, `AGR`, `TRA`, `COM`, `SER`, `GOV`, `ESP`, `CRY`, `FIP`, `CIE`, `DEF`, `CUL`, `EDU`, `AMB`, `SOC`, `TUR`
</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>

## Response

<ResponseField name="success" type="boolean" required />

<ResponseField name="data" type="array" required>
  Array of articles in the requested sector
</ResponseField>

<ResponseField name="pagination" type="object" required>
  Pagination metadata (limit, offset, total, hasMore)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://worker.rushed.com.br/api/articles/by-sector/TEC?include=translations&limit=10" \
    -H "X-API-Key: rsh_live_xxxxxxxxxxxx"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch(
    'https://worker.rushed.com.br/api/articles/by-sector/TEC?include=translations&limit=10',
    { headers: { 'X-API-Key': 'rsh_live_xxxxxxxxxxxx' } }
  );
  const { data } = await res.json();
  ```

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

  res = requests.get(
      'https://worker.rushed.com.br/api/articles/by-sector/TEC',
      params={'include': 'translations', 'limit': 10},
      headers={'X-API-Key': 'rsh_live_xxxxxxxxxxxx'}
  )
  tech_articles = res.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "770a0600-a4ad-63f6-c938-668877662222",
        "sourceName": "TechCrunch",
        "title": "Brazilian fintech Nubank launches AI-powered credit scoring",
        "publishedAt": "2026-03-28T12:15:00Z",
        "primarySector": "TEC",
        "primaryTopic": "INO",
        "contentType": "NEWS",
        "urgencyLevel": "MEDIUM",
        "isBreaking": false,
        "language": "en",
        "titlePt": "Fintech brasileira Nubank lanca scoring de credito com IA",
        "summaryPt": "O Nubank anunciou um novo modelo de scoring de credito baseado em inteligencia artificial..."
      }
    ],
    "pagination": {
      "limit": 10,
      "offset": 0,
      "total": 89,
      "hasMore": true
    }
  }
  ```
</ResponseExample>