EN

YouTube Keyword Search

Give one YouTube search keyword and an expected count to get matching public videos, channels, view counts, and publish times.

Developer
Pricing
From $0.003 / 20 records
Last updated
2026-10-16

Overview

YouTube search brings together videos from different creators around a brand, product, or topic. This app collects public search listings into a table so you can compare titles, channels, publishing times, durations, and viewing figures without assembling each listing by hand.

Keeping the search keyword beside every video gives content research a consistent reference point. Teams can compare the creators and topics appearing for a query, review the material behind a campaign, and keep links to the original videos for closer inspection.

Data notes

Each row represents a public YouTube search listing. Publish time range and Result priority determine which content is selected for collection. Returned rows are ordered by Published at, newest first, and repeated Video IDs are kept only once.

View count, Subscriber count, and Duration ms retain the text supplied by the source. Display duration preserves the visible duration, while Display published preserves the original relative-time wording. Published at and Collected at have no stated timezone. Image, badge, and Video summary information retains the supplied text representation.

Channel details, co-creator information, and summaries may be empty. An empty value means the source did not supply that information; it does not mean zero subscribers or a negative certification result. Coverage is limited to public search listings. Comments, transcripts, private videos, and information absent from the listing are outside this dataset.

What a result looks like

Each row describes one public video listing returned for the keyword:

Video titleChannel nameVideo URLView countPublished atDisplay duration
PACK WITH ME: MALDIVES! 🧳🌴 2-week beach holiday, long-haul flight essentials & how I pack it all 👙Brogan Tatehttps://www.youtube.com/watch?v=AVHljwcqB7s115412026-10-16T01:22:3637:48
Shokz OpenFit Pro Review: I Put Them Through a Hybrid WorkoutGritty Soldierhttps://www.youtube.com/watch?v=AWkCGpRAdcM36492026-10-15T23:22:3610:36

The dataset also includes Video ID, Channel ID, Channel handle, Account badges, Channel description, Subscriber count, and Video summary when the source supplies them.

Use cases

  • For brand research, compare Keyword, Video title, and Channel name to identify the creators and topics appearing for a query.
  • For competitor monitoring, compare Published at, View count, and Verified channel to review recent content and its visible audience response.
  • For content planning, read Video title alongside Video description, Video summary, and Display duration to compare themes and formats.
  • For creator research, combine Channel handle, Channel URL, and Subscriber count, then follow Video URL to inspect the original material.

Scope and boundaries

One YouTube search keyword per task with an expected result count from 1 to 600; results are returned in complete batches of 20 and may be rounded up; coverage is limited to public YouTube keyword search listings, and the platform returns at most 600 videos.

  • Good for
  • When you need public YouTube search listings for one keyword, including video titles, channels, view counts, and publish times.
  • When you need to compare how competing videos appear for the same search keyword.
  • Do not use for
  • When you need comments, transcripts, or a full channel homepage — this App only returns keyword search listings.
  • When you need private, unlisted, or signed-in YouTube data — this App covers public search results only.

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1If no videos are returned, try a broader or more common keyword and confirm the query is searchable on public YouTube.
  2. 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  3. 3Retry later after rate limiting, temporary unavailability, or a timeout.
  4. 4If authentication fails, verify the API Key configured for the execution environment.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Search keywordkeywordRequiredstring
    Brand, product, topic, or phrase to search on YouTube. Each task accepts one keyword from 1 to 512 characters.
    ExampleShokz
  • Expected result countcrawl_countRequiredinteger
    Expected number of videos, from 1 to 600. Results are returned in complete batches of 20, so the actual count may be rounded up. A partial batch is still billed as 20 videos.
    Range1–600Example1
  • Publish time rangetime_rangeOptionalstring(enum)
    Select the publish time range for the search results: today, this week, this month, or this year. Defaults to this month when omitted.
    Allowed valuesTodaytodayThis weekweekThis monthmonthThis yeartoyearDefaultmonth
  • Result prioritypriority_filterOptionalstring(enum)
    Choose relevance or hottest content as the collection priority. Defaults to relevance; returned rows remain ordered by publish time, newest first.
    Allowed valuesRelevancerelevanceHottesthotDefaultrelevance

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Account badgesaccount_badge_liststring
    Badge text shown on the channel, returned as JSON text when present. Null when not provided.
    Example["Verified"]
  • Channel handleaccount_display_idstring
    Public YouTube handle for the channel, including the @ prefix when shown. Null when not provided.
    Example@brogantatexo
  • Channel IDaccount_idstring
    Stable YouTube channel identifier for the publisher of this listing. Null when not provided.
    ExampleUCbk7poTBSh1x6aNg_IjLu9Q
  • Channel nameaccount_namestring
    Display name of the channel that published this listing. Null when not provided.
    ExampleBrogan Tate

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "account_badge_list": "[\"Verified\"]",
  "account_display_id": "@brogantatexo",
  "account_id": "UCbk7poTBSh1x6aNg_IjLu9Q",
  "account_name": "Brogan Tate",
  "article_type": "video",
  "biz_id": "Shokz",
  "channel_banner_url": "<channel_banner_url>",
  "channel_description": "<channel_description>",
  "channel_description_links": "<channel_description_links>",
  "channel_thumbnail_list": "[{\"height\": 68, \"url\": \"https://yt3.ggpht.com/p5mrXo8WXN1Jp7eoZCTgxODfWtE2oGOYu-5OMXrjTwxzbvnfj40PzEQZZz44gRqb0sPHb8rnJg=s68-c-k-c0x00ffffff-no-rj\", \"width\": 68}]",
  "channel_total_videos": "<channel_total_videos>",
  "channel_url": "<channel_url>",
  "co_creator_info": "<co_creator_info>",
  "content_badge_list": "[\"New\", \"4K\"]",
  "content_id": "AVHljwcqB7s",
  "content_rich_thumbnail_list": "<content_rich_thumbnail_list>",
  "content_status": "RUNNING",
  "content_text": "Welcome to my Maldives pack with me! We're spending 2 weeks exploring some of the best resorts, in partnership with ...",
  "content_title": "PACK WITH ME: MALDIVES! 🧳🌴 2-week beach holiday, long-haul flight essentials & how I pack it all 👙",
  "content_url": "https://www.youtube.com/watch?v=AVHljwcqB7s",
  "cover_image_list": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/AVHljwcqB7s/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDafd0r3K9Ai8G8i9ms4_dN7sOPWQ\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/AVHljwcqB7s/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAJk-jvivrEgKRoyb9Ni3XTMjbHtQ\", \"width\": 720}]",
  "crawl_time": "2026-10-16T14:22:36",
  "is_collaboration": false,
  "is_verified": true,
  "is_verified_artist": false,
  "keyword": "Shokz",
  "keyword_type": "keyword",
  "list_order": 0,
  "number_of_subscribers": "<number_of_subscribers>",
  "publish_time": "2026-10-16T01:22:36",
  "raw_duration": "37:48",
  "raw_publish_time": "13h ago",
  "video_duration": "2268000",
  "video_summary": "{\"summary\": \"Brogan Tate demonstrates effective organization strategies for a two-week tropical trip by categorizing clothing, tech, and toiletries into various packing cubes. These methods optimize luggage space for domestic transfers while ensuring all necessary travel essentials and camera gear are readily available for documenting the upcoming vacation across three different island resorts.\", \"title\": \"AI-generated video summary\"}",
  "view_count": "11541",
  "view_count_text": "11,541 views",
  "task_item": "Shokz",
  "no_data": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

detail.access.mcp.composeHint

Pricing

20 returned records

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 20 records; any partial unit is rounded up to 20 records.

$0.003/ 20 records
Per task submitted

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.003 / 20 records