# Company Domain to YouTube Channel Resolver (`automation-lab/company-domain-to-youtube-channel-resolver`) Actor Resolve company domains to official YouTube channel URLs with handles, confidence, evidence pages, and alternatives for lead enrichment. - **URL**: https://apify.com/automation-lab/company-domain-to-youtube-channel-resolver.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Company Domain to YouTube Channel Resolver Resolve company domains and websites to official YouTube channel URLs, handles, and evidence fields for B2B enrichment workflows. ### What does Company Domain to YouTube Channel Resolver do? Company Domain to YouTube Channel Resolver takes a list of company domains, website URLs, or company names and returns one enrichment row per input. It checks public company websites for YouTube links in footers, headers, HTML, meta content, and JSON-like page data. It then ranks the best channel candidate and returns the evidence source, matched text, confidence level, alternatives, and pages checked. ### Who is it for? - ๐Ÿงฉ RevOps teams enriching account lists before outreach. - ๐Ÿงฒ Clay users who need a stable company-to-YouTube column. - ๐Ÿค Partnership teams matching brands with video channels. - ๐Ÿ“ฃ Marketing teams auditing owned social profiles. - ๐Ÿงช Data teams validating social enrichment vendors. ### Why use this actor? Many enrichment tools miss public YouTube channels because the link is hidden in a footer, About page, Contact page, or JSON metadata. This actor is intentionally narrow: it resolves official YouTube channel URLs from company websites and keeps the evidence visible. ### Typical use cases - Add official YouTube channel URLs to a lead list. - Find brands with video presence before partnership outreach. - Audit whether a company website exposes the correct YouTube profile. - Build a repeatable Clay enrichment step without writing custom crawlers. - Compare official-site matches against search-only guesses. ### Data returned | Field | Description | | --- | --- | | `input` | Original domain, URL, or company name. | | `normalizedDomain` | Normalized domain when the input is a website. | | `companyName` | Name-only input when no domain was provided. | | `status` | `resolved`, `not_found`, or `failed`. | | `resolvedYoutubeUrl` | Best YouTube channel/profile URL found. | | `channelHandle` | YouTube `@handle` when present. | | `channelId` | YouTube channel ID when present. | | `confidence` | `high`, `medium`, `low`, or `none`. | | `evidenceSource` | Homepage, about, contact, company, social, search, or none. | | `evidenceUrl` | Page or search URL where the match was found. | | `matchedText` | Nearby page text around the matched URL. | | `alternativeCandidates` | Other YouTube candidates found. | | `pagesChecked` | Official pages and fallback URLs checked. | | `error` | Per-input failure details, if any. | | `crawledAt` | ISO timestamp for the enrichment row. | ### How much does it cost to resolve company domains to YouTube channels? This actor uses pay-per-event pricing. - A small start event covers run initialization. - A per-item event is charged for each output row. - Each input produces one output row, including `not_found` rows, so your export can be joined back to your source list. Final production prices are shown on the Apify Store pricing tab and in the actor input form. ### Input options #### domainsOrCompanyNames Add one company per line. Best results come from domains or website URLs, for example: ```json ["apify.com", "stripe.com", "https://www.microsoft.com/en-us/"] ```` Name-only inputs are supported primarily when search fallback is enabled. #### maxPagesPerDomain Controls how many public pages are checked per domain. The actor always starts with the homepage and then tries likely company pages such as About, Contact, Company, and Social pages. #### searchFallback When enabled, the actor tries a public search fallback after official-site crawling finds no YouTube link. Search fallback results are marked `low` confidence because they do not come directly from the company's website. #### language and country Optional hints for search fallback. #### requestTimeoutSecs HTTP timeout per page. Keep the default unless you are checking slow enterprise websites. ### Output example ```json { "input": "apify.com", "normalizedDomain": "apify.com", "status": "resolved", "resolvedYoutubeUrl": "https://www.youtube.com/apify", "confidence": "high", "evidenceSource": "homepage", "evidenceUrl": "https://apify.com/", "pagesChecked": ["https://apify.com/"], "crawledAt": "2026-06-24T06:55:29.423Z" } ``` ### How to run 1. Open the actor on Apify. 2. Paste domains, website URLs, or company names. 3. Keep `maxPagesPerDomain` at 3 for a quick first run. 4. Enable search fallback only when you want lower-confidence guesses. 5. Start the run. 6. Export the dataset to CSV, JSON, Excel, or connect it to your workflow. ### Confidence scoring High confidence means the link was found on the homepage of the official domain. Medium confidence means the link was found on an official subpage such as About, Contact, Company, or Social. Low confidence means the link came from search fallback. None means no usable channel candidate was found. ### What counts as a YouTube channel? The actor prioritizes profile-like YouTube URLs: - `youtube.com/@handle` - `youtube.com/channel/...` - `youtube.com/c/...` - `youtube.com/user/...` - brand YouTube profile URLs linked from a company site It filters common low-value video, embed, shorts, playlist, and iframe API URLs so a random embedded video is less likely to become the main result. ### Tips for best results - Use domains instead of company names whenever possible. - Keep search fallback off for compliance-sensitive enrichment. - Use `confidence = high` or `medium` when you only want official-site evidence. - Review `alternativeCandidates` when a brand has regional or product-specific channels. - Increase `maxPagesPerDomain` for large enterprise sites. ### Clay workflow 1. Add a column with company domains. 2. Run this actor with the domain column as `domainsOrCompanyNames`. 3. Import the dataset back into Clay. 4. Join on `input` or `normalizedDomain`. 5. Filter out rows where `status` is not `resolved`. 6. Use `resolvedYoutubeUrl` in downstream creator, ad, or partnership workflows. ### Lead enrichment workflow Use this actor before outreach to identify brands that actively publish video content. A matched YouTube channel can help segment accounts by content maturity, creator strategy, brand education, or audience engagement. ### Partnership research workflow Partnership teams can use the output to find official brand channels and then review content fit manually. The evidence fields reduce false positives because analysts can see whether the match came from the company website or a fallback search page. ### Data quality workflow Run this actor against a vendor-enriched list to audit missing or incorrect YouTube URLs. Compare your existing channel URL against `resolvedYoutubeUrl` and inspect `confidence` and `evidenceUrl` for disagreements. ### Integrations - Apify datasets for CSV, JSON, XML, RSS, and Excel exports. - Clay for enrichment tables. - Google Sheets through Apify integrations or Make/Zapier. - CRMs and data warehouses through the Apify API. - Internal lead-scoring pipelines through scheduled actor runs. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/company-domain-to-youtube-channel-resolver').call({ domainsOrCompanyNames: ['apify.com', 'stripe.com'], maxPagesPerDomain: 3, searchFallback: false, }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/company-domain-to-youtube-channel-resolver').call(run_input={ 'domainsOrCompanyNames': ['apify.com', 'stripe.com'], 'maxPagesPerDomain': 3, 'searchFallback': False, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~company-domain-to-youtube-channel-resolver/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"domainsOrCompanyNames":["apify.com","stripe.com"],"maxPagesPerDomain":3}' ``` ### MCP: use from Claude Code or Claude Desktop You can expose this actor to AI agents through Apify MCP. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/company-domain-to-youtube-channel-resolver ``` Claude Code setup: ```bash claude mcp add apify-company-youtube-resolver "https://mcp.apify.com/?tools=automation-lab/company-domain-to-youtube-channel-resolver" ``` Claude Desktop JSON configuration: ```json { "mcpServers": { "apify-company-youtube-resolver": { "url": "https://mcp.apify.com/?tools=automation-lab/company-domain-to-youtube-channel-resolver" } } } ``` Example prompts: - "Resolve these 50 company domains to official YouTube channels and return only high-confidence matches." - "Check whether the attached account list has official YouTube profiles and include evidence URLs." - "Find alternative YouTube candidates for brands where the main result is missing." ### Scheduling and monitoring Schedule the actor weekly or monthly for account lists that change over time. Because the output keeps one row per input, you can diff results between runs and detect newly added social links. ### Limitations - Some websites hide social links behind JavaScript that is not present in the initial HTML. - Some companies do not link YouTube from their public website. - Search fallback can return false positives and is therefore marked low confidence. - The actor does not access private YouTube APIs, login-only data, or paid enrichment databases. ### Legality and compliance This actor reads public company websites and public search-result pages when fallback is enabled. You should use the output responsibly, respect applicable laws, and verify low-confidence matches before high-impact decisions. ### FAQ and troubleshooting #### Why did a company return `not_found`? The official site may not expose a YouTube link in public HTML, or the channel may be linked only through JavaScript, a cookie banner, or a regional site. Try increasing `maxPagesPerDomain` or enabling search fallback. #### Why is the result low confidence? Low confidence means the candidate came from search fallback instead of the official company website. Use official-site matches when precision matters. #### Why do I see alternatives? Some brands link several YouTube URLs for global, product, support, or regional channels. The actor picks the top-ranked candidate and keeps the rest in `alternativeCandidates`. ### Related scrapers and actors - https://apify.com/automation-lab/website-contact-finder - https://apify.com/automation-lab/google-maps-lead-finder - https://apify.com/automation-lab/youtube-channel-email-extractor ### Changelog #### 0.1 Initial version for domain-to-YouTube channel resolution with official-site evidence, confidence scoring, alternatives, and optional search fallback. ### Support Open an Apify issue on the actor page if a public website links a YouTube channel that the actor misses. Include the input domain, expected channel URL, and whether search fallback was enabled. ### Summary Company Domain to YouTube Channel Resolver is a focused enrichment actor for turning company domains into official YouTube profile URLs. It is designed for repeatable B2B workflows where evidence, confidence, and stable one-row-per-input output matter. # Actor input Schema ## `domainsOrCompanyNames` (type: `array`): One company per line. Use domains or website URLs for highest-confidence official-site matches; company names can use the search fallback. ## `maxPagesPerDomain` (type: `integer`): How many official-site pages to check per domain, including homepage and likely About/Contact/Company/Social pages. ## `searchFallback` (type: `boolean`): If no YouTube link is found on the official site, query a public search page and mark the result as low confidence. ## `language` (type: `string`): Optional language hint for search fallback, such as en, de, fr, or es. ## `country` (type: `string`): Optional country hint for search fallback, such as US, GB, DE, or FR. ## `requestTimeoutSecs` (type: `integer`): Per-page HTTP timeout. Increase only for slow corporate sites. ## Actor input object example ```json { "domainsOrCompanyNames": [ "apify.com", "stripe.com", "notion.so" ], "maxPagesPerDomain": 3, "searchFallback": false, "language": "en", "country": "US", "requestTimeoutSecs": 15 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "domainsOrCompanyNames": [ "apify.com", "stripe.com", "notion.so" ], "maxPagesPerDomain": 3, "searchFallback": false, "language": "en", "country": "US", "requestTimeoutSecs": 15 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/company-domain-to-youtube-channel-resolver").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "domainsOrCompanyNames": [ "apify.com", "stripe.com", "notion.so", ], "maxPagesPerDomain": 3, "searchFallback": False, "language": "en", "country": "US", "requestTimeoutSecs": 15, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/company-domain-to-youtube-channel-resolver").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "domainsOrCompanyNames": [ "apify.com", "stripe.com", "notion.so" ], "maxPagesPerDomain": 3, "searchFallback": false, "language": "en", "country": "US", "requestTimeoutSecs": 15 }' | apify call automation-lab/company-domain-to-youtube-channel-resolver --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/company-domain-to-youtube-channel-resolver", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Company Domain to YouTube Channel Resolver", "description": "Resolve company domains to official YouTube channel URLs with handles, confidence, evidence pages, and alternatives for lead enrichment.", "version": "0.1", "x-build-id": "rUGGNnX5aoZFM4PqC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~company-domain-to-youtube-channel-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-company-domain-to-youtube-channel-resolver", "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/automation-lab~company-domain-to-youtube-channel-resolver/runs": { "post": { "operationId": "runs-sync-automation-lab-company-domain-to-youtube-channel-resolver", "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/automation-lab~company-domain-to-youtube-channel-resolver/run-sync": { "post": { "operationId": "run-sync-automation-lab-company-domain-to-youtube-channel-resolver", "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": [ "domainsOrCompanyNames" ], "properties": { "domainsOrCompanyNames": { "title": "Domains, URLs, or company names", "minItems": 1, "type": "array", "description": "One company per line. Use domains or website URLs for highest-confidence official-site matches; company names can use the search fallback.", "items": { "type": "string" } }, "maxPagesPerDomain": { "title": "Maximum pages per domain", "minimum": 1, "maximum": 7, "type": "integer", "description": "How many official-site pages to check per domain, including homepage and likely About/Contact/Company/Social pages.", "default": 3 }, "searchFallback": { "title": "Use search fallback", "type": "boolean", "description": "If no YouTube link is found on the official site, query a public search page and mark the result as low confidence.", "default": false }, "language": { "title": "Language hint", "type": "string", "description": "Optional language hint for search fallback, such as en, de, fr, or es.", "default": "en" }, "country": { "title": "Country hint", "type": "string", "description": "Optional country hint for search fallback, such as US, GB, DE, or FR.", "default": "US" }, "requestTimeoutSecs": { "title": "Request timeout seconds", "minimum": 5, "maximum": 45, "type": "integer", "description": "Per-page HTTP timeout. Increase only for slow corporate sites.", "default": 15 } } }, "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 } } } } } } } } } } ```