UnifAPI Docs

Get a Threads post by URL

Returns one Threads post by URL with its author, media, counts, the rest of its thread, replies and related posts. Returns `not_found` when the post does not exist.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/threads/posts

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

url*string

Link to the Threads post.

Length1 <= length <= 4096

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/threads/posts?url=string"
{  "request_id": "string",  "data": {    "id": "string",    "shortcode": "string",    "url": "string",    "caption": "string",    "created_at": 0,    "is_reply": true,    "reply_control": "string",    "unavailable_reason": "string",    "author": {      "platform": "string",      "platform_user_id": "string",      "username": "string",      "display_name": "string",      "avatar_url": "string",      "is_verified": true,      "is_private": true    },    "like_count": 0,    "view_count": 0,    "reply_count": 0,    "repost_count": 0,    "quote_count": 0,    "reshare_count": 0,    "media": {      "media_type": "string",      "images": [        {          "url": "string",          "width": 0,          "height": 0        }      ],      "videos": [        {          "url": "string",          "width": 0,          "height": 0        }      ],      "dimensions": {        "width": 0,        "height": 0      },      "accessibility_caption": "string"    },    "thread_items": [      {        "id": "string",        "shortcode": "string",        "url": "string",        "caption": "string",        "created_at": 0,        "author": {          "platform": "string",          "platform_user_id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        },        "like_count": 0,        "view_count": 0,        "reply_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0,        "media": {          "media_type": "string",          "images": [            {              "url": "string",              "width": 0,              "height": 0            }          ],          "videos": [            {              "url": "string",              "width": 0,              "height": 0            }          ],          "dimensions": {            "width": 0,            "height": 0          },          "accessibility_caption": "string"        }      }    ],    "replies": [      {        "id": "string",        "shortcode": "string",        "url": "string",        "caption": "string",        "created_at": 0,        "author": {          "platform": "string",          "platform_user_id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        },        "like_count": 0,        "view_count": 0,        "reply_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0      }    ],    "related_posts": [      {        "id": "string",        "shortcode": "string",        "url": "string",        "caption": "string",        "created_at": 0,        "author": {          "platform": "string",          "platform_user_id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        },        "like_count": 0,        "view_count": 0,        "reply_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}