TikTok — regions
curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/tiktok/regions \
--header 'x-api-key: <api-key>'import requests
url = "https://app.sideshift.app/api/v1/scrape/tiktok/regions"
headers = {"x-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};
fetch('https://app.sideshift.app/api/v1/scrape/tiktok/regions', 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/regions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/v1/scrape/tiktok/regions"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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/regions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/tiktok/regions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"total": 242,
"regions": [
{
"code": "AD",
"name": "Andorra"
},
{
"code": "AE",
"name": "United Arab Emirates"
},
{
"code": "AF",
"name": "Afghanistan"
},
{
"code": "AG",
"name": "Antigua & Barbuda"
},
{
"code": "AI",
"name": "Anguilla"
},
{
"code": "AL",
"name": "Albania"
},
{
"code": "AM",
"name": "Armenia"
},
{
"code": "AO",
"name": "Angola"
},
{
"code": "AR",
"name": "Argentina"
},
{
"code": "AS",
"name": "American Samoa"
},
{
"code": "AT",
"name": "Austria"
},
{
"code": "AU",
"name": "Australia"
},
{
"code": "AW",
"name": "Aruba"
},
{
"code": "AX",
"name": "Åland Islands"
},
{
"code": "AZ",
"name": "Azerbaijan"
},
{
"code": "BA",
"name": "Bosnia & Herzegovina"
},
{
"code": "BB",
"name": "Barbados"
},
{
"code": "BD",
"name": "Bangladesh"
},
{
"code": "BE",
"name": "Belgium"
},
{
"code": "BF",
"name": "Burkina-faso"
},
{
"code": "BG",
"name": "Bulgaria"
},
{
"code": "BH",
"name": "Bahrain"
},
{
"code": "BI",
"name": "Burundi"
},
{
"code": "BJ",
"name": "Benin"
},
{
"code": "BL",
"name": "St. Barthélemy"
},
{
"code": "BM",
"name": "Bermuda"
},
{
"code": "BN",
"name": "Brunei"
},
{
"code": "BO",
"name": "Bolivia"
},
{
"code": "BQ",
"name": "Caribbean Netherlands"
},
{
"code": "BR",
"name": "Brazil"
},
{
"code": "BS",
"name": "Bahamas"
},
{
"code": "BT",
"name": "Bhutan"
},
{
"code": "BW",
"name": "Botswana"
},
{
"code": "BY",
"name": "Belarus"
},
{
"code": "BZ",
"name": "Belize"
},
{
"code": "CA",
"name": "Canada"
},
{
"code": "CC",
"name": "Cocos (Keeling) Islands"
},
{
"code": "CD",
"name": "Congo - Kinshasa"
},
{
"code": "CF",
"name": "Central African Republic"
},
{
"code": "CG",
"name": "Congo - Brazzaville"
},
{
"code": "CH",
"name": "Switzerland"
},
{
"code": "CI",
"name": "Ivory Coast"
},
{
"code": "CK",
"name": "Cook Is."
},
{
"code": "CL",
"name": "Chile"
},
{
"code": "CM",
"name": "Cameroon"
},
{
"code": "CN",
"name": "China mainland"
},
{
"code": "CO",
"name": "Colombia"
},
{
"code": "CR",
"name": "Costa Rica"
},
{
"code": "CV",
"name": "Cape Verde"
},
{
"code": "CW",
"name": "Curaçao"
},
{
"code": "CX",
"name": "Christmas Island"
},
{
"code": "CY",
"name": "Cyprus"
},
{
"code": "CZ",
"name": "Czechia"
},
{
"code": "DE",
"name": "Germany"
},
{
"code": "DG",
"name": "Diego Garcia"
},
{
"code": "DJ",
"name": "Djibouti"
},
{
"code": "DK",
"name": "Denmark"
},
{
"code": "DM",
"name": "Dominica"
},
{
"code": "DO",
"name": "Dominica Rep."
},
{
"code": "DZ",
"name": "Algeria"
},
{
"code": "EC",
"name": "Ecuador"
},
{
"code": "EE",
"name": "Estonia"
},
{
"code": "EG",
"name": "Egypt"
},
{
"code": "EH",
"name": "Western Sahara"
},
{
"code": "ER",
"name": "Eritrea"
},
{
"code": "ES",
"name": "Spain"
},
{
"code": "ET",
"name": "Ethiopia"
},
{
"code": "FI",
"name": "Finland"
},
{
"code": "FJ",
"name": "Fiji"
},
{
"code": "FK",
"name": "Falkland Islands"
},
{
"code": "FM",
"name": "Micronesia"
},
{
"code": "FO",
"name": "Faroe Islands"
},
{
"code": "FR",
"name": "France"
},
{
"code": "GA",
"name": "Gabon"
},
{
"code": "GB",
"name": "United Kingdom"
},
{
"code": "GD",
"name": "Grenada"
},
{
"code": "GE",
"name": "Georgia"
},
{
"code": "GF",
"name": "French Guiana"
},
{
"code": "GG",
"name": "Guernsey"
},
{
"code": "GH",
"name": "Ghana"
},
{
"code": "GI",
"name": "Gibraltar"
},
{
"code": "GL",
"name": "Greenland"
},
{
"code": "GM",
"name": "Gambia"
},
{
"code": "GN",
"name": "Guinea"
},
{
"code": "GP",
"name": "Guadeloupe"
},
{
"code": "GQ",
"name": "Equatorial Guinea"
},
{
"code": "GR",
"name": "Greece"
},
{
"code": "GS",
"name": "So. Georgia & So. Sandwich Isl."
},
{
"code": "GT",
"name": "Guatemala"
},
{
"code": "GU",
"name": "Guam"
},
{
"code": "GW",
"name": "Guinea-Bissau"
},
{
"code": "GY",
"name": "Guyana"
},
{
"code": "HK",
"name": "Hongkong"
},
{
"code": "HN",
"name": "Honduras"
},
{
"code": "HR",
"name": "Croatia"
},
{
"code": "HT",
"name": "Haiti"
},
{
"code": "HU",
"name": "Hungary"
},
{
"code": "ID",
"name": "Indonesia"
},
{
"code": "IE",
"name": "Ireland"
},
{
"code": "IL",
"name": "Israel"
},
{
"code": "IM",
"name": "Isle of Man"
},
{
"code": "IN",
"name": "India"
},
{
"code": "IO",
"name": "British Indian Ocean Territory"
},
{
"code": "IQ",
"name": "Iraq"
},
{
"code": "IS",
"name": "Iceland"
},
{
"code": "IT",
"name": "Italy"
},
{
"code": "JE",
"name": "Jersey"
},
{
"code": "JM",
"name": "Jamaica"
},
{
"code": "JO",
"name": "Jordan"
},
{
"code": "JP",
"name": "Japan"
},
{
"code": "KE",
"name": "Kenya"
},
{
"code": "KG",
"name": "Kyrgyzstan"
},
{
"code": "KH",
"name": "Kampuchea (Cambodia )"
},
{
"code": "KI",
"name": "Kiribati"
},
{
"code": "KM",
"name": "Comoros"
},
{
"code": "KN",
"name": "St. Kitts & Nevis"
},
{
"code": "KR",
"name": "Korea"
},
{
"code": "KW",
"name": "Kuwait"
},
{
"code": "KY",
"name": "Cayman Is."
},
{
"code": "KZ",
"name": "Kazakhstan"
},
{
"code": "LA",
"name": "Laos"
},
{
"code": "LB",
"name": "Lebanon"
},
{
"code": "LC",
"name": "St.Lucia"
},
{
"code": "LI",
"name": "Liechtenstein"
},
{
"code": "LK",
"name": "Sri Lanka"
},
{
"code": "LR",
"name": "Liberia"
},
{
"code": "LS",
"name": "Lesotho"
},
{
"code": "LT",
"name": "Lithuania"
},
{
"code": "LU",
"name": "Luxembourg"
},
{
"code": "LV",
"name": "Latvia"
},
{
"code": "LY",
"name": "Libya"
},
{
"code": "MA",
"name": "Morocco"
},
{
"code": "MC",
"name": "Monaco"
},
{
"code": "MD",
"name": "Moldova, Republic of"
},
{
"code": "ME",
"name": "Montenegro"
},
{
"code": "MF",
"name": "St. Martin"
},
{
"code": "MG",
"name": "Madagascar"
},
{
"code": "MH",
"name": "Marshall Islands"
},
{
"code": "MK",
"name": "North Macedonia"
},
{
"code": "ML",
"name": "Mali"
},
{
"code": "MM",
"name": "Myanmar (Burma)"
},
{
"code": "MN",
"name": "Mongolia"
},
{
"code": "MO",
"name": "Macao"
},
{
"code": "MP",
"name": "Northern Mariana Islands"
},
{
"code": "MQ",
"name": "Martinique"
},
{
"code": "MR",
"name": "Mauritania"
},
{
"code": "MS",
"name": "Montserrat"
},
{
"code": "MT",
"name": "Malta"
},
{
"code": "MU",
"name": "Mauritius"
},
{
"code": "MV",
"name": "Maldives"
},
{
"code": "MW",
"name": "Malawi"
},
{
"code": "MX",
"name": "Mexico"
},
{
"code": "MY",
"name": "Malaysia"
},
{
"code": "MZ",
"name": "Mozambique"
},
{
"code": "NA",
"name": "Namibia"
},
{
"code": "NC",
"name": "New Caledonia"
},
{
"code": "NE",
"name": "Niger"
},
{
"code": "NF",
"name": "Norfolk Island"
},
{
"code": "NG",
"name": "Nigeria"
},
{
"code": "NI",
"name": "Nicaragua"
},
{
"code": "NL",
"name": "Netherlands"
},
{
"code": "NO",
"name": "Norway"
},
{
"code": "NP",
"name": "Nepal"
},
{
"code": "NR",
"name": "Nauru"
},
{
"code": "NU",
"name": "Niue"
},
{
"code": "NZ",
"name": "New Zealand"
},
{
"code": "OM",
"name": "Oman"
},
{
"code": "PA",
"name": "Panama"
},
{
"code": "PE",
"name": "Peru"
},
{
"code": "PF",
"name": "French Polynesia"
},
{
"code": "PG",
"name": "Papua New Cuinea"
},
{
"code": "PH",
"name": "Philippines"
},
{
"code": "PK",
"name": "Pakistan"
},
{
"code": "PL",
"name": "Poland"
},
{
"code": "PM",
"name": "St. Pierre & Miquelon"
},
{
"code": "PN",
"name": "Pitcairn Islands"
},
{
"code": "PR",
"name": "Puerto Rico"
},
{
"code": "PS",
"name": "Palestinian Territories"
},
{
"code": "PT",
"name": "Portugal"
},
{
"code": "PW",
"name": "Palau"
},
{
"code": "PY",
"name": "Paraguay"
},
{
"code": "QA",
"name": "Qatar"
},
{
"code": "RE",
"name": "Réunion"
},
{
"code": "RO",
"name": "Romania"
},
{
"code": "RS",
"name": "Serbia"
},
{
"code": "RU",
"name": "Russia"
},
{
"code": "RW",
"name": "Rwanda"
},
{
"code": "SA",
"name": "Saudi Arabia"
},
{
"code": "SB",
"name": "Solomon Is"
},
{
"code": "SC",
"name": "Seychelles"
},
{
"code": "SD",
"name": "Sudan"
},
{
"code": "SE",
"name": "Sweden"
},
{
"code": "SG",
"name": "Singapore"
},
{
"code": "SH",
"name": "Ascension Island"
},
{
"code": "SI",
"name": "Slovenia"
},
{
"code": "SJ",
"name": "Svalbard & Jan Mayen"
},
{
"code": "SK",
"name": "Slovakia"
},
{
"code": "SL",
"name": "Sierra Leone"
},
{
"code": "SM",
"name": "San Marino"
},
{
"code": "SN",
"name": "Senegal"
},
{
"code": "SO",
"name": "Somali"
},
{
"code": "SR",
"name": "Suriname"
},
{
"code": "SS",
"name": "South Sudan"
},
{
"code": "ST",
"name": "Sao Tome and Principe"
},
{
"code": "SV",
"name": "EI Salvador"
},
{
"code": "SX",
"name": "Sint Maarten"
},
{
"code": "SZ",
"name": "Eswatini"
},
{
"code": "TC",
"name": "Turks & Caicos Islands"
},
{
"code": "TD",
"name": "Chad"
},
{
"code": "TG",
"name": "Togo"
},
{
"code": "TH",
"name": "Thailand"
},
{
"code": "TJ",
"name": "Tajikstan"
},
{
"code": "TK",
"name": "Tokelau"
},
{
"code": "TL",
"name": "Timor-Leste"
},
{
"code": "TM",
"name": "Turkmenistan"
},
{
"code": "TN",
"name": "Tunisia"
},
{
"code": "TO",
"name": "Tonga"
},
{
"code": "TR",
"name": "Turkey"
},
{
"code": "TT",
"name": "Trinidad & Tobago"
},
{
"code": "TV",
"name": "Tuvalu"
},
{
"code": "TW",
"name": "Taiwan"
},
{
"code": "TZ",
"name": "Tanzania"
},
{
"code": "UA",
"name": "Ukraine"
},
{
"code": "UG",
"name": "Uganda"
},
{
"code": "US",
"name": "United States"
},
{
"code": "UY",
"name": "Uruguay"
},
{
"code": "UZ",
"name": "Uzbekistan"
},
{
"code": "VA",
"name": "Vatican City"
},
{
"code": "VC",
"name": "St. Vincent & Grenadines"
},
{
"code": "VE",
"name": "Venezuela"
},
{
"code": "VG",
"name": "British Virgin Islands"
},
{
"code": "VI",
"name": "U.S. Virgin Islands"
},
{
"code": "VN",
"name": "Vietnam"
},
{
"code": "VU",
"name": "Vanuatu"
},
{
"code": "WF",
"name": "Wallis & Futuna"
},
{
"code": "WS",
"name": "Samoa"
},
{
"code": "XK",
"name": "Kosovo"
},
{
"code": "YE",
"name": "Yemen"
},
{
"code": "YT",
"name": "Mayotte"
},
{
"code": "ZA",
"name": "South Africa"
},
{
"code": "ZM",
"name": "Zambia"
},
{
"code": "ZW",
"name": "Zimbabwe"
}
]
},
"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"
}1 credit per request
The region codes accepted by the region-scoped endpoints. Platform field names are preserved inside data. This operation takes no parameters; omit the request body or send an empty JSON object.
POST
/
scrape
/
tiktok
/
regions
TikTok — regions
curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/tiktok/regions \
--header 'x-api-key: <api-key>'import requests
url = "https://app.sideshift.app/api/v1/scrape/tiktok/regions"
headers = {"x-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};
fetch('https://app.sideshift.app/api/v1/scrape/tiktok/regions', 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/regions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/v1/scrape/tiktok/regions"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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/regions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/tiktok/regions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"total": 242,
"regions": [
{
"code": "AD",
"name": "Andorra"
},
{
"code": "AE",
"name": "United Arab Emirates"
},
{
"code": "AF",
"name": "Afghanistan"
},
{
"code": "AG",
"name": "Antigua & Barbuda"
},
{
"code": "AI",
"name": "Anguilla"
},
{
"code": "AL",
"name": "Albania"
},
{
"code": "AM",
"name": "Armenia"
},
{
"code": "AO",
"name": "Angola"
},
{
"code": "AR",
"name": "Argentina"
},
{
"code": "AS",
"name": "American Samoa"
},
{
"code": "AT",
"name": "Austria"
},
{
"code": "AU",
"name": "Australia"
},
{
"code": "AW",
"name": "Aruba"
},
{
"code": "AX",
"name": "Åland Islands"
},
{
"code": "AZ",
"name": "Azerbaijan"
},
{
"code": "BA",
"name": "Bosnia & Herzegovina"
},
{
"code": "BB",
"name": "Barbados"
},
{
"code": "BD",
"name": "Bangladesh"
},
{
"code": "BE",
"name": "Belgium"
},
{
"code": "BF",
"name": "Burkina-faso"
},
{
"code": "BG",
"name": "Bulgaria"
},
{
"code": "BH",
"name": "Bahrain"
},
{
"code": "BI",
"name": "Burundi"
},
{
"code": "BJ",
"name": "Benin"
},
{
"code": "BL",
"name": "St. Barthélemy"
},
{
"code": "BM",
"name": "Bermuda"
},
{
"code": "BN",
"name": "Brunei"
},
{
"code": "BO",
"name": "Bolivia"
},
{
"code": "BQ",
"name": "Caribbean Netherlands"
},
{
"code": "BR",
"name": "Brazil"
},
{
"code": "BS",
"name": "Bahamas"
},
{
"code": "BT",
"name": "Bhutan"
},
{
"code": "BW",
"name": "Botswana"
},
{
"code": "BY",
"name": "Belarus"
},
{
"code": "BZ",
"name": "Belize"
},
{
"code": "CA",
"name": "Canada"
},
{
"code": "CC",
"name": "Cocos (Keeling) Islands"
},
{
"code": "CD",
"name": "Congo - Kinshasa"
},
{
"code": "CF",
"name": "Central African Republic"
},
{
"code": "CG",
"name": "Congo - Brazzaville"
},
{
"code": "CH",
"name": "Switzerland"
},
{
"code": "CI",
"name": "Ivory Coast"
},
{
"code": "CK",
"name": "Cook Is."
},
{
"code": "CL",
"name": "Chile"
},
{
"code": "CM",
"name": "Cameroon"
},
{
"code": "CN",
"name": "China mainland"
},
{
"code": "CO",
"name": "Colombia"
},
{
"code": "CR",
"name": "Costa Rica"
},
{
"code": "CV",
"name": "Cape Verde"
},
{
"code": "CW",
"name": "Curaçao"
},
{
"code": "CX",
"name": "Christmas Island"
},
{
"code": "CY",
"name": "Cyprus"
},
{
"code": "CZ",
"name": "Czechia"
},
{
"code": "DE",
"name": "Germany"
},
{
"code": "DG",
"name": "Diego Garcia"
},
{
"code": "DJ",
"name": "Djibouti"
},
{
"code": "DK",
"name": "Denmark"
},
{
"code": "DM",
"name": "Dominica"
},
{
"code": "DO",
"name": "Dominica Rep."
},
{
"code": "DZ",
"name": "Algeria"
},
{
"code": "EC",
"name": "Ecuador"
},
{
"code": "EE",
"name": "Estonia"
},
{
"code": "EG",
"name": "Egypt"
},
{
"code": "EH",
"name": "Western Sahara"
},
{
"code": "ER",
"name": "Eritrea"
},
{
"code": "ES",
"name": "Spain"
},
{
"code": "ET",
"name": "Ethiopia"
},
{
"code": "FI",
"name": "Finland"
},
{
"code": "FJ",
"name": "Fiji"
},
{
"code": "FK",
"name": "Falkland Islands"
},
{
"code": "FM",
"name": "Micronesia"
},
{
"code": "FO",
"name": "Faroe Islands"
},
{
"code": "FR",
"name": "France"
},
{
"code": "GA",
"name": "Gabon"
},
{
"code": "GB",
"name": "United Kingdom"
},
{
"code": "GD",
"name": "Grenada"
},
{
"code": "GE",
"name": "Georgia"
},
{
"code": "GF",
"name": "French Guiana"
},
{
"code": "GG",
"name": "Guernsey"
},
{
"code": "GH",
"name": "Ghana"
},
{
"code": "GI",
"name": "Gibraltar"
},
{
"code": "GL",
"name": "Greenland"
},
{
"code": "GM",
"name": "Gambia"
},
{
"code": "GN",
"name": "Guinea"
},
{
"code": "GP",
"name": "Guadeloupe"
},
{
"code": "GQ",
"name": "Equatorial Guinea"
},
{
"code": "GR",
"name": "Greece"
},
{
"code": "GS",
"name": "So. Georgia & So. Sandwich Isl."
},
{
"code": "GT",
"name": "Guatemala"
},
{
"code": "GU",
"name": "Guam"
},
{
"code": "GW",
"name": "Guinea-Bissau"
},
{
"code": "GY",
"name": "Guyana"
},
{
"code": "HK",
"name": "Hongkong"
},
{
"code": "HN",
"name": "Honduras"
},
{
"code": "HR",
"name": "Croatia"
},
{
"code": "HT",
"name": "Haiti"
},
{
"code": "HU",
"name": "Hungary"
},
{
"code": "ID",
"name": "Indonesia"
},
{
"code": "IE",
"name": "Ireland"
},
{
"code": "IL",
"name": "Israel"
},
{
"code": "IM",
"name": "Isle of Man"
},
{
"code": "IN",
"name": "India"
},
{
"code": "IO",
"name": "British Indian Ocean Territory"
},
{
"code": "IQ",
"name": "Iraq"
},
{
"code": "IS",
"name": "Iceland"
},
{
"code": "IT",
"name": "Italy"
},
{
"code": "JE",
"name": "Jersey"
},
{
"code": "JM",
"name": "Jamaica"
},
{
"code": "JO",
"name": "Jordan"
},
{
"code": "JP",
"name": "Japan"
},
{
"code": "KE",
"name": "Kenya"
},
{
"code": "KG",
"name": "Kyrgyzstan"
},
{
"code": "KH",
"name": "Kampuchea (Cambodia )"
},
{
"code": "KI",
"name": "Kiribati"
},
{
"code": "KM",
"name": "Comoros"
},
{
"code": "KN",
"name": "St. Kitts & Nevis"
},
{
"code": "KR",
"name": "Korea"
},
{
"code": "KW",
"name": "Kuwait"
},
{
"code": "KY",
"name": "Cayman Is."
},
{
"code": "KZ",
"name": "Kazakhstan"
},
{
"code": "LA",
"name": "Laos"
},
{
"code": "LB",
"name": "Lebanon"
},
{
"code": "LC",
"name": "St.Lucia"
},
{
"code": "LI",
"name": "Liechtenstein"
},
{
"code": "LK",
"name": "Sri Lanka"
},
{
"code": "LR",
"name": "Liberia"
},
{
"code": "LS",
"name": "Lesotho"
},
{
"code": "LT",
"name": "Lithuania"
},
{
"code": "LU",
"name": "Luxembourg"
},
{
"code": "LV",
"name": "Latvia"
},
{
"code": "LY",
"name": "Libya"
},
{
"code": "MA",
"name": "Morocco"
},
{
"code": "MC",
"name": "Monaco"
},
{
"code": "MD",
"name": "Moldova, Republic of"
},
{
"code": "ME",
"name": "Montenegro"
},
{
"code": "MF",
"name": "St. Martin"
},
{
"code": "MG",
"name": "Madagascar"
},
{
"code": "MH",
"name": "Marshall Islands"
},
{
"code": "MK",
"name": "North Macedonia"
},
{
"code": "ML",
"name": "Mali"
},
{
"code": "MM",
"name": "Myanmar (Burma)"
},
{
"code": "MN",
"name": "Mongolia"
},
{
"code": "MO",
"name": "Macao"
},
{
"code": "MP",
"name": "Northern Mariana Islands"
},
{
"code": "MQ",
"name": "Martinique"
},
{
"code": "MR",
"name": "Mauritania"
},
{
"code": "MS",
"name": "Montserrat"
},
{
"code": "MT",
"name": "Malta"
},
{
"code": "MU",
"name": "Mauritius"
},
{
"code": "MV",
"name": "Maldives"
},
{
"code": "MW",
"name": "Malawi"
},
{
"code": "MX",
"name": "Mexico"
},
{
"code": "MY",
"name": "Malaysia"
},
{
"code": "MZ",
"name": "Mozambique"
},
{
"code": "NA",
"name": "Namibia"
},
{
"code": "NC",
"name": "New Caledonia"
},
{
"code": "NE",
"name": "Niger"
},
{
"code": "NF",
"name": "Norfolk Island"
},
{
"code": "NG",
"name": "Nigeria"
},
{
"code": "NI",
"name": "Nicaragua"
},
{
"code": "NL",
"name": "Netherlands"
},
{
"code": "NO",
"name": "Norway"
},
{
"code": "NP",
"name": "Nepal"
},
{
"code": "NR",
"name": "Nauru"
},
{
"code": "NU",
"name": "Niue"
},
{
"code": "NZ",
"name": "New Zealand"
},
{
"code": "OM",
"name": "Oman"
},
{
"code": "PA",
"name": "Panama"
},
{
"code": "PE",
"name": "Peru"
},
{
"code": "PF",
"name": "French Polynesia"
},
{
"code": "PG",
"name": "Papua New Cuinea"
},
{
"code": "PH",
"name": "Philippines"
},
{
"code": "PK",
"name": "Pakistan"
},
{
"code": "PL",
"name": "Poland"
},
{
"code": "PM",
"name": "St. Pierre & Miquelon"
},
{
"code": "PN",
"name": "Pitcairn Islands"
},
{
"code": "PR",
"name": "Puerto Rico"
},
{
"code": "PS",
"name": "Palestinian Territories"
},
{
"code": "PT",
"name": "Portugal"
},
{
"code": "PW",
"name": "Palau"
},
{
"code": "PY",
"name": "Paraguay"
},
{
"code": "QA",
"name": "Qatar"
},
{
"code": "RE",
"name": "Réunion"
},
{
"code": "RO",
"name": "Romania"
},
{
"code": "RS",
"name": "Serbia"
},
{
"code": "RU",
"name": "Russia"
},
{
"code": "RW",
"name": "Rwanda"
},
{
"code": "SA",
"name": "Saudi Arabia"
},
{
"code": "SB",
"name": "Solomon Is"
},
{
"code": "SC",
"name": "Seychelles"
},
{
"code": "SD",
"name": "Sudan"
},
{
"code": "SE",
"name": "Sweden"
},
{
"code": "SG",
"name": "Singapore"
},
{
"code": "SH",
"name": "Ascension Island"
},
{
"code": "SI",
"name": "Slovenia"
},
{
"code": "SJ",
"name": "Svalbard & Jan Mayen"
},
{
"code": "SK",
"name": "Slovakia"
},
{
"code": "SL",
"name": "Sierra Leone"
},
{
"code": "SM",
"name": "San Marino"
},
{
"code": "SN",
"name": "Senegal"
},
{
"code": "SO",
"name": "Somali"
},
{
"code": "SR",
"name": "Suriname"
},
{
"code": "SS",
"name": "South Sudan"
},
{
"code": "ST",
"name": "Sao Tome and Principe"
},
{
"code": "SV",
"name": "EI Salvador"
},
{
"code": "SX",
"name": "Sint Maarten"
},
{
"code": "SZ",
"name": "Eswatini"
},
{
"code": "TC",
"name": "Turks & Caicos Islands"
},
{
"code": "TD",
"name": "Chad"
},
{
"code": "TG",
"name": "Togo"
},
{
"code": "TH",
"name": "Thailand"
},
{
"code": "TJ",
"name": "Tajikstan"
},
{
"code": "TK",
"name": "Tokelau"
},
{
"code": "TL",
"name": "Timor-Leste"
},
{
"code": "TM",
"name": "Turkmenistan"
},
{
"code": "TN",
"name": "Tunisia"
},
{
"code": "TO",
"name": "Tonga"
},
{
"code": "TR",
"name": "Turkey"
},
{
"code": "TT",
"name": "Trinidad & Tobago"
},
{
"code": "TV",
"name": "Tuvalu"
},
{
"code": "TW",
"name": "Taiwan"
},
{
"code": "TZ",
"name": "Tanzania"
},
{
"code": "UA",
"name": "Ukraine"
},
{
"code": "UG",
"name": "Uganda"
},
{
"code": "US",
"name": "United States"
},
{
"code": "UY",
"name": "Uruguay"
},
{
"code": "UZ",
"name": "Uzbekistan"
},
{
"code": "VA",
"name": "Vatican City"
},
{
"code": "VC",
"name": "St. Vincent & Grenadines"
},
{
"code": "VE",
"name": "Venezuela"
},
{
"code": "VG",
"name": "British Virgin Islands"
},
{
"code": "VI",
"name": "U.S. Virgin Islands"
},
{
"code": "VN",
"name": "Vietnam"
},
{
"code": "VU",
"name": "Vanuatu"
},
{
"code": "WF",
"name": "Wallis & Futuna"
},
{
"code": "WS",
"name": "Samoa"
},
{
"code": "XK",
"name": "Kosovo"
},
{
"code": "YE",
"name": "Yemen"
},
{
"code": "YT",
"name": "Mayotte"
},
{
"code": "ZA",
"name": "South Africa"
},
{
"code": "ZM",
"name": "Zambia"
},
{
"code": "ZW",
"name": "Zimbabwe"
}
]
},
"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"
}Authorizations
Independent Scraper API key (scrape_live_*). Generate one in the Scraper dashboard.
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.
TikTok platform data payload. Field names and nesting are preserved.
Show child attributes
Show child attributes
SideShift request id. Include it in support requests.
Number of data-source lookups performed.
Available options:
1 Per-request credit accounting (also surfaced in the X-Scraper-Credits-* response headers).
Show child attributes
Show child attributes