All endpoints
Threads Posts

Threads Posts API

Search Threads posts by keyword. Returns post text, engagement metrics (likes, replies, reposts, quotes, reshares), author metadata, attached media (images, video, carousels), link previews, and publication date. Results are sourced from public posts on Threads.

Price: $0.006 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/threads/posts

Parameters

query *
Search keyword (max 500 characters)
pages
Number of pages to fetch, 1-200 (default: 1). The first page returns about 20 posts and later pages about 10; you are billed per page returned.
get_sentiment
Set to true to add AI emotion analysis (+$0.001/page)

Response fields

posts
Array of matching posts
title
Post title (format: @username on Threads)
url
Direct link to the post
date
Publication date and time (UTC, YYYY-MM-DD HH:MM:SS)
author
Author's Threads username
source
Platform name (Threads)
domain
threads.com
snippet
Post text content
likes
Number of likes
replies
Number of replies
reposts
Number of reposts
quotes
Number of quote posts
reshares
Number of times reshared to other surfaces
author_name
Author's display name (empty on some search results)
author_verified
Whether the author is verified
is_reply
Whether the post is a reply
media_type
Post type: text, image, video, or carousel
image_url
Cover image URL for image/video/carousel posts, empty for text-only (temporary; valid ~6-24 hours)
video_url
Direct video URL for video posts, empty otherwise (temporary; valid ~6-24 hours)
width
Media width in pixels (0 when not applicable)
height
Media height in pixels (0 when not applicable)
has_audio
Whether the post's video has audio
reply_control
Who can reply (e.g. everyone)
hashtags
Hashtags used in the post
mentions
Usernames mentioned in the post
carousel_media
Array of slides for carousel posts (media_id, is_video, image_url, video_url, width, height); empty otherwise
link_preview
Link preview object for posts sharing a URL (url, display_url, title, description, image_url, favicon_url), or null
quoted_post
The embedded quoted/reposted post (same post shape), or null
post_id
Threads post ID
code
Post shortcode (used in the post URL)
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
pages
Number of pages returned
count
Total results returned

Example Request

curl "https://apidirect.io/v1/threads/posts?query=technology&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "posts": [
    {
      "title": "@technologybrief on Threads",
      "url": "https://www.threads.com/@technologybrief/post/DaqCqtWHdiU",
      "date": "2026-07-08 14:22:31",
      "author": "technologybrief",
      "source": "Threads",
      "domain": "threads.com",
      "snippet": "Most people don't realize how many tech giants are already deep in bear-market territory.",
      "likes": 1284,
      "replies": 96,
      "reposts": 41,
      "quotes": 12,
      "reshares": 23,
      "author_name": "Technology Brief",
      "author_verified": true,
      "is_reply": false,
      "media_type": "image",
      "image_url": "https://scontent.cdninstagram.com/v/t51.82787-15/photo.jpg",
      "video_url": "",
      "width": 1080,
      "height": 1350,
      "has_audio": false,
      "reply_control": "everyone",
      "hashtags": [],
      "mentions": [],
      "carousel_media": [],
      "link_preview": null,
      "quoted_post": null,
      "post_id": "3938972555089402004",
      "code": "DaqCqtWHdiU",
      "sentiment": {
        "emotions": {"joy": 20, "trust": 30, "fear": 45, "surprise": 10, "sadness": 25, "disgust": 5, "anger": 15, "anticipation": 35},
        "dominant_emotion": "fear",
        "emotional_intensity": 6,
        "polarity": "negative"
      }
    }
  ],
  "pages": 2,
  "count": 30
}

Frequently asked questions

How fresh is the Threads data?

Results are sourced in real time from public posts on Threads, so you get posts from years ago up to the last few seconds.

What engagement metrics are included?

Each post includes likes, replies, reposts, quotes, and reshares, plus author metadata like display name and verification status. Threads doesn't expose public view counts, so there is no views field.

Does search include replies?

Yes. Results can include both original posts and replies. Use the is_reply field to tell them apart.

How many posts are returned per page?

The first page returns about 20 of the most relevant matches and each later page about 10 more. Use the pages parameter (1-200) to fetch more in a single call; you are billed per page returned.

How does pricing work?

You only pay for successful requests. The Threads Posts API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the Threads Posts API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key