EveryData platform API
YouTube API
Use YouTube for YouTube videos, channels, comments, Shorts, subscriber counts, and available transcripts only through the 8 listed contracts, such as `search`, `profile`, `user_posts`, because one view does not inherit another view’s reach.
For matching public results, use YouTube action `search` with `keyword`; for the selected YouTube record, switch to `profile` and `url`, rather than carrying parameters across.
- Endpoint
- POST /api/v1/social
- Capabilities
- 8
- Per 1,000
- $0.556
Available capabilities
Compare the YouTube actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on YouTube. Accepts these parameters: | keyword | sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform |
profileChannel details Retrieve channel details from YouTube. Accepts these parameters: | url | since, sort | Sync delivery | — | $0.56 per 1,000 requests | channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform |
user_postsPosts by user Retrieve public posts from YouTube. Accepts these parameters: | url | since, sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform |
videoVideo details Retrieve a public video from YouTube. Accepts these parameters: | url | date_range, duration, since, sort | Sync delivery | — | $0.56 per 1,000 requests | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform |
commentsComments Retrieve public comments from YouTube. Accepts these parameters: | url | since, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform |
followersFollowers Retrieve public follower metrics from YouTube. Accepts these parameters: | username | channel | Sync delivery | — | $0.56 per 1,000 requests | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcriptTranscript Retrieve a video transcript from YouTube. Accepts these parameters: | url | language, since, until | Sync delivery | — | $0.56 per 1,000 requests | id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform · start · duration |
shortsShorts Retrieve Shorts from YouTube. Accepts these parameters: | username | channel, since, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform |
What does each YouTube action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the YouTube search parameters mean?
Search public results on YouTube. Accepts these parameters: sort and keyword. Returns these fields: author_username, like_count, author_name, and author_url.
keywordRequired- The search query term for the YouTube search action. If passed to compatibility inputs for the shorts action, this parameter acts as a channel name rather than initiating a site-wide Shorts search.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
most_viewednewestrelevancetop_rated
What do the YouTube profile parameters mean?
Retrieve channel details from YouTube. Accepts these parameters: sort, url, and since. Returns these fields: created_at, banner_url, avatar_url, and is_verified.
urlRequired- The target URL required by YouTube actions. Use full channel URLs for profile and user_posts, or specific watch?v= and share links for video, comments, and transcript. Channel metadata is derived from published content, and comments does not return channel community board posts.
sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
newestoldestpopular
What do the YouTube user_posts parameters mean?
Retrieve public posts from YouTube. Accepts these parameters: since, sort, and url. Returns these fields: title, view_count, like_count, and posted_at.
urlRequired- The target URL required by YouTube actions. Use full channel URLs for profile and user_posts, or specific watch?v= and share links for video, comments, and transcript. Channel metadata is derived from published content, and comments does not return channel community board posts.
sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
newestoldestpopular
What do the YouTube video parameters mean?
Retrieve a public video from YouTube. Accepts these parameters: date_range, url, since, sort, and duration. Returns these fields: title, view_count, author_id, and text.
urlRequired- The target URL required by YouTube actions. Use full channel URLs for profile and user_posts, or specific watch?v= and share links for video, comments, and transcript. Channel metadata is derived from published content, and comments does not return channel community board posts.
date_rangeOptional- The publication window for video discovery. Accepted values are last_hour, today, this_week, this_month, and this_year. Filtering behavior is not verified when targeting a single fixed video.Allowed values:
last_hourthis_monththis_weekthis_yeartoday durationOptional- Filters videos by length classification using under_4_minutes, 4_20_minutes, or over_20_minutes. This parameter does not set transcript response length or API timeouts, and its effect on single-video queries is unverified.Allowed values:
4_20_minutesover_20_minutesunder_4_minutes sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
most_viewednewestrelevancetop_rated
What do the YouTube comments parameters mean?
Retrieve public comments from YouTube. Accepts these parameters: url, since, and sort. Returns these fields: author_name, is_reply, reply_to_id, and text.
urlRequired- The target URL required by YouTube actions. Use full channel URLs for profile and user_posts, or specific watch?v= and share links for video, comments, and transcript. Channel metadata is derived from published content, and comments does not return channel community board posts.
sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
newestpopular
What do the YouTube followers parameters mean?
Retrieve public follower metrics from YouTube. Accepts these parameters: username and channel. Returns these fields: follower_count, following_count, connection_count, and like_count.
usernameRequired- The channel handle (optional leading @) required by the followers and shorts actions. The followers action returns aggregate subscriber counts rather than user lists. The shorts action prioritizes handles and does not treat UC... channel IDs as identical identifiers.YouTube: Understanding Channel HandlesYouTube defines a handle as a unique channel identifier starting with @, which is distinct from the channel display name.Checked
channelOptional- A compatibility alias for specifying a channel handle. Full /channel/UC... URLs may fail to parse across helper utilities, so prefer passing a handle or using the URL parameter explicitly provided by the action.
What do the YouTube transcript parameters mean?
Retrieve a video transcript from YouTube. Accepts these parameters: language, until, url, and since. Returns these fields: duration, text, segments, and available_languages.
urlRequired- The target URL required by YouTube actions. Use full channel URLs for profile and user_posts, or specific watch?v= and share links for video, comments, and transcript. Channel metadata is derived from published content, and comments does not return channel community board posts.
languageOptional- The requested language code for transcript content. Subtitles are returned based on available tracks; automatic translation and universal enforcement across all execution paths are not guaranteed.
sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
untilOptional- An optional upper date bound for transcript requests. When submitting a single video URL, this parameter is not verified to trim video playback or truncate subtitle timestamps, and it must not be used as an end-time offset in seconds.
What do the YouTube shorts parameters mean?
Retrieve Shorts from YouTube. Accepts these parameters: username, since, channel, and sort. Returns these fields: author_url, author_id, author_name, and posted_at.
usernameRequired- The channel handle (optional leading @) required by the followers and shorts actions. The followers action returns aggregate subscriber counts rather than user lists. The shorts action prioritizes handles and does not treat UC... channel IDs as identical identifiers.YouTube: Understanding Channel HandlesYouTube defines a handle as a unique channel identifier starting with @, which is distinct from the channel display name.Checked
channelOptional- A compatibility alias for specifying a channel handle. Full /channel/UC... URLs may fail to parse across helper utilities, so prefer passing a handle or using the URL parameter explicitly provided by the action.
sinceOptional- The lower date bound for filtering channel videos, Shorts, or comments. Whether this filter applies when passed to single-video or transcript actions remains unconfirmed.
sortOptional- The sort order applied across YouTube actions. For search, accepted values are relevance, newest, most_viewed, and top_rated. For channel videos and Shorts, accepted values are newest, oldest, and popular. For comments, accepted values are newest and popular. Specifying this parameter on a single-video query does not filter that video's content.Allowed values:
newestoldestpopular
How to use the YouTube API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"youtube","action":"search","params":{"keyword":"<keyword>"}}'
YouTube API questions
What can I retrieve with the YouTube API?
Set platform to youtube. The current catalog lists search, channel details, posts by user, video details, comments, and more. These action names identify different YouTube objects or views; they are not interchangeable search modes.
Which input starts a YouTube `search` request?
The search query term for the YouTube search action. If passed to compatibility inputs for the shorts action, this parameter acts as a channel name rather than initiating a site-wide Shorts search. Send it as keyword inside params.
Which fields can YouTube `search` return?
Its declared schema includes title, text, author_name, and author_username. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every YouTube action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.