Truth Social Post API. Send a post link or ID.

const params = new URLSearchParams({
  url: "https://truthsocial.com/@realDonaldTrump/117554198887656582",
});
const res = await fetch(`https://socialtap.dev/v1/truthsocial/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/truthsocial/post",
    params={"url": "https://truthsocial.com/@realDonaldTrump/117554198887656582"},
    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/truthsocial/post")
uri.query = URI.encode_www_form('url' => 'https://truthsocial.com/@realDonaldTrump/117554198887656582')
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://truthsocial.com/@realDonaldTrump/117554198887656582',
]);
$ch = curl_init('https://socialtap.dev/v1/truthsocial/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://truthsocial.com/@realDonaldTrump/117554198887656582")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/truthsocial/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/truthsocial/post' \
  --data-urlencode 'url=https://truthsocial.com/@realDonaldTrump/117554198887656582' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": {
    "approximate_fields": [],
    "author": {
      "avatar_url": "https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg",
      "display_name": "Donald J. Trump",
      "id": "107780257626128497",
      "is_verified": true,
      "url": "https://truthsocial.com/@realDonaldTrump",
      "username": "realDonaldTrump"
    },
    "coauthors": [],
    "duration_ms": null,
    "hashtags": [],
    "id": "117554198887656582",
    "is_nsfw": false,
    "is_pinned": null,
    "is_sponsored": false,
    "language": "en",
    "media": [],
    "mentions": [],
    "metrics": {
      "comment_count": 767,
      "like_count": 7300,
      "quote_count": null,
      "repost_count": 2068,
      "save_count": null,
      "share_count": null,
      "view_count": null
    },
    "platform": "truthsocial",
    "platform_specific": {
      "truthsocial": {
        "downvote_count": null,
        "edited_at": null,
        "group": null,
        "link": null,
        "poll": null,
        "quoted_post": null,
        "reblog_of": null,
        "reply_to": null
      }
    },
    "platform_type": "truth",
    "published_at": "2026-11-03T19:38:44Z",
    "text": "The Jewish community in Monsey, New York, and its surrounding neighborhoods, voted in very big numbers for me in our Historic 2024 Presidential Campaign. TREMENDOUS SUPPORT!\n\nTODAY, the eyes of the Country are on New York again!\n\nCongressman Mike Lawler has been a tremendous frie…",
    "thumbnail_url": null,
    "title": null,
    "type": "text",
    "unknown_fields": [],
    "url": "https://truthsocial.com/@realDonaldTrump/117554198887656582"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "truthsocial",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 168,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "post",
      "id": "117554198887656582",
      "url": "https://truthsocial.com/@realDonaldTrump/117554198887656582"
    },
    "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.truthsocial.post.get({ url: "https://truthsocial.com/@realDonaldTrump/117554198887656582" });
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://truthsocial.com/@realDonaldTrump/117554198887656582");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/truthsocial/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://truthsocial.com/@realDonaldTrump/117554198887656582"));
var res = await http.GetAsync("https://socialtap.dev/v1/truthsocial/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/truthsocial/post")
        .query(&[("url", "https://truthsocial.com/@realDonaldTrump/117554198887656582")])
        .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(())
}