# YouTube Market Intelligence (`agentx/youtube-market-intelligence`) Actor YouTube channel-intelligence API: business email, social links, subscriber growth, watch-time signals, and top-performing video metrics. JSON output for influencer CRMs, creator outreach, and sponsorship-targeting pipelines. - **URL**: https://apify.com/agentx/youtube-market-intelligence.md - **Developed by:** [AgentX](https://apify.com/agentx) (community) - **Categories:** Social media, Videos, Lead generation - **Stats:** 42 total users, 2 monthly users, 17.6% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## 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 ## YouTube Market Intelligence - YouTube Channel Intelligence & Metadata Extraction API **Extract YouTube channel intelligence with 20+ fields per creator including business email, social links, subscriber count, video count, total views, tags, join date, and country.** This API searches YouTube by keyword and returns unique channel profiles with optional video-catalog extraction as structured JSON for creator CRMs, sponsorship qualification, and channel benchmarking workflows. [![YouTube](https://img.shields.io/badge/YouTube-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi) [![20+ Fields](https://img.shields.io/badge/20+_Fields-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi) [![Video Catalog](https://img.shields.io/badge/Video_Catalog-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi) --- ### Why Choose This YouTube Channel Intelligence API #### 20+ Channel Signals with Contact Data and Optional Video Catalogs **🎯 Keyword-Based Creator Discovery** Search YouTube by keyword and extract unique channel profiles from video results. Supports topic, niche, and industry search terms for targeted creator discovery. **📊 Comprehensive Channel Metadata** 20+ fields per channel: subscriber count, video count, total views, join date, country, description, tags, emails, social links, avatar URL, and banner URL. **🎬 Optional Video Catalog** Toggle full video catalog extraction per channel — titles, view counts, durations, thumbnails, and descriptions for content analysis. **📧 Contact Email Extraction** Automatically extracts email addresses from channel descriptions for outreach and partnership workflows. --- ### Quick Start Guide #### How to Extract YouTube Channel Data in 3 Steps ##### Step 1: Configure Parameters Enter a search keyword, set max results, and toggle video catalog extraction. [![YouTube Market Intelligence Input](https://api.apify.com/v2/key-value-stores/kjFMzTgdeZ43RnmXV/records/youtuber-scraper_input.png)](https://console.apify.com/actors/gCHgOwrCrCYYOcqia/input?fpr=aiagentapi) ##### Step 2: Run the Actor Click "Start" to begin extraction. YouTube videos are searched and unique channel profiles are extracted. ##### Step 3: Access Structured Results Download JSON dataset or integrate via Apify API into your analytics pipeline. #### Example Input ```json { "keyword": "marketing", "sort_by": "relevance", "max_results": 100 } ```` *** ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | **🔍 Keyword** | String | Yes | Keyword to search YouTube videos and extract channel profiles | | **🔀 Sort By** | Select | Yes | YouTube search sort mode: `relevance`, `view_count`, `rating`, `upload_date` | | **📊 Max Results** | Number | Yes | Maximum matched videos (and channel profiles) to extract | *** ### Output Data Schema Each extracted YouTube channel returns 20+ structured fields: [![YouTube Market Intelligence Output](https://api.apify.com/v2/key-value-stores/kjFMzTgdeZ43RnmXV/records/youtuber-scraper_output.png)](https://console.apify.com/actors/gCHgOwrCrCYYOcqia/input?fpr=aiagentapi) #### Channel Profile Fields | Field | Type | Description | |-------|------|-------------| | **channel\_id** | String | YouTube channel ID | | **channel\_name** | String | Channel display name | | **channel\_handle** | String | Public handle such as @channelname | | **channel\_url** | String | Direct channel URL | | **channel\_joined\_date** | String | Channel creation date | | **channel\_country** | String | Channel owner country | | **channel\_description** | String | Channel description/about text | | **channel\_tags** | Array | Channel keywords | | **channel\_links** | Array | External social/website links | | **contact\_emails** | Array | Contact emails from description | | **channel\_avatar\_url** | String | Profile picture URL | | **channel\_banner\_url** | String | Banner image URL | | **channel\_is\_verified** | Boolean | Verified badge status | | **channel\_rss\_url** | String | YouTube RSS feed URL | | **subscriber\_count** | Integer | Subscriber count | | **channel\_view\_count** | Integer | Total views across all videos | | **channel\_video\_count** | Integer | Total videos on channel | #### Video Fields | Field | Type | Description | |-------|------|-------------| | **video\_url** | String | Matched video URL | | **video\_id** | String | Unique video identifier | | **video\_title** | String | Video title | | **video\_description** | String | Video description text | | **video\_thumbnail\_url** | String | Video thumbnail URL | | **video\_view\_count** | Integer | View count | | **video\_like\_count** | Integer | Like count | | **video\_comment\_count** | Integer | Comment count | | **video\_duration\_seconds** | Integer | Duration in seconds | | **video\_published\_at** | String | Publish timestamp (ISO) | | **video\_categories** | Array | YouTube categories | | **video\_tags** | Array | Video tags | #### Example Output ```json { "processor": "https://apify.com/agentx/youtube-market-intelligence", "processed_at": "2025-01-15T14:23:45.123Z", "video_url": "https://www.youtube.com/watch?v=abc123", "video_title": "How To Grow A YouTube Channel Fast", "video_view_count": 1250000, "video_duration_seconds": 742, "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "channel_name": "MrBeast", "channel_handle": "@MrBeast", "channel_url": "https://www.youtube.com/@MrBeast", "channel_joined_date": "2012-02-20", "channel_country": "United States", "channel_description": "I give away money, cars, houses...", "channel_tags": ["entertainment", "challenge"], "channel_links": [ {"title": "Instagram", "url": "https://instagram.com/mrbeast"} ], "contact_emails": ["contact@mrbeast.com"], "subscriber_count": 200000000, "channel_view_count": 25000000000, "channel_video_count": 500 } ``` *** ### Integration Examples #### Python Integration ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run_input = { "keyword": "marketing", "sort_by": "relevance", "max_results": 50 } run = client.actor("gCHgOwrCrCYYOcqia").call(run_input=run_input) dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items for item in dataset_items: print(f"{item['channel_name']} | Subs: {item['subscriber_count']} | Emails: {item.get('contact_emails', [])}") ``` #### JavaScript Integration ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const input = { keyword: 'marketing', sort_by: 'relevance', max_results: 50 }; const run = await client.actor('gCHgOwrCrCYYOcqia').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(item => { console.log(`${item.channel_name} | Subs: ${item.subscriber_count} | Videos: ${item.channel_video_count}`); }); ``` #### Make.com (Integromat) Integration 1. Add an **Apify** module to your Make scenario 2. Select **Run an Actor** action 3. Set Actor ID to `gCHgOwrCrCYYOcqia` 4. Configure input JSON with keyword and parameters 5. Set **Run synchronously** to **YES** 6. Add **Get Dataset Items** module to receive channel data #### N8N Integration 1. Add an **Apify** node to your n8n workflow 2. Set Actor to `gCHgOwrCrCYYOcqia` 3. Configure keyword and parameters in input JSON 4. Use downstream nodes to process channel profiles #### JSON-LD Metadata ```json { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "YouTube Market Intelligence", "description": "YouTube channel and video metadata extraction API with 20+ fields, contact emails, social links, and video catalogs", "applicationCategory": "Developer Tools", "operatingSystem": "Cloud", "url": "https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi", "dateModified": "2026-04-18", "offers": { "@type": "Offer", "price": "0.0085", "priceCurrency": "USD" } } ``` *** ### Pricing & Cost Calculator #### Transparent Pay-Per-Use Model | Event Type | Price | Description | |------------|-------|-------------| | **Actor Start** | $0.00005 | Per run initialization (per GB) | | **Actor Usage** | $0.00001 | Per compute unit consumed | | **Profile** | $0.0085 | Per channel profile extracted with full metadata | | **Video** | $0.00005 | Per video extracted from channel catalog | #### Cost Examples **Channel Profiles Only** (100 channels, no videos): - Profiles: 100 × $0.0085 = $0.85 - **Total**: ~$0.85 **Channels + Video Catalogs** (50 channels, ~100 videos each): - Profiles: 50 × $0.0085 = $0.43 - Videos: 5,000 × $0.00005 = $0.25 - **Total**: ~$0.68 **Large Discovery** (1,000 channels): - Profiles: 1,000 × $0.0085 = $8.50 - **Total**: ~$8.50 *** ### Use Cases & Applications #### Influencer Discovery & Partnership **Creator Identification** Search by topic keyword to discover YouTube creators in any niche. Extract subscriber counts, view totals, and engagement data for partnership vetting. **Contact Extraction** Automatically extract email addresses and social media links from channel descriptions for outreach workflows. #### Competitive Intelligence **Channel Benchmarking** Compare subscriber growth, video output, and view counts across competing channels in your industry vertical. **Content Strategy Analysis** Extract video catalogs from top-performing channels to identify content themes, posting frequency, and title patterns. #### Market Research **Audience Mapping** Analyze creator profiles across categories to understand audience distribution, geographic coverage, and niche saturation. **Trend Detection** Monitor channel tags, descriptions, and video topics to identify emerging content categories and market opportunities. *** ### FAQ ##### How does keyword search work? The API searches YouTube for videos matching the keyword, then extracts unique channel profiles from the results. This ensures channels are active and relevant to the topic. ##### What is the video catalog option? When `video: true`, the full video list for each channel is extracted (titles, views, durations, thumbnails). Disable for faster, lower-cost channel-only extraction. ##### Are contact emails always available? Emails are extracted from channel descriptions. Availability depends on whether the creator has published contact information. ##### What is the maximum number of results? Set `max_results` up to thousands. Processing time scales with volume. Budget limits may stop processing mid-batch. ##### Can I search by channel URL instead of keyword? This API is keyword-based. It searches YouTube videos and extracts channel profiles from results. For direct channel lookup, use the channel URL format. ##### What data fields are returned for each channel? Each channel profile includes subscriber count, video count, total views, join date, country, description, tags, contact emails, social links, avatar URL, banner URL, and channel ID. With `video: true` enabled, each video entry adds title, views, duration, thumbnail, and publish date. *** ### SEO Keywords & Search Terms #### Primary Keywords YouTube channel extraction API, YouTube creator scraper, YouTube profile data API, YouTube influencer discovery, YouTube channel analytics API, YouTube metadata extraction #### Long-Tail Keywords extract YouTube channel profiles with contact emails API, YouTube creator discovery by keyword structured JSON, YouTube channel subscriber data extraction pipeline, YouTube influencer outreach email extraction API, YouTube creator batch profiling pipeline, YouTube channel analytics with video catalog API #### Industry Terms influencer discovery, creator analytics, channel intelligence, media buying, partnership outreach, content benchmarking, audience mapping *** ### Trust & Certifications - ✅ **Enterprise Ready** - Processing thousands of channels per run with 99.9% uptime - ✅ **GDPR Compliant** - EU data protection standards - ✅ **20+ Data Fields** - Comprehensive channel and video intelligence - ✅ **Regular Updates** - Continuous maintenance for platform changes *** ### Legal & Compliance #### Data Rights & Usage All data extracted by this actor originates from publicly accessible YouTube channel profiles. Users are responsible for ensuring their use complies with applicable laws and YouTube's Terms of Service. #### Privacy Compliance - **GDPR**: Compliant with EU General Data Protection Regulation. No personal data is stored beyond the extraction session. - **CCPA**: Compliant with California Consumer Privacy Act requirements. #### Platform Terms of Service Users must review and comply with YouTube's Terms of Service regarding data usage. This tool accesses only publicly available channel data. #### Enterprise Support For enterprise licensing, custom integrations, or compliance inquiries: - **Telegram**: [@AiAgentApi](https://t.me/AiAgentApi) *** ### Related Tools #### Jobs & Hiring - **[All Job Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)** - Multi-Platform Job Data Extraction API - **[Indeed Hiring Scraper](https://apify.com/agentx/indeed-hiring-scraper?fpr=aiagentapi)** - Indeed Job Extraction & Market Intelligence - **[LinkedIn Hiring Scraper](https://apify.com/agentx/linkedin-hiring-scraper?fpr=aiagentapi)** - LinkedIn Job Data Extraction & Talent Intelligence - **[Glassdoor Hiring Scraper](https://apify.com/agentx/glassdoor-hiring-scraper?fpr=aiagentapi)** - Glassdoor Salary Intelligence & Company Reviews #### LinkedIn - **[LinkedIn Company Scraper](https://apify.com/agentx/linkedin-company-scraper?fpr=aiagentapi)** - LinkedIn Company Data Extraction & Firmographic Intelligence - **[LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi)** - LinkedIn Profile Data Extraction & Professional Intelligence #### Reddit - **[Reddit Author Scraper](https://apify.com/agentx/reddit-author-scraper?fpr=aiagentapi)** - Reddit Author Profile Extraction & Activity Analysis - **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)** - Reddit Viral Content Extraction & Trend Intelligence - **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper?fpr=aiagentapi)** - Subreddit Metadata Extraction & Community Intelligence - **[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi)** - Subreddit Post Extraction & Content Analysis - **[Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi)** - Subreddit Member Extraction & Audience Analysis #### Telegram - **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)** - Telegram Chat Message Extraction & Content Analysis - **[Telegram Group Inviter](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi)** - Telegram Group Member Invitation & Management - **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)** - Telegram Entity Metadata Extraction & Intelligence - **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi)** - Telegram Group Member Extraction & Audience Data - **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi)** - Telegram Private Group Data Extraction & Analysis #### Instagram - **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper?fpr=aiagentapi)** - Instagram Profile Data Extraction & Creator Intelligence - **[Instagram Post Reel Scraper](https://apify.com/agentx/instagram-post-reel-scraper?fpr=aiagentapi)** - Instagram Feed Post & Reel Extraction API - **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper?fpr=aiagentapi)** - Instagram Explore Trending Content Extraction API #### X / Twitter - **[Twitter Community Scraper](https://apify.com/agentx/twitter-community-scraper?fpr=aiagentapi)** - Twitter Community Extraction & Member Analysis - **[Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi)** - X/Twitter Profile Extraction & User Intelligence #### TikTok - **[TikTok Creator Scraper](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi)** - TikTok Creator Profile Extraction & Analytics - **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi)** - TikTok Live Stream Recording & Download - **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript?fpr=aiagentapi)** - TikTok Video Transcription & Content Extraction #### Video & Content - **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)** - Multi-Platform Video Download & Extraction (1000+ Sites) - **[Video Caption Scraper](https://apify.com/agentx/video-caption-scraper?fpr=aiagentapi)** - Video Caption Extraction & Subtitle Data - **[Video Transcript](https://apify.com/agentx/video-transcript?fpr=aiagentapi)** - Universal Video Transcription & AI Training Data - **[Video to Social Post](https://apify.com/agentx/video-to-social-post?fpr=aiagentapi)** - Video Content Conversion & Social Media Repurposing - **[Live Stream Transcript](https://apify.com/agentx/live-stream-transcript?fpr=aiagentapi)** - Live Stream Transcription & Real-Time Content Extraction #### YouTube - **[YouTube Transcript](https://apify.com/agentx/youtube-transcript?fpr=aiagentapi)** - YouTube Video Transcription & Speech Extraction - **[YouTube Market Intelligence](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi)** - YouTube Channel & Video Market Intelligence (This Tool) #### Real Estate - **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi)** - Realtor.com Property Data Extraction & Market Intelligence - **[Zillow For Sale Scraper](https://apify.com/agentx/zillow-for-sale-scraper?fpr=aiagentapi)** - Zillow Property Listing Extraction & Real Estate Data #### Maps & Local - **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper?fpr=aiagentapi)** - Google Maps Business Data Extraction & Local Intelligence *** ### Support & Community - **👥 Community**: [@Apify\_Actor](https://t.me/Apify_Actor) - **👤 Contact Team**: [@AiAgentApi](https://t.me/AiAgentApi) *** **Last Updated:** April 18, 2026 # Actor input Schema ## `keyword` (type: `string`): Search YouTube videos by keyword. Each result includes the matched video plus the related channel profile. ## `sort_by` (type: `string`): Choose one YouTube search sort mode. ## `max_results` (type: `integer`): Maximum number of matched videos to return from search results. ## Actor input object example ```json { "keyword": "apify", "sort_by": "relevance", "max_results": 1 } ``` # Actor output Schema ## `results` (type: `string`): Keyword-matched YouTube video results with full channel details, contact info, and social links # 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 = { "keyword": "apify", "sort_by": "relevance", "max_results": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("agentx/youtube-market-intelligence").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 = { "keyword": "apify", "sort_by": "relevance", "max_results": 1, } # Run the Actor and wait for it to finish run = client.actor("agentx/youtube-market-intelligence").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 '{ "keyword": "apify", "sort_by": "relevance", "max_results": 1 }' | apify call agentx/youtube-market-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=agentx/youtube-market-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Market Intelligence", "description": "YouTube channel-intelligence API: business email, social links, subscriber growth, watch-time signals, and top-performing video metrics. JSON output for influencer CRMs, creator outreach, and sponsorship-targeting pipelines.", "version": "0.0", "x-build-id": "5HgnXJhRMsxkhabZj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agentx~youtube-market-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agentx-youtube-market-intelligence", "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/agentx~youtube-market-intelligence/runs": { "post": { "operationId": "runs-sync-agentx-youtube-market-intelligence", "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/agentx~youtube-market-intelligence/run-sync": { "post": { "operationId": "run-sync-agentx-youtube-market-intelligence", "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": [ "max_results", "sort_by", "keyword" ], "properties": { "keyword": { "title": "🔍 Keyword", "type": "string", "description": "Search YouTube videos by keyword. Each result includes the matched video plus the related channel profile." }, "sort_by": { "title": "🔀 Sort By", "enum": [ "relevance", "view_count", "rating", "upload_date" ], "type": "string", "description": "Choose one YouTube search sort mode." }, "max_results": { "title": "📊 Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of matched videos to return from search results." } } }, "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 } } } } } } } } } } ```