curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok-ad-library/search \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.sociavault.com/v1/scrape/tiktok-ad-library/search"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.sociavault.com/v1/scrape/tiktok-ad-library/search', 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://api.sociavault.com/v1/scrape/tiktok-ad-library/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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://api.sociavault.com/v1/scrape/tiktok-ad-library/search"

	req, _ := http.NewRequest("GET", 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.get("https://api.sociavault.com/v1/scrape/tiktok-ad-library/search")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sociavault.com/v1/scrape/tiktok-ad-library/search")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "success": true,
  "data": {
    "success": true,
    "query": "shoes",
    "region": "US",
    "period": 30,
    "ads": {
      "0": {
        "ad_title": "HR would like to remind you that what happens at the premiere, stays at the premiere. Office Romance June 5 on @Netflix ",
        "brand_name": "",
        "cost": 1,
        "ctr": 0.34,
        "favorite": false,
        "id": "7645249124891607041",
        "industry_key": "label_23108000000",
        "is_search": false,
        "like": 1294,
        "objective_key": "campaign_objective_traffic",
        "video_info": {
          "vid": "v15044gf0000d8blg3vog65m7i2j3320",
          "duration": 55.843,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/owWoFXnfIfGLjgWAuAYQXIeqGAQpGQGYReBQGU~tplv-noop.image?dr=18692&refresh_token=25085a08&x-expires=1781236812&x-signature=cYE54g9ru2lGz4QwxLNrzJR7vao%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v15044gf0000d8blg3vog65m7i2j3320",
          "video_url": {
            "540p": "https://v16m-default.tiktokcdn.com/4cf48674533ea486264fecb0e62bb0d8/6a2b844c/video/tos/maliva/tos-maliva-ve-0068c799-us/osXAIFIWHpGGG8AGAefjLRXQeYUgUoIRWpQfQ3/?a=0&bti=NTU4QDM1NGA%3D&&bt=511&ft=cApXJCz7ThWHE.t9LGZmo0P&mime_type=video_mp4&rc=M2Q7ZDVpODY8NjhpOjk4ZkBpMzZtbHA5cjZvOzMzaTczNEBeLl9fYl4tXzUxNDNiMC40YSMvMC80MmRzZF9hLS1kMTJzcw%3D%3D&vvpl=1&l=202606120559171BEEA8ABD2CB799CFAAE&btag=e00088000",
            "720p": "https://v16m-default.tiktokcdn.com/1834a0d6d95854f01ac31c062a0d579e/6a2b844c/video/tos/maliva/tos-maliva-ve-0068c799-us/ocf1SxIUCtBCUXsiEWiwHIRIiEJIEAA26jQqPA/?a=0&bti=NTU4QDM1NGA%3D&&bt=1360&ft=cApXJCz7ThWHE.t9LGZmo0P&mime_type=video_mp4&rc=Z2U2OWRlOzw8aTY4aGY5ZUBpMzZtbHA5cjZvOzMzaTczNEAyMi80YzQ1XzAxX2AyYTA1YSMvMC80MmRzZF9hLS1kMTJzcw%3D%3D&vvpl=1&l=202606120559171BEEA8ABD2CB799CFAAE&btag=e00088000"
          },
          "width": 720,
          "height": 1280
        }
      },
      "1": {
        "ad_title": "إعلان لا يفوتكم خصومات 30% ثابت في سكتشرز خصومات سكتشرز تناسب كل العائله Skechers #سكتشرز #عروض #خصومات ",
        "brand_name": "",
        "cost": 0,
        "ctr": 0.9,
        "favorite": false,
        "id": "7639391345481367572",
        "industry_key": "label_22111000000",
        "is_search": false,
        "like": 861,
        "objective_key": "campaign_objective_video_view",
        "video_info": {
          "vid": "v1c044g50000d80tnmvog65kkmu4l21g",
          "duration": 46.7,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oUDDlcQbQBVAiQEeBfRuEQpBgvhGdgE3ISA3Fq~tplv-noop.image?dr=18692&refresh_token=a0b1868e&x-expires=1781236803&x-signature=w%2Bd3QIBeS8eKmuX3vyfWIUc%2BuCE%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v1c044g50000d80tnmvog65kkmu4l21g",
          "video_url": {
            "720p": "https://v16m-default.tiktokcdn.com/2d7e28bd73853680e127bc1be7dc1eb5/6a2b8443/video/tos/alisg/tos-alisg-pve-0037c001/oUb3IQLD1oAliixBA0iiw3BtCAAIWBTEIpfKuO/?a=0&bti=NTU4QDM1NGA%3D&&bt=1983&ft=cApXJCz7ThWHE.t9LGZmo0P&mime_type=video_mp4&rc=NGVoOjw5Ojs5PGQ8PDw4NkBpajU3cG45cnB3OzMzODczNEBjYTRfXjEtNjMxXjEzLWBeYSMuaXJoMmRzay1hLS1kMWBzcw%3D%3D&vvpl=1&l=202606120559171BEEA8ABD2CB799CFAAE&btag=e00088000"
          },
          "width": 576,
          "height": 1024
        }
      }
    },
    "pagination": {
      "has_more": false,
      "page": 1,
      "size": 20,
      "total_count": 4
    },
    "total": 4,
    "has_more": false,
    "cursor": null
  },
  "credits_used": 1
}

{
  "success": false,
  "error": "User not authenticated"
}

{
  "success": false,
  "error": "Insufficient credits",
  "required": 1,
  "available": 0
}