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

# Topics

> A topic trending on X: title, summary, trending and popularity scores, sentiment, document count, classes, top documents and the assets mentioned. Each series is one topic, keyed by its topic id.

|                  |                                                                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Access           | News\_research\_unified                                                                                                |
| Timeseries model | `trending-topics`: intervals `1d`, series key `trending-topic-id` (Topic ID), series must be named (up to 20 per call) |

## Endpoints

<CardGroup cols={2}>
  <Card title="Batch Get Topic timeseries" icon="arrow-right" href="/api-reference/data-api/news-research/timeseries-trending-topics">
    Up to 20 series in one request, named by Topic ID in `series`.
  </Card>

  <Card title="Get Topic timeseries" icon="arrow-right" href="/api-reference/data-api/news-research/timeseries-trending-topics-by-id">
    One series over a time window, keyed by its Topic ID.
  </Card>
</CardGroup>

## Metrics

12 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field                        | Name                       | Type          | Unit | Description                                                                 |
| ---------------------------- | -------------------------- | ------------- | ---- | --------------------------------------------------------------------------- |
| `title`                      | Title                      | string        |      | The title of the topic.                                                     |
| `summary`                    | Summary                    | string        |      | The summary of the topic.                                                   |
| `content`                    | Content                    | string        |      | The content of the topic.                                                   |
| `trending-score`             | Trending Score             | float64       |      | The trending score of the topic.                                            |
| `popularity-score`           | Popularity Score           | float64       |      | The popularity score of the topic.                                          |
| `average-document-timestamp` | Average Document Timestamp | time          |      | The average timestamp of the documents in the topic.                        |
| `sentiment-score`            | Sentiment Score            | float64       |      | The sentiment score of the topic.                                           |
| `document-count`             | Document Count             | int64         |      | The number of documents in the topic.                                       |
| `classes`                    | Classes                    | array\_string |      | The classes the topic is categorized under.                                 |
| `top-documents`              | Top Documents              | array\_object |      | The most relevant documents within the topic, each with its type and URL.   |
| `asset-ids`                  | Asset IDs                  | array\_string |      | The unique identifiers of the assets mentioned in the topic.                |
| `assets`                     | Assets                     | array\_object |      | The assets mentioned in the topic, each with its id, slug, name and symbol. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/trending-topics/1d/<trending-topic-id>?timeframe=7d&selections=title,summary" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Topic timeseries](/api-reference/data-api/news-research/timeseries-trending-topics-by-id) for the response and the errors.