curl --request POST \
  --url https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "hashtag": "booktok",
  "cursor": "0"
}
'

import requests

url = "https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts"

payload = {
    "hashtag": "booktok",
    "cursor": "0"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({hashtag: 'booktok', cursor: '0'})
};

fetch('https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'hashtag' => 'booktok',
    'cursor' => '0'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts"

	payload := strings.NewReader("{\n  \"hashtag\": \"booktok\",\n  \"cursor\": \"0\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"hashtag\": \"booktok\",\n  \"cursor\": \"0\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sideshift.app/api/v1/scrape/tiktok/hashtag-posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"hashtag\": \"booktok\",\n  \"cursor\": \"0\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "cursor": "20",
    "hashtag_id": "1622962893630470",
    "has_more": true,
    "aweme_list": [
      {
        "aweme_id": "7598729935385070879",
        "desc": "10 popular booktok books 💯 worth the hype! #BookTok #BookRecommendations #WorthTheHype #PopularBooks #ReaderTok",
        "url": "https://www.tiktok.com/@ericalaniz/video/7598729935385070879",
        "create_time": 1769217200,
        "music": {
          "author": "Ernesto P. Neto",
          "id": "7401225789633841153",
          "title": "Fantasy in an Immersive World",
          "album": "Dreams of a Magical Night",
          "id_str": "7401225789633841153",
          "mid": "7401225789633841153",
          "owner_nickname": "Ernesto P. Neto",
          "duration": 242,
          "is_original": false,
          "is_original_sound": false,
          "cover_large": {
            "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg",
            "url_list": [
              "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg"
            ]
          },
          "cover_medium": {
            "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg",
            "url_list": [
              "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg"
            ]
          },
          "cover_thumb": {
            "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg",
            "url_list": [
              "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-v-2774/o0MzfCpOyQAsUEImG3FfBBgkRLiA8uIJZADwt7~tplv-tiktokx-cropcenter:720:720.jpeg"
            ]
          },
          "play_url": {
            "uri": "https://sf16-sign.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oAa2LHeIeImMAxqgqFLaKbeGAgA0OGL8eb21rF",
            "url_list": [
              "https://sf16-sign.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oAa2LHeIeImMAxqgqFLaKbeGAgA0OGL8eb21rF"
            ]
          }
        },
        "video": {
          "data_size": 26672319,
          "duration": 160,
          "watermark_data_size": 25030047,
          "cover": {
            "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068c799-us/owBG0KP3BkKg0iYC849AAfqHiuIiHECAI7lU7S~tplv-tiktokx-origin.image",
            "url_list": [
              "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068c799-us/owBG0KP3BkKg0iYC849AAfqHiuIiHECAI7lU7S~tplv-tiktokx-origin.image"
            ]
          },
          "download_addr": {
            "uri": "https://v16m.tiktokcdn-us.com/08342642e9d2c472b931844954f3b1f8/6a77e439/video/tos/useast8/tos-useast8-pve-0068-tx2/o0Xik30CQdIKifGCigAtcIEB0AOqu37AHwPWH9/",
            "url_list": [
              "https://v16m.tiktokcdn-us.com/08342642e9d2c472b931844954f3b1f8/6a77e439/video/tos/useast8/tos-useast8-pve-0068-tx2/o0Xik30CQdIKifGCigAtcIEB0AOqu37AHwPWH9/"
            ]
          },
          "dynamic_cover": {
            "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/og0ux9KHIRgHA7GCIfg0FiAhBIiPkqPCsAkB3i~tplv-tiktokx-origin.image",
            "url_list": [
              "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/og0ux9KHIRgHA7GCIfg0FiAhBIiPkqPCsAkB3i~tplv-tiktokx-origin.image"
            ]
          },
          "origin_cover": {
            "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o49JHBiMDQNPO06vA2FCVNR8UBfipeEQEMAFEd~tplv-tiktokx-shrink-aq:360:360:q75.webp",
            "url_list": [
              "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o49JHBiMDQNPO06vA2FCVNR8UBfipeEQEMAFEd~tplv-tiktokx-shrink-aq:360:360:q75.webp"
            ]
          },
          "play_addr": {
            "uri": "https://v16m.tiktokcdn-us.com/5cef8e398b0edf755987784171e57521/6a77e439/video/tos/useast8/tos-useast8-pve-0068-tx2/oYqBHZvbi9HQETiA05KAkHgPG39IAfCu0IiFC7/",
            "url_list": [
              "https://v16m.tiktokcdn-us.com/5cef8e398b0edf755987784171e57521/6a77e439/video/tos/useast8/tos-useast8-pve-0068-tx2/oYqBHZvbi9HQETiA05KAkHgPG39IAfCu0IiFC7/"
            ]
          }
        },
        "author": {
          "nickname": "Air_Wik_Reads 📚📸",
          "unique_id": "ericalaniz",
          "region": "US",
          "uid": "6545931668870403087",
          "avatar_larger": {
            "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg",
            "url_list": [
              "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg"
            ]
          },
          "avatar_medium": {
            "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg",
            "url_list": [
              "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg"
            ]
          },
          "avatar_thumb": {
            "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg",
            "url_list": [
              "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/bd66dd912e6273292ff7c45460164f3c~tplv-tiktokx-cropcenter:300:300.jpeg"
            ]
          }
        },
        "statistics": {
          "aweme_id": "7598729935385070879",
          "collect_count": 1033,
          "comment_count": 179,
          "play_count": 92786,
          "share_count": 177,
          "digg_count": 2886,
          "download_count": 23
        },
        "author_user_id": "6545931668870403087",
        "create_time_utc": "2026-01-24T01:13:20.000Z",
        "media_id": "v15044gf0000d5q1nv7og65t30kjma3g",
        "region": "US",
        "aweme_type": 0,
        "is_ad": false,
        "is_nff_or_nr": false,
        "is_top": 0,
        "item_comment_settings": 0,
        "anchors": [
          {
            "id": "1907991905",
            "component_key": "anchor_filter",
            "description": "Filter",
            "extra": "{\"title\":\"Orange Blue\",\"resource_id\":7358622190259933713,\"third_id\":\"1907991905\"}",
            "keyword": "Filter · Orange Blue",
            "log_extra": "{\"anchor_id\":\"7525394380245452830\",\"anchor_name\":\"Orange Blue\",\"anchor_type\":\"ANCHOR_TT_FILTER\"}",
            "general_type": 1,
            "type": 106,
            "actions": [
              {
                "schema": "aweme://openShoot",
                "action_type": 2,
                "icon": {
                  "uri": "https://p16-common.tiktokcdn-us.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image",
                  "height": 720,
                  "width": 720,
                  "url_list": [
                    "https://p16-common.tiktokcdn-us.com/tiktok-obj/28px_primary_create_onDark3x.png~tplv-tiktokx-origin.image"
                  ]
                }
              }
            ],
            "icon": {
              "uri": "tiktok-obj/Filter.png",
              "height": 720,
              "width": 720,
              "url_list": [
                "https://p16-common.tiktokcdn-us.com/tiktok-obj/Filter.png~tplv-tiktokx-origin.image",
                "https://p19-common.tiktokcdn-us.com/tiktok-obj/Filter.png~tplv-tiktokx-origin.image",
                "https://p16-common.tiktokcdn-us.com/tiktok-obj/Filter.png~tplv-tiktokx-origin.jpeg"
              ]
            },
            "thumbnail": {
              "uri": "https://lf16-effectcdn-us.tiktokcdn-us.com/obj/tiktok-loki-effect-oracle-tx/6a2b7682e114b36472e7b86d3143078c",
              "height": 64,
              "width": 64,
              "url_list": [
                "https://lf16-effectcdn-us.tiktokcdn-us.com/obj/tiktok-loki-effect-oracle-tx/6a2b7682e114b36472e7b86d3143078c"
              ]
            }
          }
        ],
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "with_comment_filter_words": false
        }
      }
    ],
    "hashtag": {
      "cover_url": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/ffd11355ceddd5cb7a3f7f4a1f059df0.png~tplv-tiktokx-origin.image",
      "description": "Calling all book lovers, join the #BookTok Post Contest from April 13th to May 11th for a chance to win $3000! Click here to join: https://vt.tiktok.com/ZSHgdjSGp/",
      "hashtag_id": "1622962893630470",
      "hashtag_link": "https://www.tiktok.com/tag/BookTok",
      "name": "BookTok",
      "is_challenge": false,
      "is_commerce": false,
      "is_pgc_show": false,
      "is_strong_music": false,
      "post_count": 83398629,
      "type": 2,
      "view_count": 540913526475
    }
  },
  "request_id": "req_8f3c9a2b1d4e6f70",
  "upstream_calls": 1,
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 9998
  }
}

{
  "error": "INVALID_INPUT",
  "message": "Invalid request body.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "UNAUTHORIZED",
  "message": "Invalid scraper API key.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "INSUFFICIENT_SCRAPER_CREDITS",
  "message": "Insufficient scraper credits.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "Requested resource not found or unavailable.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "PAYLOAD_TOO_LARGE",
  "message": "Request body must be 32KB or smaller.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "SCRAPER_RATE_LIMITED",
  "message": "Scraper API rate limit exceeded.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "INTERNAL_ERROR",
  "message": "Request failed. Your credits were refunded.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "UPSTREAM_ERROR",
  "message": "Data source failed. Your credits were refunded.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}

{
  "error": "UPSTREAM_TIMEOUT",
  "message": "Data source timed out. Your credits were refunded.",
  "request_id": "req_8f3c9a2b1d4e6f70"
}