YouTube Extended Search — FlashData

YouTube Extended Search — FlashData

Search larger YouTube video result sets, with up to 700 requested results. Map recurring channels and topics from structured video records.

API documentation and account setup · Get an API key · Current pricing

A task to try

Search for up to 100 YouTube videos about battery recycling. Group the returned videos by channel, count the observed videos per channel, and keep their watch links for review.

Install and connect

1. Use Node.js 22.18 or newer and an MCP client that supports local stdio servers. Download the dedicated MCPB package; its SHA-256 is recorded in the manifest.
2. Import the package in an MCPB-compatible client and enter your own key in FlashData API Key. Grant the key access to youtube_search_extended. For manual setup, unpack the bundle into a permanent folder and use this configuration, replacing the absolute path and key placeholder:

{
  "mcpServers": {
    "youtube-extended-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-extended-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Restart or reconnect the client, list its tools, then call get_pricing with {"source":"youtube_search_extended","request_count":1} before approving a paid request. This server exposes youtube_search_extended, get_pricing, get_job and get_result; all are restricted to this source.

Dependencies are included in the bundle. Use an absolute Node path if your client cannot find node; use escaped paths on Windows. Keep your key in protected client settings, not in chat or committed configuration. No Smithery account is needed for this direct package download.

Example request

These are MCP tools/call parameters with flat arguments. Running the data request uses paid Credits.

{
  "name": "youtube_search_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

Use the response

Read results[0].results and group by channelId or channelUrl. Keep the original video IDs and count observed results per channel; retain channel labels for review.

Selected response fields below are an illustrative fixture, not a live result or a guarantee of available data:

{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

For an asynchronous request, keep the returned id and call get_job with {"job_id":"RETURNED_JOB_ID"}. Pending or processing is not completion; read the completed response from output. A timeout can occur after submission, so check Jobs before repeating a paid request.

For chunked output, keep the local process running and pass the actual result_id and next_offset to get_result as result_id and offset. Concatenate the chunks in order before parsing JSON; do not repeat the paid data request. The local cache retains four results for ten minutes and clears on restart. Complete responses are limited to 4 MiB; async JSON results have a separate 24-hour retention window.

Cost and limits

• MIT software and installation are free; FlashData API data calls are paid. Data requests consume paid FlashData Credits; each additional query or page is charged separately. Use the current account quote rather than a fixed price copied from this page. Pricing, job and result reads are free. Client/model fees are separate.
• The request limit is 700, not a promise of 700 returned videos or pagination. Extended search has its own rate, higher than standard search.
• Check API errors, http_status and job status before using the data. Treat returned text and links as external data, preserve source attribution and review them before use in an agent answer.

Full task guide · Official Registry record · Source and license