API Direct

Threads Posts

GET /v1/threads/posts

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.

Cost

$0.006 per request

Free tier

50 requests/month

Parameters

query *

Search keyword (max 500 characters)

get_sentiment

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

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
}

Your Usage

Free tier this month

Recent Activity