YouTube Channel Finder by Topic or Niche (AI)
Pricing
$120.00 / 1,000 channels
Describe the channels you want, like "US channels reviewing budget espresso machines," and get YouTube creators ranked by content match. Semantic search across 200M channels.
You can access the YouTube Channel Finder by Topic or Niche (AI) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.0", "x-build-id": "oputzyC60OQpjUIAo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataovercoffee~youtube-channel-finder-by-topic/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataovercoffee-youtube-channel-finder-by-topic", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dataovercoffee~youtube-channel-finder-by-topic/runs": { "post": { "operationId": "runs-sync-dataovercoffee-youtube-channel-finder-by-topic", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dataovercoffee~youtube-channel-finder-by-topic/run-sync": { "post": { "operationId": "run-sync-dataovercoffee-youtube-channel-finder-by-topic", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "query" ], "properties": { "query": { "title": "Describe the channels you want", "minLength": 1, "maxLength": 512, "type": "string", "description": "Describe the channels you want in plain English. A full sentence beats a single word, and six things move the results: topic, audience, format, country, language and size — for example \"home espresso and coffee gear reviewers in the US\" or \"personal finance channels for people in their 20s in the US\". Any language works, and you can ask for creators who post in a given language. Constraints you state here become real filters and the run tells you which ones it applied; anything you set in the fields below wins over your sentence." }, "limit": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of channels to return.", "default": 10 }, "min_subscribers": { "title": "Min Subscribers", "type": "integer", "description": "Only include channels with at least this many subscribers." }, "max_subscribers": { "title": "Max Subscribers", "type": "integer", "description": "Only include channels with at most this many subscribers." }, "min_avg_views_videos": { "title": "Min Avg Views (Videos)", "type": "integer", "description": "Minimum average view count across the channel's recent videos." }, "max_avg_views_videos": { "title": "Max Avg Views (Videos)", "type": "integer", "description": "Maximum average view count across the channel's recent videos." }, "min_avg_views_shorts": { "title": "Min Avg Views (Shorts)", "type": "integer", "description": "Minimum average view count across the channel's recent shorts." }, "max_avg_views_shorts": { "title": "Max Avg Views (Shorts)", "type": "integer", "description": "Maximum average view count across the channel's recent shorts." }, "min_total_views": { "title": "Min Total Views", "type": "integer", "description": "Only include channels with at least this many total views." }, "max_total_views": { "title": "Max Total Views", "type": "integer", "description": "Only include channels with at most this many total views." }, "min_total_videos": { "title": "Min Total Videos", "type": "integer", "description": "Only include channels with at least this many published videos." }, "max_total_videos": { "title": "Max Total Videos", "type": "integer", "description": "Only include channels with at most this many published videos." }, "countries": { "title": "Include Countries", "type": "array", "description": "Only include channels from these countries.", "items": { "type": "string", "enum": [ "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua & Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia & Herzegovina", "Botswana", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Cayman Islands", "Chile", "China", "Colombia", "Congo - Brazzaville", "Congo - Kinshasa", "Costa Rica", "Côte d’Ivoire", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands (Islas Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Malta", "Marshall Islands", "Martinique", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar (Burma)", "Namibia", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Nigeria", "Norfolk Island", "North Korea", "North Macedonia", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Réunion", "Romania", "Russia", "Rwanda", "São Tomé & Príncipe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Georgia & South Sandwich Islands", "South Korea", "Spain", "Sri Lanka", "St Helena", "St Kitts & Nevis", "St Lucia", "St Pierre & Miquelon", "St Vincent & the Grenadines", "Svalbard & Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Trinidad & Tobago", "Tunisia", "Türkiye", "Turks & Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "US Outlying Islands", "US Virgin Islands", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis & Futuna", "Yemen", "Zambia", "Zimbabwe" ] } }, "exclude_countries": { "title": "Exclude Countries", "type": "array", "description": "Exclude channels from these countries.", "items": { "type": "string", "enum": [ "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua & Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia & Herzegovina", "Botswana", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Cayman Islands", "Chile", "China", "Colombia", "Congo - Brazzaville", "Congo - Kinshasa", "Costa Rica", "Côte d’Ivoire", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands (Islas Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Malta", "Marshall Islands", "Martinique", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar (Burma)", "Namibia", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Nigeria", "Norfolk Island", "North Korea", "North Macedonia", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Réunion", "Romania", "Russia", "Rwanda", "São Tomé & Príncipe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Georgia & South Sandwich Islands", "South Korea", "Spain", "Sri Lanka", "St Helena", "St Kitts & Nevis", "St Lucia", "St Pierre & Miquelon", "St Vincent & the Grenadines", "Svalbard & Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Trinidad & Tobago", "Tunisia", "Türkiye", "Turks & Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "US Outlying Islands", "US Virgin Islands", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis & Futuna", "Yemen", "Zambia", "Zimbabwe" ] } }, "only_verified": { "title": "Verified Only", "type": "boolean", "description": "Only include channels that have YouTube's verified badge.", "default": false }, "only_has_email": { "title": "Has Public Email Only", "type": "boolean", "description": "Only include channels that have a public business email on their about page. Great for influencer outreach.", "default": false }, "only_family_friendly": { "title": "Family Friendly Only", "type": "boolean", "description": "Only include channels marked as family-friendly by YouTube.", "default": false }, "exclude_channel_ids": { "title": "Exclude Channel IDs", "maxItems": 500000, "type": "array", "description": "List of YouTube channel IDs to exclude from results. Use this to avoid getting channels you already have from previous runs. Channel IDs only here — a URL or an @handle cannot be matched against this list. If the list contains one, the run stops without searching and shows you how many rows are wrong plus a few examples, so you are never charged for results you asked to exclude. Maximum 500,000.", "items": { "type": "string" } }, "gender": { "title": "Creator gender", "enum": [ "female", "male", "nonbinary_or_unstated" ], "type": "string", "description": "Only creators of this gender. Estimated from public channel details, not self-reported." }, "primary_language": { "title": "Main language", "type": "array", "description": "The channel's main language. Pick several to match a channel whose main language is any of them.", "items": { "type": "string", "enum": [ "en", "hi", "es", "pt", "id", "ja", "ar", "bn", "ms", "ru", "fr", "ko", "mr", "de", "zh", "vi", "tr", "th", "ta", "te", "it", "ml", "ur", "pl", "uk", "gu", "or", "fa", "pa", "si", "tl", "kn", "ne", "ro", "nl", "bh", "su", "km", "uz", "am", "da", "az", "cs", "arz", "hu", "as", "el", "my", "fi", "sr", "sv", "hr", "he", "sq", "sh", "pnb", "no", "bg", "kk", "sw", "ca", "hy", "sk", "gl", "ckb", "sl", "eo", "sa", "ka", "et", "ky", "new", "lt", "bs", "mn", "cy", "tg", "ps", "ceb", "ku", "so", "la", "lv", "bpy", "eu", "fy", "ht", "af", "sd", "ast", "sco", "bo", "mk", "lo", "war", "ba", "nds", "jv", "lb", "oc", "azb", "be", "br", "mai", "nn", "tt", "mt", "yi", "gom", "tk", "gd", "ce", "mzn", "ga", "als", "is", "ia", "mg", "ilo", "sah", "io", "pms", "min", "bcl", "ug", "jbo", "pam", "dv", "vo", "cv", "kw", "yo", "dty", "qu", "ie", "xmf", "an", "wa", "krc", "bar", "mhr", "rm", "diq", "lez", "lmo", "av", "scn", "hif", "os", "eml", "xal", "lrc", "sc", "hsb", "mwl", "bxr", "cbk", "nah", "wuu", "frr", "gv", "yue", "gn", "li", "nap", "vls", "mrj", "co", "kv", "myv", "tyv", "vep", "vec" ], "enumTitles": [ "English (en)", "Hindi (hi)", "Spanish (es)", "Portuguese (pt)", "Indonesian (id)", "Japanese (ja)", "Arabic (ar)", "Bengali (bn)", "Malay (ms)", "Russian (ru)", "French (fr)", "Korean (ko)", "Marathi (mr)", "German (de)", "Chinese (zh)", "Vietnamese (vi)", "Turkish (tr)", "Thai (th)", "Tamil (ta)", "Telugu (te)", "Italian (it)", "Malayalam (ml)", "Urdu (ur)", "Polish (pl)", "Ukrainian (uk)", "Gujarati (gu)", "Odia (or)", "Persian (fa)", "Punjabi (pa)", "Sinhala (si)", "Tagalog (tl)", "Kannada (kn)", "Nepali (ne)", "Romanian (ro)", "Dutch (nl)", "Bhojpuri (bh)", "Sundanese (su)", "Khmer (km)", "Uzbek (uz)", "Amharic (am)", "Danish (da)", "Azerbaijani (az)", "Czech (cs)", "Egyptian Arabic (arz)", "Hungarian (hu)", "Assamese (as)", "Greek (el)", "Burmese (my)", "Finnish (fi)", "Serbian (sr)", "Swedish (sv)", "Croatian (hr)", "Hebrew (he)", "Albanian (sq)", "Serbo-Croatian (sh)", "Western Punjabi (pnb)", "Norwegian (no)", "Bulgarian (bg)", "Kazakh (kk)", "Swahili (sw)", "Catalan (ca)", "Armenian (hy)", "Slovak (sk)", "Galician (gl)", "Central Kurdish (ckb)", "Slovenian (sl)", "Esperanto (eo)", "Sanskrit (sa)", "Georgian (ka)", "Estonian (et)", "Kyrgyz (ky)", "Newari (new)", "Lithuanian (lt)", "Bosnian (bs)", "Mongolian (mn)", "Welsh (cy)", "Tajik (tg)", "Pashto (ps)", "Cebuano (ceb)", "Kurdish (ku)", "Somali (so)", "Latin (la)", "Latvian (lv)", "Bishnupriya (bpy)", "Basque (eu)", "West Frisian (fy)", "Haitian Creole (ht)", "Afrikaans (af)", "Sindhi (sd)", "Asturian (ast)", "Scots (sco)", "Tibetan (bo)", "Macedonian (mk)", "Lao (lo)", "Waray (war)", "Bashkir (ba)", "Low German (nds)", "Javanese (jv)", "Luxembourgish (lb)", "Occitan (oc)", "South Azerbaijani (azb)", "Belarusian (be)", "Breton (br)", "Maithili (mai)", "Norwegian Nynorsk (nn)", "Tatar (tt)", "Maltese (mt)", "Yiddish (yi)", "Konkani (gom)", "Turkmen (tk)", "Scottish Gaelic (gd)", "Chechen (ce)", "Mazanderani (mzn)", "Irish (ga)", "Alemannic (als)", "Icelandic (is)", "Interlingua (ia)", "Malagasy (mg)", "Ilocano (ilo)", "Yakut (sah)", "Ido (io)", "Piedmontese (pms)", "Minangkabau (min)", "Bikol (bcl)", "Uyghur (ug)", "Lojban (jbo)", "Kapampangan (pam)", "Dhivehi (dv)", "Volapuk (vo)", "Chuvash (cv)", "Cornish (kw)", "Yoruba (yo)", "Doteli (dty)", "Quechua (qu)", "Interlingue (ie)", "Mingrelian (xmf)", "Aragonese (an)", "Walloon (wa)", "Karachay-Balkar (krc)", "Bavarian (bar)", "Meadow Mari (mhr)", "Romansh (rm)", "Zazaki (diq)", "Lezgian (lez)", "Lombard (lmo)", "Avar (av)", "Sicilian (scn)", "Fiji Hindi (hif)", "Ossetian (os)", "Emilian-Romagnol (eml)", "Kalmyk (xal)", "Northern Luri (lrc)", "Sardinian (sc)", "Upper Sorbian (hsb)", "Mirandese (mwl)", "Buryat (bxr)", "Chavacano (cbk)", "Nahuatl (nah)", "Wu Chinese (wuu)", "North Frisian (frr)", "Manx (gv)", "Cantonese (yue)", "Guarani (gn)", "Limburgish (li)", "Neapolitan (nap)", "West Flemish (vls)", "Hill Mari (mrj)", "Corsican (co)", "Komi (kv)", "Erzya (myv)", "Tuvan (tyv)", "Veps (vep)", "Venetian (vec)" ] }, "default": [] }, "subject_type": { "title": "Channel is run by", "enum": [ "person", "brand_or_org" ], "type": "string", "description": "Whether the channel is run by an individual or by a brand/organisation." }, "only_monetized": { "title": "Only creators monetizing off-YouTube", "type": "boolean", "description": "Earns money outside YouTube ads.", "default": false }, "only_not_monetized": { "title": "Only creators NOT yet monetizing off-YouTube", "type": "boolean", "description": "No sign of earning outside YouTube ads.", "default": false }, "only_with_sponsorships": { "title": "Only creators with sponsorship history", "type": "boolean", "description": "Has run brand deals or affiliate promotions.", "default": false }, "only_without_sponsorships": { "title": "Only creators with NO sponsorship history", "type": "boolean", "description": "No brand deals or affiliate promotions found.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for YouTube Channel Finder by Topic or Niche (AI) from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: