---
title: "get posts for a topic"
method: GET
path: "/v1/tool/get-topic-posts"
tags: ["Tool"]
---

# get posts for a topic

`GET /v1/tool/get-topic-posts`

Retrieves posts associated with a topic.
Output should be a list of posts sorted by time or relevance with
text, author, timestamp, permalink, and engagement metrics (if available).

## Query parameters

- `topic_id` string, required

## Response `200`

OK

- PubtoolItemsResponseDomainTweet
  - `count` integer
  - `items` DomainTweet[]
    - `id` string
    - `media_json` string
    - `text` string
    - `user` DomainXUser
      - `blue_verified` boolean
      - `name` string
      - `profile_image` string
      - `screen_name` string
      - `user_id` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.dev/chainbase/apis/data-cloud-task-api.md) · [All operations](https://skmtc.dev/chainbase/apis/data-cloud-task-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainbase/data-cloud-task-api/revisions/4013781aa422/schema)