CaptapiCaptapi
Threads · Guide

How to get Threads post details

TL;DR
To get Threads post details, sign up for a free Captapi key, then send one GET request to /v1/threads/post-details with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Get a Threads post — text, author, likes, replies, and media as structured JSON.
Get your free API keyAPI reference

How to get Threads post details (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Threads Post Details API

    Send an authenticated GET request to /v1/threads/post-details with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/threads/post-details?url=https%3A%2F%2Fwww.threads.net%2F%40zuck%2Fpost%2FDZ7eGA1G7wU" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "threads",
    "id": "3925863854786722836",
    "code": "DZ7eGA1G7wU",
    "url": "https://www.threads.net/@zuck/post/DZ7eGA1G7wU",
    "text": "Our new line of @metaglasses is available today. Three shapes, 26 style combos, with our most advanced Meta AI built in. Plus, three custom styles designed by @kyliejenner.",
    "publishedAt": "2026-06-23T12:57:42.000Z",
    "author": {
      "username": "zuck",
      "displayName": "Mark Zuckerberg",
      "verified": true,
      "profileImage": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/550174606_17925811725103224_8363667901743352243_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gGRvRGRlBJzSaDiIHvy96S-H7IXH2wFzXSpG21h5j2h0Naq9IW3HS8dzgEC2DJZVZk&_nc_ohc=vLH8jAZMCqoQ7kNvwGzk09c&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQC2Ehx5DCkim-2Ypr-U5Cpo18JJL1Cg378dtzsIxna3SQ&oe=6A6E2ABE&_nc_sid=10d13b"
    },
    "engagement": {
      "likes": 3620,
      "replies": 1403,
      "reposts": 237,
      "quotes": 117
    },
    "media": [
      "https://scontent-iad3-2.cdninstagram.com/v/t51.71878-15/729466804_1549760159886177_1883659439515397370_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&ig_cache_key=MzkyNTg1NzYxNDQ3NTQyMzA5NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=stcmUcGgS9kQ7kNvwE2_SBs&_nc_oc=Adr6V5qDP4eW5RXqD5GFL13d3gwBJeSM0416O70OlzPNG6x72NO4f9DGAq1cmNY2Tfk&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_ss=7a22e&oh=00_AQCrin3Lx7BW1fworyktsrvpPjkzSxnefooIqQaiXIvshQ&oe=6A6E4876",
      "https://scontent-iad6-1.cdninstagram.com/o1/v/t16/f2/m84/AQOTRrCQTl1fyJz7fqBninvUdgWeil7BncTOhD-RfiP256I4PY_ioi8UAxdGl0WLEByzkS3XiObR8E2yNiSbmnE634ktoS1hPNebBYI.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_ohc=CYAcI0UX3ncQ7kNvwEzQCPv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0FST1VTRUxfSVRFTS5DMy43MjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjoxNzk2ODE3MTU3ODA4OTg4OCwiYXNzZXRfYWdlX2RheXMiOjMzLCJ2aV91c2VjYXNlX2lkIjoxMDE2NCwiZHVyYXRpb25fcyI6MjQsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=cefa3ff17e61a968&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC81NDQyODFEMkZCRDg0MzU4MzZBQUE0QzI5MzE4MzlBRF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzYwNEVGNDk2M0EwQzdFNTY4QTIyNDRDRkI4MDZBMkIwX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbAhufCnv3qPxUCKAJDMywXQDgF41P3ztkYEmRhc2hfYmFzZWxpbmVfMV92MREAde4HZeieAQA&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_zt=28&_nc_ss=7a22e&oh=00_AQCM2jLds0l7xzFxMerH9RPcZIf6qElGCgvI5V1DJS_ekg&oe=6A6A37B5",
      "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-15/728809712_17974875099103224_2528686373104860184_n.webp?_nc_cat=103&ig_cache_key=MzkyNTg1NzU3NTcwNjYwODc2NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=wgnGXUO07qoQ7kNvwFM_jto&_nc_oc=AdrxVBIXp0YmbH6aYcplbYztDeHesnqMNbGHQQdWmHeS1y7LKIltn5xPwHJCjxCyb38&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_ss=7a22e&oh=00_AQDnoCp2GOZD_qhZc4iins8M5f8WO-fA4H2nkIVk1Ii7Uw&oe=6A6E1950",
      "https://scontent-iad6-1.cdninstagram.com/v/t51.71878-15/727566051_958314003924963_5283054625475303262_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&ig_cache_key=MzkyNTg1NzkxNjQyMzMxMzMwMA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=cjpOMQKC2RcQ7kNvwFqnfBA&_nc_oc=AdrtwIel1SSUzrnCttz96Tp3mS0HW8ZVGquCBE_Ymx38XsNAzWbH4yk0rdeXdVTa6Tw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_ss=7a22e&oh=00_AQDcYso9P08PwHT3zbdk7Xj6Uc-IX699-JBCbBySGU0cNg&oe=6A6E460D",
      "https://scontent-iad3-1.cdninstagram.com/o1/v/t16/f2/m84/AQMq6Zzrg22F9r5ID02lab-TQjcYUfKnqpC2_w06THGl8MZ-tKE8-YxokKyN1Yjw_Nwgwpv-xkP4ApHqJoOKrA3b9z01kZ1S4Kgf9ts.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_ohc=dXo8gsZ3y98Q7kNvwGb-m2V&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0FST1VTRUxfSVRFTS5DMy43MjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjoxNzk3NDg3NTE5ODEwMzIyNCwiYXNzZXRfYWdlX2RheXMiOjM0LCJ2aV91c2VjYXNlX2lkIjoxMDE2NCwiZHVyYXRpb25fcyI6MjgsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=727caf249a0595d&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC8zMTQ2RkM2Q0JBNkVFMzhBMDIwQzk0MkZEQzRGMEE4NV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzQzNEQwMTM2OTM3NzEyNTk0MkEwNDFERTgyODAyNzg0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbw-oSxuIPuPxUCKAJDMywXQDwPnbItDlYYEmRhc2hfYmFzZWxpbmVfMV92MREAde4HZeieAQA&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_ss=7a22e&_nc_zt=28&oh=00_AQCHiuPM-XsixzgMMMl1zdLIyWuBmMZFQahpOuLsDme8-w&oe=6A6A43B3",
      "https://scontent-iad3-2.cdninstagram.com/v/t51.71878-15/729466804_1549760159886177_1883659439515397370_n.jpg?stp=c0.80.640.640a_dst-jpg_e15_s640x640_tt6&_nc_cat=105&ig_cache_key=MzkyNTg1NzYxNDQ3NTQyMzA5NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=stcmUcGgS9kQ7kNvwE2_SBs&_nc_oc=Adr6V5qDP4eW5RXqD5GFL13d3gwBJeSM0416O70OlzPNG6x72NO4f9DGAq1cmNY2Tfk&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_gid=SKYrfm-D56HlSCQ63fyNqg&_nc_ss=7a22e&oh=00_AQDSeO9Kx3ytZVzlTkIMSFZLxnEbsSOcGJR0Wy7FHdzLsw&oe=6A6E4876"
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesThreads post URL, e.g. https://threads.net/@user/post/CODE. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the Threads Post Details API do?

The Threads Post Details API lets you fetch full metadata and key stats from a public Threads post using one GET request to /v1/threads/post-details. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Threads Post Details API cost?

Each successful call costs 1 credit. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a Threads API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Threads Post Details API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to get Threads post details?

Start free with 100 credits — no credit card required.

Get your free API key