---
title: "Search public Threads posts"
method: GET
path: "/threads/search"
tags: ["Threads"]
---

# Search public Threads posts

`GET /threads/search`

## Request

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

Returns the public first page of Threads search results for a query. `sort` supports `top` and `recent`; `pagination_limited` marks the logged-out login wall because search has no continuation cursor. Author and date filters in Threads require login and are not exposed here.

## Query parameters

- `q` string, required
- `sort` 'top' | 'recent'

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped search payload

- ThreadsSearchResponseDoc
  - `code` integer
  - `data` ThreadsSearchResult
    - `has_more` boolean: Whether more results are available after this page.
    - `items` ThreadsThread[]: Threads matching the search, one entry per post.
      - `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.
    - `next_cursor` string: Cursor to pass to fetch the next page of results.
    - `pagination_limited` boolean: True when Threads gates further results behind login or provides no supported continuation.
    - `query` string: Search query that was run.
    - `sort` string: Result ordering selected for the search.
  - `msg` string

## Other responses

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

## Changes

- **2026-10-19** `0497899e2016`: 1 info
  - added the new optional `query` request parameter `sort`

[Operation history](https://skmtc.dev/crawlora/apis/crawlora-api/changes/threads/search/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)