YouTube video.search

POST

youtube

video.search

curl -X POST https://api.socialrouter.io/v1/youtube/video.search \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "machine learning tutorial",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/video.search",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      query: "machine learning tutorial",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/video.search",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "query": "machine learning tutorial",
      "limit": 50
    },
)

const run = await sr.run("youtube/video.search", {
  query: "machine learning tutorial",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "video.search",
  "query": "machine learning tutorial",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "title": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "profile_url": "https://www.youtube.com/watch?v=To88L1dRF2o",
      "source": "youtube",
      "extracted_at": "2026-07-16T08:54:44.200Z",
      "video_id": "To88L1dRF2o",
      "video_type": "video",
      "description": "⚙️ *TRY OXYLABS AI STUDIO*\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing...",
      "date_posted": "2026-07-10T16:00:03.000Z",
      "duration": "00:06:49",
      "thumbnail": "https://i.ytimg.com/vi/To88L1dRF2o/maxresdefault.jpg",
      "views": 151,
      "likes": 5,
      "num_comments": 0,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "hashtags": [
        "#WebScraping",
        "... 2 more"
      ],
      "channel_id": "UCvVIcCb6kpeSVyRkZjGowQw",
      "channel_name": "Oxylabs",
      "channel_url": "https://www.youtube.com/@oxylabs",
      "channel_username": "oxylabs",
      "channel_subscribers": 13600,
      "translated_title": "AI Web Scraping Tutorial: Scrape Any Site With AI",
      "translated_text": "⚙️ TRY OXYLABS AI STUDIO\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing c...",
      "description_links": [
        {
          "text": "https://oxy.yt/JnXr",
          "url": "https://oxy.yt/JnXr"
        },
        "... 26 more"
      ],
      "collaborators": [],
      "source_url": "https://www.youtube.com/results?search_query=web+scraping+tutorials&sp=CAISBggEEAEgAQ%3D%3D",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

Search YouTube videos from a free-text query. The response is normalized, so it keeps the same shape whichever offer served it. The call is synchronous and comes back completed or failed. Body fields and error codes shared by every service are documented on Run a service.

Body

string[]

required

The search queries to run, as queries (array) or query (single string). Free text, exactly as you would type it on YouTube.

string

Single-input form of queries.

number

default:"100"

Maximum number of records to return. Integer, 1-250.

string

Pin one offer, as source/name. Serving this service: apify/streamers. Omit it (the default) to let the router walk the failover chain.

object

Typed options for this service. Validation is strict, so an unknown key or an out-of-enum value returns a corrective 400 instead of being dropped.

Hide options

string

Result ordering, as the YouTube UI names it (e.g. relevance, date, views).

string

Restrict to a video type (e.g. video, movie).

string

Video length filter (e.g. under4, between420, over20).

boolean

Only HD videos.

boolean

Only videos with subtitles.

boolean

Only Creative Commons videos.

boolean

Only 3D videos.

boolean

Only live streams.

boolean

Only 4K videos.

boolean

Only 360° videos.

boolean

Only geotagged videos.

boolean

Only HDR videos.

boolean

Only VR180 videos.

string

Upload date filter (e.g. hour, today, week, month, year).

Accepted queries

Free-text search query, as you would type it in the YouTube search bar. Example: machine learning tutorial.

Offers

One offer serves this endpoint today. When a second one implements it, failover turns on with no change on your side.

Offer	Inputs per call
`apify/streamers`	50

Prices are live in the catalogue: GET /v1/services/youtube/video.search. See Credits for how a call is billed.

Response

data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge. The example response is a real run with values shortened for readability. A field is present when YouTube exposes it for that item, so the exact set varies record to record.

curl -X POST https://api.socialrouter.io/v1/youtube/video.search \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "machine learning tutorial",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/video.search",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      query: "machine learning tutorial",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/video.search",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "query": "machine learning tutorial",
      "limit": 50
    },
)

const run = await sr.run("youtube/video.search", {
  query: "machine learning tutorial",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "video.search",
  "query": "machine learning tutorial",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "title": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "profile_url": "https://www.youtube.com/watch?v=To88L1dRF2o",
      "source": "youtube",
      "extracted_at": "2026-07-16T08:54:44.200Z",
      "video_id": "To88L1dRF2o",
      "video_type": "video",
      "description": "⚙️ *TRY OXYLABS AI STUDIO*\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing...",
      "date_posted": "2026-07-10T16:00:03.000Z",
      "duration": "00:06:49",
      "thumbnail": "https://i.ytimg.com/vi/To88L1dRF2o/maxresdefault.jpg",
      "views": 151,
      "likes": 5,
      "num_comments": 0,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "hashtags": [
        "#WebScraping",
        "... 2 more"
      ],
      "channel_id": "UCvVIcCb6kpeSVyRkZjGowQw",
      "channel_name": "Oxylabs",
      "channel_url": "https://www.youtube.com/@oxylabs",
      "channel_username": "oxylabs",
      "channel_subscribers": 13600,
      "translated_title": "AI Web Scraping Tutorial: Scrape Any Site With AI",
      "translated_text": "⚙️ TRY OXYLABS AI STUDIO\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing c...",
      "description_links": [
        {
          "text": "https://oxy.yt/JnXr",
          "url": "https://oxy.yt/JnXr"
        },
        "... 26 more"
      ],
      "collaborators": [],
      "source_url": "https://www.youtube.com/results?search_query=web+scraping+tutorials&sp=CAISBggEEAEgAQ%3D%3D",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

video.transcriptFetch the transcript of a YouTube video. Normalized JSON, one price per record, automatic failover across sources.

curl -X POST https://api.socialrouter.io/v1/youtube/video.search \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "machine learning tutorial",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/video.search",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      query: "machine learning tutorial",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/video.search",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "query": "machine learning tutorial",
      "limit": 50
    },
)

const run = await sr.run("youtube/video.search", {
  query: "machine learning tutorial",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "video.search",
  "query": "machine learning tutorial",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "title": "AI Web Scraping: Full Tutorial for Beginners (2026)",
      "profile_url": "https://www.youtube.com/watch?v=To88L1dRF2o",
      "source": "youtube",
      "extracted_at": "2026-07-16T08:54:44.200Z",
      "video_id": "To88L1dRF2o",
      "video_type": "video",
      "description": "⚙️ *TRY OXYLABS AI STUDIO*\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing...",
      "date_posted": "2026-07-10T16:00:03.000Z",
      "duration": "00:06:49",
      "thumbnail": "https://i.ytimg.com/vi/To88L1dRF2o/maxresdefault.jpg",
      "views": 151,
      "likes": 5,
      "num_comments": 0,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "hashtags": [
        "#WebScraping",
        "... 2 more"
      ],
      "channel_id": "UCvVIcCb6kpeSVyRkZjGowQw",
      "channel_name": "Oxylabs",
      "channel_url": "https://www.youtube.com/@oxylabs",
      "channel_username": "oxylabs",
      "channel_subscribers": 13600,
      "translated_title": "AI Web Scraping Tutorial: Scrape Any Site With AI",
      "translated_text": "⚙️ TRY OXYLABS AI STUDIO\n👉 https://oxy.yt/JnXr  \n\nEver wondered how people pull data from websites without writing c...",
      "description_links": [
        {
          "text": "https://oxy.yt/JnXr",
          "url": "https://oxy.yt/JnXr"
        },
        "... 26 more"
      ],
      "collaborators": [],
      "source_url": "https://www.youtube.com/results?search_query=web+scraping+tutorials&sp=CAISBggEEAEgAQ%3D%3D",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

Services

Catalogue

Account

LinkedIn

Instagram

X

Reddit

Facebook

TikTok

YouTube

Pinterest

Bluesky

Snapchat

Google Maps

Body

Accepted queries

Offers

Response

​Body

​Accepted queries

​Offers

​Response

Body

Accepted queries

Offers

Response