Skip to main content
GET
/
v1
/
scrape
/
youtube
/
search
Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/youtube/search \
  --header 'X-API-Key: <api-key>'
{
  "videos": [
    {
      "type": "video",
      "id": "BzSzwqb-OEE",
      "url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
      "title": "NF - RUNNING (Audio)",
      "thumbnail": "https://i.ytimg.com/vi/BzSzwqb-OEE/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLCasEKav1CLqeSSE2IYDqjGiIMBGw",
      "channel": {
        "id": "UCoRR6OLuIZ2-5VxtnQIaN2w",
        "title": "NFrealmusic",
        "handle": "channel/UCoRR6OLuIZ2-5VxtnQIaN2w",
        "thumbnail": "https://yt3.ggpht.com/J1_Si0TYNZ-991v09y8RpCh4_Z_ALwKmPgMYnJqjNhoglVtipf3oEN8LpzG1kS0qsv8Jptpmmg=s88-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "14,860,541 views",
      "viewCountInt": 14860541,
      "publishedTimeText": "2 years ago",
      "publishedTime": "2023-05-28T17:08:46.499Z",
      "lengthText": "4:14",
      "lengthSeconds": 254,
      "badges": [
        "<unknown>"
      ]
    }
  ],
  "channels": [
    "<unknown>"
  ],
  "playlists": [
    "<unknown>"
  ],
  "shorts": [
    {
      "type": "short",
      "id": "uMNvF-lSCHg",
      "url": "https://www.youtube.com/watch?v=uMNvF-lSCHg",
      "title": "LONG RUN ROUTINE #run #runvlog #runner #shorts #morning",
      "thumbnail": "https://i.ytimg.com/vi/uMNvF-lSCHg/hq720.jpg?sqp=-oaymwFBCNAFEJQDSFryq4qpAzMIARUAAIhCGADYAQHiAQoIGBACGAY4AUAB8AEB-AG2CIACgA-KAgwIABABGFsgXyhlMA8=&rs=AOn4CLA_P-5ExEn9EGLJDNeJedsxb3k1eQ",
      "channel": {
        "id": "UCGRdcRxpJWi5Q2oDCrMDUuQ",
        "title": "Abby and Ryan",
        "handle": "abbyandryan",
        "thumbnail": "https://yt3.ggpht.com/8UdUEesepx1Ry_rFUPJOJgndTCKno9VTkSysnuJpFjMj63N6av0pNwnqoiKh_7PN2dw7PGIp=s68-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "462,705 views",
      "viewCountInt": 462705,
      "publishedTimeText": "10 months ago",
      "publishedTime": "2024-07-28T17:08:46.498Z",
      "lengthText": "0:44",
      "lengthSeconds": 44,
      "badges": [
        "<unknown>"
      ]
    }
  ],
  "shelves": [
    {
      "type": "shelf",
      "title": "Shorts",
      "items": [
        {
          "type": "short",
          "id": "LLBR5nO05tE",
          "url": "https://www.youtube.com/watch?v=LLBR5nO05tE",
          "title": "running through walls gone wrong",
          "thumbnail": "https://i.ytimg.com/vi/LLBR5nO05tE/oardefault.jpg?sqp=-oaymwEoCJUDENAFSFqQAgHyq4qpAxcIARUAAIhC2AEB4gEKCBgQAhgGOAFAAQ==&rs=AOn4CLCYYIIDmBllgkLP68AjVs25UpyevQ",
          "viewCountText": "750K",
          "viewCountInt": 750000
        }
      ]
    }
  ],
  "lives": [
    "<unknown>"
  ],
  "continuationToken": "EooDEg..."
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

Search query

​
uploadDate
enum<string>

Upload date

Available options:
last_hour,
today,
this_week,
this_month,
this_year
​
sortBy
enum<string>

Sort by

Available options:
relevance,
upload_date
Example:

"relevance"

​
filter
enum<string>

Filter by these options. Note this doesn't work when you use either 'uploadDate' or 'sortBy'. It basically only works when you have a query.

Available options:
all,
shorts
Example:

"all"

​
continuationToken
string

Continuation token to get more videos. Get 'continuationToken' from previous response.

Example:

"4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB"

​
includeExtras
string

This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. This will slow down the response slightly.

Example:

false

Response

Successful response

​
videos
object[]
required
​
channels
any[]
required
​
playlists
any[]
required
​
shorts
object[]
required
​
shelves
object[]
required
​
lives
any[]
required
​
continuationToken
string
required
Example:

"EooDEg..."