Threads Post API: Post or reply with exact likes and reposts

Returns a public Threads post or reply from its link, share link, shortcode or numeric ID, with exact like, reply, repost, quote and share counts. It also has the text with mentions and hashtags, the exact publish time, the author, every photo, video, carousel item or GIF, the link card, the topic tag, and the post it quotes or the account it replies to.

GET /v1/threads/post

Read the API reference

1 credit per request, $0.75–$1.97 per 1,000 requests
22 typed fields null when unknown
url is all it needs, e.g. https://www.threads.com/@zuck/post/DeZtp-TkQHh
100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get 22 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

url = https://www.threads.com/@zuck/post/DeZtp-TkQHh

Open in playground

GET /v1/threads/postTry in

const params = new URLSearchParams({
  url: "https://www.threads.com/@zuck/post/DeZtp-TkQHh",
});
const res = await fetch(`https://socialtap.dev/v1/threads/post?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/threads/post",
    params={"url": "https://www.threads.com/@zuck/post/DeZtp-TkQHh"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/threads/post")
uri.query = URI.encode_www_form('url' => 'https://www.threads.com/@zuck/post/DeZtp-TkQHh')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'url' => 'https://www.threads.com/@zuck/post/DeZtp-TkQHh',
]);
$ch = curl_init('https://socialtap.dev/v1/threads/post?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://www.threads.com/@zuck/post/DeZtp-TkQHh")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/threads/post?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl -G 'https://socialtap.dev/v1/threads/post' \
  --data-urlencode 'url=https://www.threads.com/@zuck/post/DeZtp-TkQHh' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": {
    "approximate_fields": [],
    "author": {
      "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid=S…",
      "display_name": "Mark Zuckerberg",
      "id": "63055343223",
      "is_verified": true,
      "url": "https://www.threads.com/@zuck",
      "username": "zuck"
    },
    "coauthors": [],
    "duration_ms": null,
    "hashtags": [],
    "id": "DeZtp-TkQHh",
    "is_nsfw": null,
    "is_pinned": false,
    "is_sponsored": null,
    "language": "en",
    "media": [
      {
        "alt_text": null,
        "duration_ms": null,
        "expires_at": "2026-10-25T18:00:00Z",
        "height": 3260,
        "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?_nc_cat=109&ig_cache_key=NDAwNjQzNDE0MDAxNDU3NjA5Nw%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-…",
        "type": "image",
        "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?_nc_cat=109&ig_cache_key=NDAwNjQzNDE0MDAxNDU3NjA5Nw%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-…",
        "width": 2160
      }
    ],
    "mentions": [],
    "metrics": {
      "comment_count": 649,
      "like_count": 2194,
      "quote_count": 62,
      "repost_count": 176,
      "save_count": null,
      "share_count": 150,
      "view_count": null
    },
    "platform": "threads",
    "platform_specific": {
      "threads": {
        "is_edited": false,
        "is_reply": false,
        "is_spoiler": false,
        "link": null,
        "numeric_id": "4006434140014576097",
        "quoted_post": null,
        "reply_control": "everyone",
        "reply_to_author": null,
        "topic_tag": null
      }
    },
    "platform_type": "thread",
    "published_at": "2026-10-12T16:56:29Z",
    "text": "Introducing Muse Wonder, our new family of frontier models with state of the art performance for personal and professional agentic work.",
    "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?_nc_cat=109&ig_cache_key=NDAwNjQzNDE0MDAxNDU3NjA5Nw%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-…",
    "title": null,
    "type": "image",
    "unknown_fields": [],
    "url": "https://www.threads.com/@zuck/post/DeZtp-TkQHh"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "threads",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 268,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "post",
      "id": "DeZtp-TkQHh",
      "url": "https://www.threads.com/@zuck/post/DeZtp-TkQHh"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.threads.post.get({ url: "https://www.threads.com/@zuck/post/DeZtp-TkQHh" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "url=" + encode("https://www.threads.com/@zuck/post/DeZtp-TkQHh");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/threads/post?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "url=" + Uri.EscapeDataString("https://www.threads.com/@zuck/post/DeZtp-TkQHh"));
var res = await http.GetAsync("https://socialtap.dev/v1/threads/post?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/threads/post")
        .query(&[("url", "https://www.threads.com/@zuck/post/DeZtp-TkQHh")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/threads/postLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Threads doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
Threads post URL (threads.com or threads.net: /@user/post/<code>, its /media or other views, or the /t/<code> share link), a post's 11-character shortcode, or its numeric ID.
Write one parser
Threads, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Threads Post API.

Track a post's likes and reposts over time
Turn shared post links into text and media
Archive a brand's or creator's posts
Trace quotes and replies to their source

Good to know before you build.

metrics.comment_count counts direct replies, as the post's reply icon does. repost_count and quote_count are separate, though Threads' repost icon shows their sum.
metrics.view_count is usually null: only Threads' post page shows views, and it is read only when the faster post query fails.
metrics.share_count is null when Threads sends no share count, as on most replies to other accounts' posts.
Likes and views an author hides are null.
platform_type is thread or reply. platform_specific.threads.numeric_id is the numeric ID other tools use.

1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful request	Per 1,000 requests
Platform API `api`	1 credit	$0.75–$1.97
Public page `page`	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Threads Post API.

Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Threads Post API. Send a post link or ID.

Threads Post API at a glance

Send one request. Get 22 fields back.

One schema on 21 platforms.

Null means unknown

What it accepts

Write one parser

What teams build with the Threads Post API.

Track a post's likes and reposts over time

Turn shared post links into text and media

Archive a brand's or creator's posts

Trace quotes and replies to their source

Good to know before you build.

1 credit per request. Failed requests are free.

Questions about the Threads Post API.

Posts on 20 more platforms.

Threads API. 6 endpoints, one key.

Try it on a link you already have.