Actions40
- Account Actions
- Channel Actions
- Instagram Actions
- Job Actions
- Keyword Actions
- Studio & AI Actions
- Trend Actions
- Video Actions
Channel → Search
AI-generatedSummary
Search for channels matching filter criteria
Inputs
- query — Free-text query to search channels by
- channelType — Type of channel content to filter by
- country — ISO 3166-1 alpha-2 country codes, comma-separated (e.g. US, GB, DE)
- languages — ISO 639-1 language codes, comma-separated (e.g. en, es)
- subscriberCountMin — Minimum subscriber count to include
- subscriberCountMax — Maximum subscriber count to include
- viewCountMin — Minimum total view count to include
- viewCountMax — Maximum total view count to include
- videoCountMin — Minimum video count to include
- videoCountMax — Maximum video count to include
- faceless — Whether to only include faceless channels
- breakoutChannel — Whether to only include breakout channels
- sort — Field to sort the search results by
- limit — Max number of results to return
- additionalFilters — Additional long-tail filters for channel search
- options — Timeout in milliseconds to wait for vidIQ before the request fails (prevents a stalled request from hanging)
Output shape
An array of channel objects
Returns up to limit items; may include additional metadata; no pagination wrapper
Examples
Example 1: Search for gaming channels in the US with at least 10k subscribers sorted by relevance, returning 20 results
query: "gaming", country: "US", subscriberCountMin: 10000, sort: "relevance", limit: 20
Example 2: Find faceless education channels in English with recent video activity
faceless: true, languages: "en", sort: "lastVideoPublished"
Example 3: Get breakout channels in Gaming with subscriber growth >5% over 30 days
breakoutChannel: true, sort: "subsGrowth30d", additionalFilters: {"channelTitle": "Gaming", "channelTitleMatch": "exact"}