User Favorites

Fetch public favorite videos for a TikTok user when available upstream.

Endpoint

GET /api/tiktok/user/favorites
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

unique_id string Optional

TikTok username, with or without @.

user_id string Optional

Numeric TikTok user ID.

count integer Optional

Number of favorites to return.

cursor string Optional

Pagination cursor for the favorites list.

time integer Optional

Optional favorites time marker when provided by the upstream.

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0');

return $response->json();
fetch('https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

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

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/tiktok/user/favorites?unique_id=%40tiktok&count=10&cursor=0' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "code": 0,
    "msg": "success",
    "data": []
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home