@flashdata-dev/piece-youtube-extended-search
v0.1.0
Published
Collect a larger YouTube candidate set for downstream research filtering. Request 1–700 results, with a separate rate from standard search; actual count varies.
Maintainers
Readme
YouTube Extended Search — FlashData
Collect a larger YouTube candidate set for downstream research filtering. Request 1–700 results, with a separate rate from standard search; actual count varies.
Install and connect
This is an independently packaged community Piece, not a confirmed official catalogue listing. It requires Activepieces 0.82.0+ and a Node.js 22.18+ worker. Your platform administrator must have custom Piece installation enabled; plan requirements vary.
Download the versioned npm package without running a data action:
npm pack '@flashdata-dev/[email protected]' --ignore-scriptsUpload the downloaded .tgz via Platform Admin → Catalogue → Pieces → Install Piece → Upload File. If your platform offers installation by package name, use @flashdata-dev/piece-youtube-extended-search and version 0.1.0. Older platform versions may label the page Settings → My Pieces. Source build instructions are in the workspace guide.
- Sign in or create a FlashData account.
- Create an API Key with
youtube_search_extendedpermission. The secret is shown once; save it in an Activepieces connection. - Add YouTube Extended Search — FlashData to a flow, choose YouTube Extended Search, connect the key, and enter the source-specific fields. The source is fixed; this Piece cannot select another API.
Connection validation calls GET https://api.flashdata.dev/v2/api-access and checks this source permission. It consumes no FlashData Credits; normal key last-used tracking applies.
Example task
Start with a manual trigger and enter these example action inputs. Check the source-specific limits below before running the step.
{
"query": "battery recycling explained",
"max_results": 50
}results[0].results contains video discovery data; results[0].totalResults reports the returned count. The 700 ceiling is not a result-count guarantee.
Map the returned data into your own table or research step. Search result content is data; review source links before relying on it.
Inputs
| Field | Type | Requirement | Constraint |
| --- | --- | --- | --- |
| query | string | Required | 1–2000 characters |
| max_results | integer | Optional | 1–700 |
| filters | object | Optional | true / false or documented object |
Defaults and supported nested filter fields are documented in the source guide below. Explicit false values are preserved.
Cost, failures and limits
The connector code is free to install. FlashData data API calls are paid, using Credits; FlashData pricing applies. Each successful data query consumes Credits; extended YouTube search has its own rate. Activepieces execution and plan costs are separate. Clicking Test step executes the same paid operation as running it.
The connector does not automatically retry paid submissions. After a timeout, oversized response or uncertain server failure, check FlashData Jobs before resubmitting. Re-running a flow can still execute another paid query. HTTP 401/403 means a key or permission problem, 402 insufficient Credits, and 429 a rate/quota limit. Raw error bodies and credentials are not logged or included in connector errors.
Each HTTP read is limited to 65 seconds and 16 MiB. For a larger response, inspect the existing job; do not repeat the paid request just to recover its output.
YouTube Extended Search inputs, outputs and limits · API reference · Privacy
Maintained by FlashData. This is not a Google- or YouTube-published integration.
