Threads Posts API

Endpoint

GET /v1/threads/posts

Parameters

query *

Search keyword (max 500 characters)

get_sentiment

Set to true to add AI emotion analysis (+$0.001/request)

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)

count

Total results returned

Example Request

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

import requests

response = requests.get(
    "https://apidirect.io/v1/threads/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "technology"}
)
print(response.json())

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"
      }
    }
  ],
  "count": 25
}

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?

Each request returns a single page of the most relevant matches (typically up to 25 posts). There are no pagination parameters — one request is one lookup.

How does pricing work?

You only pay for successful requests. The Threads Posts API costs $0.006 per request. 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 5 simultaneous requests per endpoint per user. If you need more, just get in touch.