> ## 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-dataset |
| 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/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/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/timeseries-trending-topics-by-id) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.