Threads Search

2 credits

Search Threads for posts.

POST/api/v1/tools/threads/search

Parameters

querystringrequired

Search query string.

maxResultsnumber

Maximum number of results to return. Must be a positive integer. Defaults to 100. Upper bound is determined by your plan.

Response Schema

dataobject

Threads search result

postsobject[]

Matching posts.

countnumber

Number of posts returned

metaobject

Request metadata

toolstring

Tool name (threads-search)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/threads/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "product launch feedback"
  }'

Response Example

{
  "data": {
    "posts": [
      {
        "id": "def456",
        "author": "startupfounder",
        "text": "We just launched our new product and the early feedback has been amazing. Thank you to everyone who tried it on day one.",
        "createdAt": "2026-04-09T18:00:00.000Z",
        "url": "https://www.threads.net/@startupfounder/post/def456",
        "likes": 340
      }
    ],
    "count": 1
  },
  "meta": {
    "tool": "threads-search",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}