Skip to main content
Read public Threads data as JSON through the async task API. Send taskType SOCIAL with platform threads, and pick what to read with action. A completed request costs 0.5 credits.

Request

Submit the task, then poll GET /v1/async/task/{id} or receive its webhook. See Async tasks.

Actions

username takes a username or a profile URL. postUrl takes a post URL, such as https://www.threads.com/@natgeo/post/Dfzi22JJSYp.

Parameters

  • query: Required for search.
  • limit: Optional. search and profile take 1 to 50, default 10. replies takes 1 to 500, default 50.

Response example

Result fields

  • Every response echoes platform and action. Lists carry returnedCount.
  • A post has id, code, url, text, author, authorVerified, publishedAt, mediaType (text, image, video or carousel), images, videoUrl, likeCount, replyCount, repostCount, quoteCount, shareCount and isReply. A reply adds replyTo, the username it answers.
  • search returns posts in the order Threads shows them, up to about 50.
  • profile returns id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, threadCount and recentPosts, the 4 to 13 most recent posts a profile page shows.
  • post returns post. replies returns replies, about 10 per post. availableCount is the post’s reply count, and partial: true marks a list shorter than that count, as when the author hid replies.
  • A profile or post that does not exist or is not public ends the task with PAGE_UNAVAILABLE. Only completed requests are charged.