TikTok — transcript

curl --request POST \
  --url https://app.sideshift.app/api/v1/scrape/tiktok/transcript \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138"
}
'

import requests

url = "https://app.sideshift.app/api/v1/scrape/tiktok/transcript"

payload = { "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138" }
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://www.tiktok.com/@henripalms/video/7631128625017851138'})
};

fetch('https://app.sideshift.app/api/v1/scrape/tiktok/transcript', 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/transcript",
  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([
    'url' => 'https://www.tiktok.com/@henripalms/video/7631128625017851138'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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/transcript"

	payload := strings.NewReader("{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}")

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

	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/transcript")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}"

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

{
  "data": {
    "id": "7631128625017851138",
    "language": "eng-US",
    "transcript": "Next time you're in Tesco wondering if you should buy that chocolate bar, buy it. Because you could always be in an airport where a bar of chocolate cost £20",
    "transcript_vtt": "WEBVTT\n\n\n00:00:00.180 --> 00:00:03.020\nNext time you're in Tesco wondering if you should buy that chocolate bar,\n\n00:00:03.021 --> 00:00:03.660\nbuy it.\n\n00:00:03.661 --> 00:00:08.520\nBecause you could always be in an airport where a bar of chocolate cost £20\n",
    "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138",
    "available_tracks": [
      {
        "url": "https://v16m-webapp.tiktokcdn-us.com/88ffad13a8398c73e149a82a1f44ad48/6a7a3247/video/tos/useast5/tos-useast5-v-0068c799-tx/102fcb7a5c304113be6f2f3a66041a78/",
        "format": "webvtt",
        "kind": "manual",
        "language_code": "eng-US",
        "language_name": "eng-US",
        "is_auto_generated": false
      }
    ],
    "is_auto_generated": false
  },
  "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"
}

POST

scrape

tiktok

transcript

TikTok — transcript

curl --request POST \
  --url https://app.sideshift.app/api/v1/scrape/tiktok/transcript \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138"
}
'

import requests

url = "https://app.sideshift.app/api/v1/scrape/tiktok/transcript"

payload = { "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138" }
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://www.tiktok.com/@henripalms/video/7631128625017851138'})
};

fetch('https://app.sideshift.app/api/v1/scrape/tiktok/transcript', 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/transcript",
  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([
    'url' => 'https://www.tiktok.com/@henripalms/video/7631128625017851138'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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/transcript"

	payload := strings.NewReader("{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}")

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

	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/transcript")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://www.tiktok.com/@henripalms/video/7631128625017851138\"\n}"

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

{
  "data": {
    "id": "7631128625017851138",
    "language": "eng-US",
    "transcript": "Next time you're in Tesco wondering if you should buy that chocolate bar, buy it. Because you could always be in an airport where a bar of chocolate cost £20",
    "transcript_vtt": "WEBVTT\n\n\n00:00:00.180 --> 00:00:03.020\nNext time you're in Tesco wondering if you should buy that chocolate bar,\n\n00:00:03.021 --> 00:00:03.660\nbuy it.\n\n00:00:03.661 --> 00:00:08.520\nBecause you could always be in an airport where a bar of chocolate cost £20\n",
    "url": "https://www.tiktok.com/@henripalms/video/7631128625017851138",
    "available_tracks": [
      {
        "url": "https://v16m-webapp.tiktokcdn-us.com/88ffad13a8398c73e149a82a1f44ad48/6a7a3247/video/tos/useast5/tos-useast5-v-0068c799-tx/102fcb7a5c304113be6f2f3a66041a78/",
        "format": "webvtt",
        "kind": "manual",
        "language_code": "eng-US",
        "language_name": "eng-US",
        "is_auto_generated": false
      }
    ],
    "is_auto_generated": false
  },
  "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"
}

Body

application/json

url

string

required

Video URL or bare numeric video id.

language

string | null

Optional caption-track language code.

use_ai_as_fallback

boolean

default:false

Whether the unavailable speech-to-text fallback may be requested.

Response

Completed lookup. Standard cost: 1 SideShift credit; account-specific pricing, when present, is shown in the Scraper dashboard and returned in the billing headers.

data

object

required

TikTok platform data payload. Field names and nesting are preserved.

Show child attributes

request_id

string

required

SideShift request id. Include it in support requests.

upstream_calls

enum<integer>

required

Number of data-source lookups performed.

Available options:

1

Guides

Reference

TikTok — transcript

Body

Response