const response = await fetch("https://socialholmes.com/api/public/v1/scrape/tiktok/trending", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { region: "US" }, limit: 25 }),
})

const run = await response.json()
console.log(run.id, run.status)

require "net/http"
require "json"

response = Net::HTTP.post(
  URI("https://socialholmes.com/api/public/v1/scrape/tiktok/trending"),
  { parameters: { region: "US" }, limit: 25 }.to_json,
  "Authorization" => "Bearer #{ENV.fetch('SOCIALHOLMES_KEY')}",
  "Content-Type" => "application/json"
)

run = JSON.parse(response.body)
puts run["id"], run["status"]

<?php

$ch = curl_init("https://socialholmes.com/api/public/v1/scrape/tiktok/trending");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SOCIALHOLMES_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["parameters" => ["region" => "US"], "limit" => 25]),
]);

$run = json_decode(curl_exec($ch), true);

echo $run["id"], " ", $run["status"];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"parameters": map[string]string{"region": "US"},
		"limit":      25,
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/tiktok/trending", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SOCIALHOLMES_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var run map[string]any
	json.NewDecoder(res.Body).Decode(&run)

	fmt.Println(run["id"], run["status"])
}

202 Accepted

{
  "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
  "status": "queued",
  "platform": "tiktok",
  "endpoint": "trending",
  "target": "US",
  "url": "https://www.tiktok.com/foryou?region=US",
  "result_count": 0,
  "created_at": "2026-08-28T16:22:25Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "tiktok",
    "endpoint": "trending",
    "target": "US",
    "url": "https://www.tiktok.com/foryou?region=US",
    "result_count": 2,
    "requested": 25,
    "estimated_cost": 125,
    "captures": 1,
    "created_at": "2026-08-22T09:11:03Z",
    "started_at": "2026-08-22T09:12:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "video",
  "results": [
    {
      "id": "7212345678901234567",
      "url": "https://www.tiktok.com/@spacex/video/7212345678901234567",
      "type": "video",
      "caption": "Starship static fire — full duration #starship #spacex",
      "taken_at": "2026-08-22T09:12:44Z",
      "duration": 27,
      "region": "US",
      "play_count": 4820113,
      "like_count": 612940,
      "comment_count": 8104,
      "share_count": 21877,
      "save_count": 44210,
      "download_count": 3312,
      "cover_url": "https://tiktok.example/img/7212345678901234567_cover.jpeg",
      "media_urls": [
        "https://tiktok.example/video/7212345678901234567.mp4"
      ],
      "hashtags": [
        "starship",
        "spacex"
      ],
      "music": {
        "id": "7100000000000000000",
        "title": "Original sound",
        "artist": "spacex",
        "url": "https://www.tiktok.com/music/x-7100000000000000000",
        "audio_url": "https://tiktok.example/music/7100000000000000000.mp3",
        "duration": 27,
        "is_original": true
      },
      "is_pinned": true,
      "is_ad": false,
      "author": {
        "id": "6614519312189947909",
        "username": "spacex",
        "full_name": "SpaceX",
        "is_verified": true,
        "profile_pic_url": "https://tiktok.example/img/spacex_1080.jpeg"
      }
    },
    {
      "id": "7212000000000000001",
      "url": "https://www.tiktok.com/@spacex/video/7212000000000000001",
      "type": "video",
      "caption": "Booster catch, slowed down 8x",
      "taken_at": "2026-08-21T09:12:44Z",
      "duration": 41,
      "region": "US",
      "play_count": 9114002,
      "like_count": 1204881,
      "comment_count": 19340,
      "share_count": 88120,
      "save_count": 130044,
      "cover_url": "https://tiktok.example/img/7212000000000000001_cover.jpeg",
      "media_urls": [
        "https://tiktok.example/video/7212000000000000001.mp4"
      ],
      "is_pinned": false,
      "is_ad": false,
      "author": {
        "id": "6614519312189947909",
        "username": "spacex",
        "full_name": "SpaceX",
        "is_verified": true,
        "profile_pic_url": "https://tiktok.example/img/spacex_1080.jpeg"
      }
    }
  ],
  "page": {
    "limit": 2,
    "offset": 0,
    "returned": 2,
    "total": 2
  }
}

Try it

Trending

Parameters#

Results#