> ## 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 Personalized Feed

> Get a personalized article feed ranked by the user's preferences

## Description

Returns articles ranked by a personalized score calculated from the user's sectors, topics, keywords, and watchlist. Each article includes match reasons explaining why it was scored high.

## Headers

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

## Query Parameters

<ParamField query="minScore" type="number" default="70">Minimum personalized score (0–500+)</ParamField>
<ParamField query="unreadOnly" type="boolean">Only return articles the user hasn't read</ParamField>
<ParamField query="limit" type="integer" default="20">Results per page (1–100)</ParamField>
<ParamField query="offset" type="integer" default="0">Skip results</ParamField>

## Response

<ResponseField name="data" type="array" required>
  <Expandable title="Personalized article">
    <ResponseField name="article" type="object">Full article object</ResponseField>
    <ResponseField name="score" type="number">Personalized score</ResponseField>
    <ResponseField name="matchReasons" type="array">Why this article is relevant</ResponseField>
    <ResponseField name="isRead" type="boolean">Whether the user has read this article</ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "success": true,
    "data": [
      {
        "article": {
          "id": "550e8400-...",
          "title": "Petrobras announces record dividend payout",
          "primarySector": "FIN",
          "primaryTopic": "DIV",
          "isBreaking": true
        },
        "score": 181.7,
        "matchReasons": [
          { "type": "sector", "value": "FIN", "baseWeight": 15, "multiplier": 1.5, "finalWeight": 22.5 },
          { "type": "watchlist", "value": "PETR4", "baseWeight": 20, "multiplier": 3.0, "finalWeight": 60.0 },
          { "type": "keyword", "value": "petrobras (title)", "baseWeight": 12, "multiplier": 2.0, "finalWeight": 24.0 }
        ],
        "isRead": false
      }
    ],
    "pagination": { "limit": 10, "offset": 0, "total": 45, "hasMore": true }
  }
  ```
</ResponseExample>