InsightSocial API
Threads

Threads Post API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDZpPDXbCeTt" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/threads/post

Returns one Threads post's text, like, reply and repost counts, every carousel slide or video URL, author, creation time, and topic tag at post.ext.topic_tag.

Use it when you have a post URL and want that single post rather than a whole feed. If it is a quote post, the quoted post arrives at post.ext.quoted_post.

10 credits per call.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the Threads post, for example https://www.threads.com/@zuck/post/DZpPDXbCeTt. Both threads.com and threads.net are accepted.

trim?boolean

Ask for a stripped record. This is a real shape change, not just less whitespace: a trimmed row carries only the id, text, shortcode, like count, timestamp and author, so media, reply count, share count, view count, topic tag, pinned flag and quoted post all come back null.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/threads/post?url=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "post": {      "id": "string",      "url": "http://example.com",      "kind": "string",      "content": {        "text": "string",        "media_urls": [          "http://example.com"        ],        "thumbnail_url": "http://example.com",        "duration_seconds": 0      },      "author": {        "id": "string",        "username": "string",        "display_name": "string",        "avatar_url": "http://example.com",        "verified": true      },      "engagement": {        "views": 0,        "likes": 0,        "comments": 0,        "shares": 0,        "saves": 0      },      "flags": {        "nsfw": true,        "spoiler": true,        "pinned": true,        "deleted": true,        "likes_hidden": true,        "comments_hidden": true,        "shares_hidden": true,        "views_hidden": true,        "saves_hidden": true      },      "published_at": "2019-08-24T14:15:22Z",      "language": "string",      "ext": {        "property1": null,        "property2": null      }    }  }}

Post › Comments GET

Returns the replies Threads bundles with a post, usually about 20. Send limit above 25 (up to 50) to collect more first-level replies from a second source.

Profile GET

Returns a Threads account's public profile: bio, the external link set in that bio, follower count, profile picture URL, and verification status.