---
title: "Search posts for a public Threads topic tag"
method: GET
path: "/threads/search/topics"
tags: ["Threads"]
---

# Search posts for a public Threads topic tag

`GET /threads/search/topics`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/threads/search/topics`
- Auth: API key in header `x-api-key`

Returns the public first page of posts for a topic tag. Discover the required `tag_id` and its canonical query `name` from `/threads/profile/{username}/topics` or a post's `topic` metadata. Topic results have no logged-out continuation cursor; `pagination_limited` marks the login wall for more results.

## Query parameters

- `q` string, required
- `tag_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped topic search payload

- ThreadsTopicSearchResponseDoc
  - `code` integer
  - `data` ThreadsTopicSearchResult
    - `has_more` boolean: Whether Threads reports another page.
    - `items` ThreadsThread[]: Public threads matching the topic tag.
      - `author` ThreadsAuthor
        - `id` string: Threads user ID of the author.
        - `name` string: Display name of the author.
        - `username` string: Threads username of the author.
      - `code` string
      - `created_at` string: Time the thread was posted, in UTC (RFC 3339).
      - `id` string: Threads post ID.
      - `image_urls` string[]: URLs of the images attached to the thread.
      - `is_reply` boolean: Whether the thread is a reply to another thread.
      - `like_count` integer: Number of likes on the thread.
      - `quote_count` integer: Number of times the thread was quoted.
      - `reply_count` integer: Number of replies to the thread.
      - `reply_to` string: Username of the account this thread replies to.
      - `repost_count` integer: Number of times the thread was reposted.
      - `text` string: Text of the thread.
      - `topic` ThreadsTopic
        - `community_emoji` string: Community reaction emoji, when present on a post tag.
        - `community_favicon_url` string: Community icon URL, when present.
        - `display_name` string: Topic label shown in Threads.
        - `id` string: Numeric Threads topic tag identifier.
        - `is_community` boolean: Whether Threads identifies this topic as a community.
        - `name` string: Canonical topic query returned on profile topic lists.
        - `search_query` string: Query to pair with ID when calling the topic search endpoint.
        - `tag_cluster_name` string: Topic cluster or category label, when present.
      - `url` string: URL of the thread on Threads.
      - `video_urls` string[]: URLs of the videos attached to the thread.
    - `pagination_limited` boolean: True when Threads gates further results behind login or provides no supported continuation.
    - `query` string: Search query used by the topic tag.
    - `topic_id` string: Numeric Threads topic tag identifier.
  - `msg` string

## Other responses

- `400`: Invalid query or topic id
- `503`: Upstream error or parser drift

## Changes

- **2026-10-19** `0497899e2016`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crawlora/apis/crawlora-api/changes/threads/search/topics/get.md)

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)