FR

YouTube Keyword Search

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

Source · en-USRevenir à la traduction

Développeur
Tarifs
À partir de 0,003 $US / 20 enregistrements
Dernière mise à jour
2026-10-16

Aperçu

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.

Périmètre et limites

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.

  • Adapté pour
  • 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.
  • À ne pas utiliser pour
  • 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.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  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.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

  • Search keywordkeywordRequisstring
    Brand, product, topic, or phrase to search on YouTube. Each task accepts one keyword from 1 to 512 characters.
    ExempleShokz
  • Expected result countcrawl_countRequisinteger
    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.
    Plage1–600Exemple1
  • Publish time rangetime_rangeFacultatifstring(enum)
    Select the publish time range for the search results: today, this week, this month, or this year. Defaults to this month when omitted.
    Valeurs possiblesTodaytodayThis weekweekThis monthmonthThis yeartoyearDéfautmonth
  • Result prioritypriority_filterFacultatifstring(enum)
    Choose relevance or hottest content as the collection priority. Defaults to relevance; returned rows remain ordered by publish time, newest first.
    Valeurs possiblesRelevancerelevanceHottesthotDéfautrelevance

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

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

Exemple de données

Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.

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
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

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>" }
    }
  }
}

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)

detail.access.mcp.composeHint

Tarifs

20 returned records

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 20 enregistrements ; toute unité incomplète est arrondie à 20 enregistrements.

0,003 $US/ 20 enregistrements
Per task submitted

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
À partir de 0,003 $US / 20 enregistrements