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

import requests

url = "https://api.sociavault.com/v1/scrape/youtube/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/youtube/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/youtube/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/youtube/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/youtube/search")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sociavault.com/v1/scrape/youtube/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,
    "videos": {
      "0": {
        "type": "video",
        "id": "HJr2BqCcz8g",
        "url": "https://www.youtube.com/watch?v=HJr2BqCcz8g",
        "title": "Seahawks, Patriots set to face off in Super Bowl LX",
        "thumbnail": "https://i.ytimg.com/vi/HJr2BqCcz8g/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLAtMHHOTooONNH4jsuTuenVyKJSTg",
        "channel": {
          "id": "UCJg9wBPyKMNA5sRDnvzmkdg",
          "title": "LiveNOW from FOX",
          "handle": "livenowfox",
          "thumbnail": "https://yt3.ggpht.com/AqzY5ePezRAQ2136-TbM_88d43JfIovkzztge92WKQ4K_ISfJMFA9yuX0Nw87DLWms4W9r2c3Q=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "14,702 views",
        "viewCountInt": 14702,
        "publishedTimeText": "7 hours ago",
        "publishedTime": "2026-02-08T23:02:20.901Z",
        "lengthText": "7:07",
        "lengthSeconds": 427,
        "badges": {
          "0": "New"
        }
      }
    },
    "channels": {},
    "playlists": {},
    "shorts": {
      "0": {
        "type": "short",
        "id": "UhPc_k8DThI",
        "url": "https://www.youtube.com/watch?v=UhPc_k8DThI",
        "title": "Referee Caught in an Unexpected Scene #football #funny #shorts",
        "viewCountText": "7.1K",
        "viewCountInt": 7100
      }
    },
    "shelves": {},
    "lives": {
      "0": {
        "type": "live",
        "id": "4zBWoIBBRGw",
        "url": "https://www.youtube.com/watch?v=4zBWoIBBRGw",
        "title": "Super Bowl 2026 LIVE | Seattle Seahawks vs New England Patriots | Bad Bunny | Football | US News",
        "thumbnail": "https://i.ytimg.com/vi/4zBWoIBBRGw/hq720.jpg?v=6988822c&sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLDtn1fVYUTxe7X6FjAyLhmFwZjP9g",
        "channel": {
          "id": "UC3prwMn9aU2z5Y158ZdGyyA",
          "title": "CRUX",
          "handle": "CRUXnews",
          "thumbnail": "https://yt3.ggpht.com/ytc/AIdro_lvuTdsdT3Di7NszY9LTOcCmUVVG8nRnPAZpe_a7Y7MR6k=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "2,654 watching",
        "viewCountInt": 2654,
        "publishedTimeText": "",
        "publishedTime": null,
        "lengthText": "",
        "lengthSeconds": null,
        "badges": {
          "0": "LIVE",
          "1": "New"
        }
      },
      "1": {
        "type": "live",
        "id": "cicv_rduhNw",
        "url": "https://www.youtube.com/watch?v=cicv_rduhNw",
        "title": "Super Bowl LX Game Picks & Preview!",
        "thumbnail": "https://i.ytimg.com/vi/cicv_rduhNw/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLA-cJLvixHsz7iiu5g4nwfOwf73yA",
        "channel": {
          "id": "UCDVYQ4Zhbm3S2dlz7P1GBDg",
          "title": "NFL",
          "handle": "NFL",
          "thumbnail": "https://yt3.ggpht.com/mTNz2WARw0gLIz_BM5cuB6oRAQCTapuIwiiAAHd-IeWMCfE_zNcRVOXt4N6c4YxJbQ_kibWOFg=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "234,305 views",
        "viewCountInt": 234305,
        "publishedTimeText": "Streamed 30 minutes ago",
        "publishedTime": "2026-02-08T23:02:20.902Z",
        "lengthText": "1:01:45",
        "lengthSeconds": 3705,
        "badges": {
          "0": "New"
        }
      },
      "2": {
        "type": "live",
        "id": "VGwIz9lmq7M",
        "url": "https://www.youtube.com/watch?v=VGwIz9lmq7M",
        "title": "Team Druski vs. Team J Balvin: YouTube SBLX Flag Football Game",
        "thumbnail": "https://i.ytimg.com/vi/VGwIz9lmq7M/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLCs186z8dTqswXtu1BpXQPlEfQNcA",
        "channel": {
          "id": "UC4PQqjGczpgmqbpicKjkwvw",
          "title": "Druski",
          "handle": "druski",
          "thumbnail": "https://yt3.ggpht.com/A4OzUUsXpdV3KDqjz40moy-I3ygihVq7D69DY2mPsu7dui9bLt-Sy_mW9GMljYSWm5X8Y8FFiA=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "",
        "viewCountInt": null,
        "publishedTimeText": "Streamed 18 hours ago",
        "publishedTime": "2026-02-08T23:02:20.902Z",
        "lengthText": "1:57:05",
        "lengthSeconds": 7025,
        "badges": {
          "0": "New"
        }
      },
      "3": {
        "type": "live",
        "id": "2R2-6GsHrmw",
        "url": "https://www.youtube.com/watch?v=2R2-6GsHrmw",
        "title": "🔴Live : Man City vs Liverpool I English Premier League 2026 I Full Streaming I eFootball Pes 21 Game",
        "thumbnail": "https://i.ytimg.com/vi/2R2-6GsHrmw/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLATC36O5AFyYSczjMIe6ZqNtLqzvw",
        "channel": {
          "id": "UCxeXR8JqzNAOxAfS_ACtFdQ",
          "title": "Munna",
          "handle": "MunnaVdo",
          "thumbnail": "https://yt3.ggpht.com/pfvo_0ZdPUjIOSnNhqEIHZq9BfbOtfKc92efUTltDJ1csJjX8J28OYMJ7Px9nPz09N6QmVLh=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "380,051 views",
        "viewCountInt": 380051,
        "publishedTimeText": "Streamed 4 hours ago",
        "publishedTime": "2026-02-08T23:02:20.902Z",
        "lengthText": "9:55",
        "lengthSeconds": 595,
        "badges": {
          "0": "New"
        }
      },
      "4": {
        "type": "live",
        "id": "kIaRERgMqSY",
        "url": "https://www.youtube.com/watch?v=kIaRERgMqSY",
        "title": "Team J Balvin vs. Team Druski: YouTube SBLX Flag Football Game",
        "thumbnail": "https://i.ytimg.com/vi/kIaRERgMqSY/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLDbbBf4wUjBoGIPfGmy6_vJYcAliA",
        "channel": {
          "id": "UCBR8-60-B28hp2BmDPdntcQ",
          "title": "YouTube",
          "handle": "YouTube",
          "thumbnail": "https://yt3.ggpht.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s68-c-k-c0x00ffffff-no-rj"
        },
        "viewCountText": "",
        "viewCountInt": null,
        "publishedTimeText": "Streamed 18 hours ago",
        "publishedTime": "2026-02-08T23:02:20.902Z",
        "lengthText": "1:46:40",
        "lengthSeconds": 6400,
        "badges": {
          "0": "New"
        }
      }
    },
    "continuationToken": "ErkDEghmb290YmFsbBqsA1NCU0NBUXRJU25JeVFuRkRZM280WjRJQkN6UjZRbGR2U1VKQ1VrZDNnZ0VMWTJsamRsOXlaSFZvVG5lQ0FRdFBWRXR1UjFCUE0wdEdaNElCQzJoa05FTlNUVWQ0TVdKbmdnRUxlbmsxYVRkS1pqVnlVMG1DQVF0V1IzZEplamxzYlhFM1RZSUJDMlY0U1Y5NmRsSlhjbEZ2Z2dFTE1sSXlMVFpIYzBoeWJYZUNBUXRCWVVwblNqZzRRVlZNYTRJQkMwd3haV1F0VTB4RE5tRnJnZ0VMTkV0RVJUZE9UWE5vZGttQ0FRdHJTV0ZTUlZKblRYRlRXWUlCQzBOblEwb3lia0pCUldGVmdnRUxjelZ6U1RCek0xRjJUSGVDQVFzemMzQkVUSFJRYUdWd1JZSUJDMlZVZERsQ1RrZG1iSE5aZ2dFaVVFeG1hV3REU0hSSGFtODBiREpCU21Kd2EyZHJiVVpQZUdkSlVVSmpPVkJ1TW9JQkMySlFhM2QzT1haNk9FdHJnZ0VMVXpod1lsVjZNazl3Y1VXeUFRWUtCQWdhRUFMcUFRUUlBaEFVGIHg6BgiC3NlYXJjaC1mZWVk"
  },
  "credits_used": 1,
  "endpoint": "youtube/search"
}

{
  "error": "Missing required parameter: handle",
  "endpoint": "<string>",
  "credits_required": 123
}

{
  "error": "Invalid API key",
  "docs": "https://docs.sociavault.com/authentication"
}

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

{
  "error": "Service configuration error"
}