---
title: "Get Global Topics Timeseries"
method: GET
path: "/topics/v1/daily"
tags: ["Topics"]
---

# Get Global Topics Timeseries

`GET /topics/v1/daily`

## Request

- Base URL: `https://api.messari.io`
- URL: `https://api.messari.io/topics/v1/daily`
- Auth: none required
- TypeScript: <https://skmtc.dev/messari/apis/messari-api-deep-research-v1/docs/topics/v1/daily/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a timeseries of global topics over a specified time range. Returns historical topic data with rankings and associated metadata. Maximum range is 90 days.

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required
- `granularity` '1d' | '1h'
- `assetIDs` string

## Response `200`

Successfully retrieved topics timeseries

- TopicsTimeseriesResponse
  - `error` string, nullable
  - `data` TopicPoint[]
    - `time` integer: Unix timestamp
    - `title` string: Title of the topic
    - `summary` string: Brief summary of the topic
    - `content` string: Detailed content about the topic
    - `classes` string[]: Topic classification tags
    - `topDocuments` TopicDocument[]: Top source documents
      - `url` string: URL of the source document
      - `type` string: Type of document (e.g., x_post, article)
    - `rank` integer: Ranking of the topic at this timestamp
    - `documentCount` number: Number of source documents
    - `assets` AssetEntity[]: Assets associated with this topic
      - `id` string: Asset UUID
      - `name` string: Asset name
      - `symbol` string: Asset symbol
      - `slug` string: Asset slug

## Other responses

- `400`: Bad request - invalid parameters
- `403`: Forbidden - insufficient subscription tier
- `500`: Internal server error

---

[API](https://skmtc.dev/messari/apis/messari-api-deep-research-v1.md) - [All operations](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/revisions/af35b9757e14?raw)
