Search YouTube

Search YouTube videos and channels.

Pricing: 0.5 credits per result returned ($0.005)

GET /v1/raw/youtube/search

cURL

cURL

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

import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.raw.youtube.search({ q: 'fitness workout' });

console.log(response.data);

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
response = client.raw.youtube.search(
    q="fitness workout",
)
print(response.data)

200

{
  "data": {
    "query": "<string>",
    "estimated_results": 1,
    "results": [
      {
        "type": "<string>",
        "video_id": "dQw4w9WgXcQ",
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "title": "<string>",
        "description": "<string>",
        "channel_id": "<string>",
        "channel_name": "<string>",
        "channel_handle": "<string>",
        "channel_verified": true,
        "thumbnail_url": "<string>",
        "duration_seconds": 1,
        "duration_text": "<string>",
        "view_count": 1,
        "view_count_text": "<string>",
        "published_text": "<string>",
        "published_at": "<string>"
      }
    ],
    "scraped_at": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key · string · header · required

Query Parameters

q · string · required

Search query

Required string length: 1 - 500

Example:

"fitness workout"

limit · integer · default: 20

Maximum number of results to return

Required range: 1 <= x <= 50

Example:

20

country_code · string · default: US

Country code for localized results (ISO 3166-1 alpha-2)

Required string length: 2

Example:

"US"

language_code · string · default: en

Language code for results

Required string length: 2 - 5

Example:

"en"

Response

200

application/json

Successful response

data · object · required

Show child attributes