# Instagram Search Scraper (`parseforge/instagram-search-scraper`) Actor Discover Instagram users, hashtags, and places instantly! Run any keyword and pull profile URLs, bios, follower counts, verified status, post counts, location data, and hashtag popularity. Ideal for influencer research, brand monitoring, and social intelligence. Start exploring today! - **URL**: https://apify.com/parseforge/instagram-search-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Marketing - **Stats:** 28 total users, 14 monthly users, 100.0% runs succeeded, NaN 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ“ธ Instagram Search Scraper > ๐Ÿš€ **Lookup any Instagram profile in seconds.** Get **18 fields per username** including followers, following, posts, bio, external links, verified status, and profile picture. No login, no API key, no Meta Developer account. > ๐Ÿ•’ **Last updated:** 2026-04-21 ยท **๐Ÿ“Š 18 fields** per profile ยท **โšก 100 profiles in ~60 seconds** ยท **๐Ÿ” Concurrent** ยท **๐ŸŒ Residential proxy ready** The **Instagram Search Scraper** accepts a list of Instagram usernames and returns a structured profile record per handle. You get follower count, following count, total post count, biography, external URL, verified status, private-account flag, business-account flag, category name (for business accounts), bio link list, and a high-resolution profile picture URL. All through Instagram's public web profile info endpoint, which works without login when paired with the Apify residential proxy. Concurrent lookups process 15 profiles in parallel, so a prospect list of 100 finishes in about a minute. Output lands in your dataset as clean JSON, ready to import into a CRM, influencer-marketing platform, or lead-enrichment workflow. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Marketers, influencer managers, sales teams, brand monitors, researchers, recruiters | Influencer vetting, CRM enrichment, competitor tracking, lead qualification, brand monitoring | --- ### ๐Ÿ“‹ What the Instagram Search Scraper does Five lookup workflows in a single run: - ๐Ÿ‘ค **Profile data.** Username, full name, user ID, bio, external URL, and bio link list. - ๐Ÿ“Š **Engagement metrics.** Follower count, following count, and total post count. - โœ… **Status flags.** Verified, private-account, and business-account badges. - ๐Ÿท๏ธ **Business category.** The `category_name` when the profile is a business account. - ๐Ÿ–ผ๏ธ **Profile picture.** High-resolution avatar URL ready for embedding. Output includes the original query, the actor type (user), and a timestamp so you always know which profile each record came from and when it was captured. > ๐Ÿ’ก **Why it matters:** influencer campaigns and lead enrichment rely on up-to-date follower counts and verified status. Manual lookups do not scale. This Actor turns a list of usernames into a clean dataset in under a minute. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough of enriching an influencer prospect list._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
queriesarray of stringsrequiredInstagram usernames (with or without @).
searchTypesarray of strings["user"]user (fully supported). hashtag and place are limited.
maxItemsinteger10Profiles returned. Free plan caps at 10, paid plan at 1,000,000.
proxyConfigurationobjectRESIDENTIALResidential proxy required (Instagram blocks datacenter IPs).
**Example: vet a list of potential influencers.** ```json { "queries": ["nike", "cristiano", "mrbeast", "taylorswift"], "searchTypes": ["user"], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` **Example: enrich a CRM with Instagram profile data.** ```json { "queries": ["prospect1", "prospect2", "prospect3"], "searchTypes": ["user"], "maxItems": 100 } ``` > โš ๏ธ **Good to Know:** Instagram blocks datacenter IPs for profile lookups. Always use the Apify residential proxy on paid plans for reliable results. Private profiles return a minimal record with `isPrivate: true` and no follower or post counts. *** ### ๐Ÿ“Š Output Each record contains **18 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ”Ž `query` | string | `"nike"` | | ๐ŸŽฏ `type` | string | `"user"` | | ๐Ÿ‘ค `username` | string | `"nike"` | | ๐Ÿท๏ธ `fullName` | string | null | `"Nike"` | | ๐Ÿ†” `userId` | string | null | `"13460080"` | | ๐Ÿ“ `bio` | string | null | `"Spotlighting athlete* and sport stories."` | | ๐Ÿ‘ฅ `followerCount` | number | null | `297489329` | | โž• `followingCount` | number | null | `202` | | ๐Ÿ“ธ `mediaCount` | number | null | `1103` | | ๐Ÿ–ผ๏ธ `profilePicUrl` | string | null | `"https://scontent.../nike.jpg"` | | ๐Ÿ”— `profileUrl` | string | `"https://www.instagram.com/nike/"` | | โœ… `isVerified` | boolean | `true` | | ๐Ÿ”’ `isPrivate` | boolean | `false` | | ๐Ÿข `isBusiness` | boolean | `false` | | ๐Ÿท๏ธ `category` | string | null | `null` | | ๐ŸŒ `externalUrl` | string | null | `"http://nike.com"` | | ๐Ÿ”— `bioLinks` | array | `[{"title": "", "url": "http://nike.com"}]` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-04-21T12:00:00.000Z"` | | โ— `error` | string | null | `"User not found"` on failure | #### ๐Ÿ“ฆ Sample records
๐Ÿ† Major brand with full data ```json { "query": "nike", "type": "user", "username": "nike", "fullName": "Nike", "userId": "13460080", "bio": "Spotlighting athlete* and sport stories. *If you have a body, you are an athlete.", "followerCount": 297489329, "followingCount": 202, "mediaCount": 1103, "profilePicUrl": "https://scontent-sjc3.cdninstagram.com/.../nike.jpg", "profileUrl": "https://www.instagram.com/nike/", "isVerified": true, "isPrivate": false, "isBusiness": false, "category": null, "externalUrl": "http://nike.com", "bioLinks": [{ "title": "", "url": "http://nike.com" }], "scrapedAt": "2026-04-21T12:00:00.000Z" } ```
๐Ÿ”’ Private account detected ```json { "query": "private_user_example", "type": "user", "username": "private_user_example", "fullName": "Jane Doe", "userId": "987654321", "bio": null, "followerCount": null, "followingCount": null, "mediaCount": null, "profilePicUrl": "https://scontent.../profile.jpg", "profileUrl": "https://www.instagram.com/private_user_example/", "isVerified": false, "isPrivate": true, "isBusiness": false, "category": null, "externalUrl": null, "bioLinks": [], "scrapedAt": "2026-04-21T12:00:00.000Z" } ```
๐Ÿšง User not found ```json { "query": "badguy_thatdoesntexist", "type": "user", "scrapedAt": "2026-04-21T12:00:00.000Z", "error": "User not found" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿ“Š | **18 fields.** Follower count, following, posts, verified, business, category, external URL. | | โšก | **Fast.** 100 profiles in about 60 seconds with concurrency of 15. | | ๐Ÿ” | **Batch-ready.** Feed a list of usernames and get clean records in one run. | | ๐Ÿ”’ | **Private-aware.** Flags private accounts instead of silently failing. | | ๐Ÿšซ | **No Meta Developer account.** Public profile data without API keys. | | ๐Ÿ”Œ | **Integrations.** Drop results into CRMs, Sheets, Slack, or any AI agent. | | ๐ŸŒ | **Residential proxy support.** Reliable results with Apify residential proxy. | > ๐Ÿ“Š Influencer marketing spend will top $21B in 2026. Clean, verified follower data is the single most valuable input into campaign ROI. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ Instagram Search Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Any public username | **Live per run** | username list, verified, business, private | โšก 2 min | | Paid influencer platforms | $299+/month | Managed lists | Daily refresh | Rich filters | โณ Hours | | Meta Graph API | Free | Only your own accounts | Real-time | Owner data only | ๐Ÿ•’ Variable | | DIY scrapers | Free | Whatever you code | Your schedule | Whatever you build | ๐Ÿข Days | Pick this Actor when you want a simple pay-per-use enrichment tool that works across any public username. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the Instagram Search Scraper page on the Apify Store. 3. ๐ŸŽฏ **Paste usernames.** Add handles to the `queries` field. Residential proxy is on by default. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor enrich your list. 5. ๐Ÿ“ฅ **Download.** Grab your dataset as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to enriched dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐ŸŒŸ Influencer Marketing - Vet creators by follower count and category - Build shortlists of verified accounts - Track competitor-sponsored creators - Enrich influencer CRM records weekly #### ๐Ÿ“ฃ Brand Monitoring - Snapshot your brand's follower growth - Compare against competitor brands weekly - Detect fake-looking ratio anomalies - Capture bio link changes over time
#### ๐Ÿ’ผ Sales & Lead Gen - Qualify prospects by business-account flag - Add follower counts to CRM enrichment - Segment leads by IG category - Prioritize outreach to verified accounts #### ๐Ÿงช Research - Build influencer datasets for studies - Map category communities on Instagram - Correlate follower counts with trends - Preserve profile snapshots for records
*** ### ๐Ÿ”Œ Automating Instagram Search Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Weekly enrichment runs keep CRM data fresh automatically. *** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Instagram%20Search%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Instagram%20Search%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Instagram%20Search%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Instagram%20Search%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Pass a list of usernames. The Actor queries Instagram's public web profile info endpoint with the Apify residential proxy, parses the response, and returns a clean record per handle. #### ๐Ÿ“ How accurate is the data? Follower, following, and post counts match exactly what Instagram displays publicly. Counts are captured at the moment of the run. #### ๐Ÿ”’ Does it work for private accounts? Partially. Private accounts return username, fullName, userId, profilePicUrl, and `isPrivate: true`. Follower and post counts are not exposed by Instagram for private accounts. #### ๐Ÿท๏ธ Why is hashtag search limited? Instagram now gates tag and location APIs behind authenticated sessions. User profile lookup still works via the public endpoint. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to refresh a list of profiles daily or weekly. #### โš–๏ธ Is it legal? Accessing publicly available profile metadata is generally fine for research, CRM, and marketing. Respect Instagram's terms of service when redistributing or using data commercially. #### ๐Ÿ’ผ Can I use this commercially? Yes for internal marketing, CRM enrichment, and research. Reselling the raw data may violate Instagram's terms. #### ๐Ÿ’ณ Do I need a paid Apify plan to use this Actor? The free plan covers testing (10 profiles per run). A paid plan lifts the limit AND gives you residential proxy access, which is required for reliable Instagram results at scale. #### ๐Ÿ” What happens if a run fails? Apify retries transient errors. Per-username failures include an `error` field. Partial datasets are preserved. #### ๐Ÿ“ธ Can I get posts or reels? Use the Instagram Posts Scraper or Instagram Reel Scraper for media content. This Actor focuses on profile-level metadata. #### ๐ŸŒ Does it support international accounts? Yes. Any public Instagram profile works regardless of language or country. Profile fields are returned in the creator's original language. #### ๐Ÿ†˜ What if I need help? Our team is available through the Apify platform and the Tally form below. *** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
*** ### ๐Ÿ”Œ Integrate with any app Instagram Search Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate influencer workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Sync IG profiles to your CRM - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Alert when follower counts change - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe profiles into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export profile data to Sheets You can also use webhooks to trigger downstream enrichment and alerting pipelines. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ“ฑ Instagram Profile Scraper**](https://apify.com/parseforge/instagram-profile-scraper) - Full profile with recent posts - [**๐Ÿ“ธ Instagram Posts Scraper**](https://apify.com/parseforge/instagram-posts-scraper) - Posts from any profile - [**๐ŸŽž๏ธ Instagram Reel Scraper**](https://apify.com/parseforge/instagram-reel-scraper) - Reel data and engagement - [**๐Ÿ‘ฅ Facebook Search Scraper**](https://apify.com/parseforge/facebook-search-scraper) - Facebook page discovery - [**๐ŸŽฌ YouTube Transcript Scraper**](https://apify.com/parseforge/youtube-transcript-scraper) - Full video transcripts > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more social media tools. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with Instagram or Meta. It accesses only publicly available profile data. Respect Instagram's terms of service and applicable privacy laws (GDPR, CCPA) when using profile data commercially. # Actor input Schema ## `queries` (type: `array`): List of search queries ## `searchTypes` (type: `array`): Types of entities to search ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `proxyConfiguration` (type: `object`): Apify proxy configuration ## Actor input object example ```json { "queries": [ "nike", "travel" ], "searchTypes": [ "user", "hashtag", "place" ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Complete dataset # 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 = { "queries": [ "nike", "travel" ], "searchTypes": [ "user", "hashtag", "place" ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/instagram-search-scraper").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 = { "queries": [ "nike", "travel", ], "searchTypes": [ "user", "hashtag", "place", ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("parseforge/instagram-search-scraper").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 '{ "queries": [ "nike", "travel" ], "searchTypes": [ "user", "hashtag", "place" ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call parseforge/instagram-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/instagram-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Search Scraper", "description": "Discover Instagram users, hashtags, and places instantly! Run any keyword and pull profile URLs, bios, follower counts, verified status, post counts, location data, and hashtag popularity. Ideal for influencer research, brand monitoring, and social intelligence. Start exploring today!", "version": "1.0", "x-build-id": "zgUq4E7UMxyV2Vp6d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~instagram-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-instagram-search-scraper", "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/parseforge~instagram-search-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-instagram-search-scraper", "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/parseforge~instagram-search-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-instagram-search-scraper", "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": [ "queries" ], "properties": { "queries": { "title": "Search Queries", "type": "array", "description": "List of search queries", "items": { "type": "string" } }, "searchTypes": { "title": "Search Types", "type": "array", "description": "Types of entities to search", "items": { "type": "string", "enum": [ "user", "hashtag", "place" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy configuration" } } }, "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 } } } } } } } } } } ```