Feed Search

Search TikTok feed videos by keywords with optional region and sorting filters.

Endpoint

GET /api/tiktok/feed/search

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

keywords string Required

Feed search keywords.

region string Optional

Optional region code such as US or JP.

count integer Optional

Number of results to return.

cursor string Optional

Pagination cursor for continuing a previous feed search.

publish_time integer Optional

Optional publish-time filter supported by the upstream.

sort_type integer Optional

Optional upstream sort type value for feed search ordering.

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/tiktok/feed/search?keywords=basketball&region=US&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/feed/search?keywords=basketball&region=US&count=10&cursor=0');

return $response->json();
fetch('https://scrappa.co/api/tiktok/feed/search?keywords=basketball&region=US&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/feed/search?keywords=basketball&region=US&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/feed/search?keywords=basketball&region=US&count=10&cursor=0', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/tiktok/feed/search?keywords=basketball&region=US&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/feed/search?keywords=basketball&region=US&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/feed/search?keywords=basketball&region=US&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