# APPLE Apps Extractor (`jupri/apple-apps`) Actor 💫 All-in-One Apple APPS Scraper - **URL**: https://apify.com/jupri/apple-apps.md - **Developed by:** [cat](https://apify.com/jupri) (community) - **Categories:** E-commerce - **Stats:** 31 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $25.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ## Welcome To Apple Apps Scraper ![dont be sad readme is here](https://raw.githubusercontent.com/JupriGH/resources/main/cats/catframe.png) ### 🍏 About APPLE Apps Store The **App Store** is an [app marketplace](https://en.wikipedia.org/wiki/App_store "App store") developed and maintained by [Apple](https://en.wikipedia.org/wiki/Apple_Inc. "Apple Inc."), for [mobile apps](https://en.wikipedia.org/wiki/Mobile_app "Mobile app") on its [iOS](https://en.wikipedia.org/wiki/IOS "IOS") and [iPadOS](https://en.wikipedia.org/wiki/IPadOS "IPadOS") operating systems. The store allows users to browse and download approved apps developed within Apple's [iOS SDK](https://en.wikipedia.org/wiki/IOS_SDK "IOS SDK"). Apps can be downloaded on the [iPhone](https://en.wikipedia.org/wiki/IPhone "IPhone"), [iPod Touch](https://en.wikipedia.org/wiki/IPod_Touch "IPod Touch"), or [iPad](https://en.wikipedia.org/wiki/IPad "IPad"), and some can be transferred to the [Apple Watch](https://en.wikipedia.org/wiki/Apple_Watch "Apple Watch") smartwatch or 4th-generation or newer [Apple TVs](https://en.wikipedia.org/wiki/Apple_TV "Apple TV") as extensions of iPhone apps. ### 🍏 About This Actor ### 🍏 Tutorial #### 🍿 Parameters | Input| Type | Description | |-|-|-| | `query` | ***string array*** | Query, Search Terms or URL | | `limit` | ***integer*** | Number of results (per-query)| #### 🍿 Advanced Usage ***APPLE Query Language (AQL)*** ```html [ | # | @ ] [ | | | ] [ /
] ```` ***Possible QUERY values*** | Format | Example | Description | |-|-|-| | **app:<*APP\_ID*>** | `app:1386412985` | ***Application Data*** | | `/info` | `app:1386412985/info` | App info (default) | | `/privacy` | `app:1386412985/privacy` | App privacy | | `/related` | `app:1386412985/related` | Related apps | | `/reviews` | `app:1386412985/reviews` | App reviews | | `/events` | `app:1386412985/events` | App events | | `/stories` | `app:1386412985/stories` | App stories (editorial) | | **dev:<*DEV\_ID*>** | `dev:281956209` | ***Developer Data*** | | `/info` | `dev:281956209/info` | Developer info | | `/bundles` | `dev:281956209/bundles` | | | | `/apps` `/ios` | `dev:281956209/apps` | | | `/mac` | | | | `/atv` | | | | `/imessage` | | | | `/watch` | | | | **story:<*STORY\_ID*>** | `story:1638400003` | ***Story Data*** | | **https:<*URL*>** | `https://apps.apple.com` | ***Start URL*** | | | `https://apps.apple.com/us/app/...` | | | | `https://apps.apple.com/us/developer/...` | | | | `https://apps.apple.com/us/story/...` | | ### 🍏 Input Examples ### 🍏 Output Sample #### Application ```yaml { "artistName": "WhatsApp Inc.", "chartPositions": { "appStore": { "chart": "top-free", "chartLink": "https://apps.apple.com/us/charts/iphone/business-apps/6000", "genre": 6000, "genreName": "Business", "genreShortName": "Business", "position": 10 } }, "contentRatingsBySystem": { "appsApple": { "advisories": [ "Infrequent/Mild Horror/Fear Themes", "Infrequent/Mild Profanity or Crude Humor", "Infrequent/Mild Mature/Suggestive Themes", "Infrequent/Mild Medical/Treatment Information" ], "name": "12+", "rank": 3, "value": 300 } }, "developer": [ { "id": "310634000", "mediaType": "Mobile Software Applications", "name": "WhatsApp Inc.", "type": "developers", "url": "https://apps.apple.com/us/developer/whatsapp-inc/id310634000" } ], "deviceFamilies": [ "iphone", "ipod" ], "distributionKind": "APP_STORE", "familyShareEnabledDate": "0001-04-23T00:00:00Z", "fileSizeByDevice": { "MacFamily20,1": 216237056, "RealityFamily22,1": 215817216, "iPad11,1": 217885696, "iPad11,2": 217885696, ... }, "genreDisplayName": "Business", "genres": [ { "id": "6000", "name": "Business", "parentId": "36", "parentName": "App Store", "type": "genres", "url": "https://itunes.apple.com/us/genre/id6000" }, { "id": "6007", "name": "Productivity", "parentId": "36", "parentName": "App Store", "type": "genres", "url": "https://itunes.apple.com/us/genre/id6007" } ], "hasEula": true, "id": "1386412985", "name": "WhatsApp Business", "platformAttributes": { "ios": { "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/55/97/e4/5597e45c-3ace-648d-1dee-26a332889255/AppIconSMB-0-0-1x_U007ephone-0-0-0-0-0-sRGB-0-85-220.png/320x320w.webp", "bundleId": "net.whatsapp.WhatsAppSMB", "copyright": "© 2024 WhatsApp Inc.", "customAttributes": { "default": { "default": { "customScreenshotsByType": { "iphone6+": [ "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/34/35/30/343530f7-53a7-364e-7065-abd2e40093cc/mzl.sdvhhmgf.png/320x320w.webp", "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/fb/e8/0d/fbe80dcc-308b-9849-51a2-ab7721218683/mzl.frhpagce.png/320x320w.webp", "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/5b/fa/d8/5bfad804-a020-2768-af51-a08673a3415b/mzl.xebkuhac.png/320x320w.webp" ], "iphone_6_5": [ "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/1e/4a/89/1e4a895f-6b58-e13b-bc59-d1ef25bf3214/mzl.sytdhwnu.png/320x320w.webp", "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/06/a9/29/06a92910-d8a9-c90f-b477-6ee5a1b61611/mzl.jioznqxp.png/320x320w.webp", "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/a3/73/68/a3736875-aa67-9fbb-994b-ee7f49467fb8/mzl.rrezzmvb.png/320x320w.webp" ] } } } }, "description": { "standard": "About this app\n\nEverything you love about WhatsApp plus built-in tools for business\nWhatsApp Business is a free-to-download app with built-in tools to help you work smarter, build trust, and grow your business. \n\nYou get free calls* and free international messaging* plus business features to help you do more with conversations.\n\nDownload the app to get business benefits like these:\n\n• Work smarter. Save time by letting the app do the work for you! Send customers automated quick replies and away messages so you never miss an opportunity. Use labels to quickly organize, filter, and find important conversations. Create a status to share an offer or news, and even take orders and payments** in-app to create a great customer experience. \n\n\n• Build relationships and trust. With a professional business profile on a secure platform, you build credibility and trust with customers. Use the app to provide more responsive customer support and build long-term loyalty. Subscribe to Meta Verified*** to reinforce your authenticity.\n\n\n• Sell more and grow. Get discovered, advertise, and make more valuable customer connections. Boost sales by sending targeted offers to customers; create ads that click to WhatsApp; showcase your product catalog; and give customers the convenience of in-app orders and payments.**\n\nFAQs\nAre all features free?\nThe app is free to download and use, with a mix of free and paid features.\n\nCan I still use my personal WhatsApp?\nYes! As long as you have two different phone numbers, your business and personal accounts can live together on a single device. \n\nCan I transfer over my chat history?\nYes. When you set up the WhatsApp Business app, you can restore a backup from your WhatsApp account to transfer your messages, media, and contacts to your business account.\n\nHow many devices can I connect?\nYou can have a total of five web-based devices or mobile phones on your account (up to 10 if you subscribe to Meta Verified***). \n\n*Data charges may apply. Contact your provider for details.\n**Not available in all markets\n***Available soon globally\n\nTerms of Service: https://www.whatsapp.com/legal/terms-of-service\n \n Learn more about messaging privately: https://www.whatsapp.com/privacy\n \n Learn more about WhatsApp safety: https://www.whatsapp.com/security" }, "editorialArtwork": { "brandLogo": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/22/29/88/222988f5-d687-a390-7bd5-e7ff102c70d4/c11d0a2e-7af6-4725-a1a5-7ca61e6cb749.png/320x320w.webp", "contentIconTrimmed": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/6c/bb/46/6cbb4651-ad2b-b7d4-8c0b-da19ece82df1/bc8fd91d-08b5-4439-b99d-06b141f52ea5.png/320x320w.webp", "contentIconTrimmedMonochrome": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/6b/26/61/6b266131-b03c-10b8-5640-24ed75a1b527/9020ae77-3d4e-48fc-a546-8895dffe962b.png/320x320w.webp" }, "externalVersionId": 868079266, "hasInAppPurchases": true, "isSiriSupported": true, "languageList": [ "English", "Arabic", "Bengali", ... ], "minimumOSVersion": "12.0", "offers": [ { "assets": [ { "flavor": "iosSoftware", "size": 247094272 } ], "buyParams": "productType=C&price=0&salableAdamId=1386412985&pricingParameters=STDQ&pg=default&appExtVrsId=868079266", "currencyCode": "USD", "priceFormatted": "$0.00", "type": "get" }, { "assets": [ { "flavor": "iosSoftware", "size": 247094272 } ], "buyParams": "productType=C&price=0&salableAdamId=1386412985&pricingParameters=SWUPD&pg=default&appExtVrsId=868079266", "currencyCode": "USD", "priceFormatted": "$0.00", "type": "update" } ], "privacyPolicyUrl": "https://www.whatsapp.com/legal/business-terms/", "releaseDate": "2019-04-05", "requiredCapabilities": "arm64 telephony", "requiredCapabilitiesForRealityDevice": "arm64 telephony", "requirementsString": "Requires iOS 12.0 or later. Compatible with iPhone.", "seller": "WhatsApp Inc.", "supportURLForLanguage": "https://faq.whatsapp.com/", "supportedLocales": [ { "name": "English", "tag": "en-US" }, { "name": "Arabic", "tag": "ar" }, { "name": "Bengali", "tag": "bn" }, ... ], "supportsPassbook": true, "versionHistory": [ { "releaseDate": "2024-08-13", "releaseNotes": "• New calling UI with updated controls and improved reliability. \n • You can add “Favorites” that appear at the top of your calls tab and as a filter for your chats. Go to ‘Settings’ > ‘Favorites’ to get started. \n \n \n These features will roll out over the coming weeks. Thanks for using WhatsApp!", "releaseTimestamp": "2024-08-13T18:00:51Z", "versionDisplay": "24.16.78" }, { "releaseDate": "2024-07-29", "releaseNotes": "• You can now add notes about your customers directly on WhatsApp. Open a chat with the customer, tap on their name, and tap ‘Add customer notes’ to get started. \n • You can now create and send Events in groups. Tap the ‘+’ button and select ‘Event’ to get started. \n\n \n These features will roll out over the coming weeks. Thanks for using WhatsApp!", "releaseTimestamp": "2024-07-29T18:01:13Z", "versionDisplay": "24.15.78" }, ... ], "websiteUrl": "https://www.whatsapp.com/business/" } }, "privacy": { "privacyTypes": [ { "dataCategories": [ { "dataCategory": "Purchases", "identifier": "PURCHASES" }, { "dataCategory": "Financial Info", "identifier": "FINANCIAL_INFO" }, { "dataCategory": "Location", "identifier": "LOCATION" }, ... ], "description": "The following data may be collected and linked to your identity:", "identifier": "DATA_LINKED_TO_YOU", "privacyType": "Data Linked to You" } ] }, "privacyDetails": { "privacyTypes": [ { "description": "The following data, which may be collected and linked to your identity, may be used for the following purposes:", "identifier": "DATA_LINKED_TO_YOU", "privacyType": "Data Linked to You", "purposes": [ { "dataCategories": [ { "dataCategory": "Usage Data", "dataTypes": [ "Product Interaction", "Advertising Data" ], "identifier": "USAGE_DATA" } ], "identifier": "THIRD_PARTY_ADVERTISING", "purpose": "Third-Party Advertising" }, { "dataCategories": [ { "dataCategory": "Identifiers", "dataTypes": [ "Device ID" ], "identifier": "IDENTIFIERS" }, { "dataCategory": "Usage Data", "dataTypes": [ "Advertising Data" ], "identifier": "USAGE_DATA" } ], "identifier": "DEVELOPERS_ADVERTISING", "purpose": "Developer’s Advertising or Marketing" }, ... ] } ] }, "requirementsByDeviceFamily": { "iphone": { "deviceFamily": "iPhone", "requirementString": "Requires iOS 12.0 or later." } }, "sellerLabel": "Seller", "supportsStreamlinedBuy": true, "type": "apps", "url": "https://apps.apple.com/us/app/whatsapp-business/id1386412985", "userRating": { "ariaLabelForRatings": "4.7 stars", "ratingCount": 904367, "ratingCountList": [ 27464, 13775, 24636, 50328, 788164 ], "value": 4.7 }, "usesLocationBackgroundMode": true } ``` #### Reviews ```yaml [ { "date": "2022-11-13T05:01:38Z", "id": "9284136374", "rating": 5, "review": "I sincerely love WhatsApp Business because with this app I could assigned a telephone number to my business and separate my personal number from it. It’s so genuinely designed for businesses with all the features you can apply it on your account; like: arrange chats, assign labels for easy follow ups, quick replies, have available business hours for your possible clientele! It’s amazing! \n\nI would love it even more, if WhatsApp Inc., could have WhatsApp Business compatible with iPad, because a great volume of businesses have an iPad for their daily business operation's. It could work with WiFi Only iPad’s and also with the iPad’s that work with cellular connection. It would be a tremendous great opportunity to continue with the growth of WABusiness downloads with a next update making it available and compatible for iPad.", "title": "iPad Compatibility", "type": "user-reviews", "userName": "Tax Business Owner" }, ] ``` #### Developer ```yaml { "hasApps": true, "id": "310634000", "ios-apps": [ { "artistName": "WhatsApp Inc.", "id": "1386412985", "name": "WhatsApp Business", "type": "apps", "url": "https://apps.apple.com/us/app/whatsapp-business/id1386412985", ... }, { "artistName": "WhatsApp Inc.", "id": "310633997", "name": "WhatsApp Messenger", "type": "apps", "url": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997", ... } ], "mac-apps": [ { "artistName": "WhatsApp Inc.", "id": "310633997", "name": "WhatsApp Messenger", "type": "apps", "url": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997", ... } ], "mediaType": "Mobile Software Applications", "name": "WhatsApp Inc.", "type": "developers", "url": "https://apps.apple.com/us/developer/whatsapp-inc/id310634000" } ``` ### 🍏 Support ⚡️ Feel free to [reach out](https://console.apify.com/actors/dkm7WYvEzkngwO6vb/issues) to the developer for any issues or suggestions for improvement. # Actor input Schema ## `query` (type: `array`): 💡 Search Terms, Query, or Start URL(s) ## `limit` (type: `integer`): 💡 Number of results ## `country` (type: `string`): 💡 Default to US (United States) ## `dev_proxy_config` (type: `object`): 💡 Supported protocol:

HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port

Example: socks5://example.com:9000 ## `dev_custom_headers` (type: `array`): 💡 Additional HTTP Headers ## `dev_custom_cookies` (type: `array`): 💡 Additional HTTP Cookies ## `dev_transform_fields` (type: `array`): 💡 Transform the resulting output. Select only needed fields.

For nested object use DOT. For example: 
address.streetAddress

For nested array use NUMBER (index of array element starting from index=0). For example: 
images.0.url
## `dev_dataset_name` (type: `string`): 💡 Save results into custom named Dataset, use mask to customize dataset name

{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)

This masks can be used to autogenerate Dataset Name.

example: data-{DATE}
Depending on today date the dataset name will be: data-20230603

default: data-{ACTOR}-{DATE}-{TIME} ## `dev_dataset_clear` (type: `boolean`): Clear Dataset before insert/update. ## `dev_no_strip` (type: `boolean`): 💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING) ## Actor input object example ```json { "query": [ "google", "https://apps.apple.com/us/developer/whatsapp-inc/id310634000", "https://apps.apple.com/us/app/whatsapp-business/id1386412985", "app:1386412985/reviews" ], "limit": 5 } ``` # 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 = { "query": [ "google", "https://apps.apple.com/us/developer/whatsapp-inc/id310634000", "https://apps.apple.com/us/app/whatsapp-business/id1386412985", "app:1386412985/reviews" ], "limit": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("jupri/apple-apps").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 = { "query": [ "google", "https://apps.apple.com/us/developer/whatsapp-inc/id310634000", "https://apps.apple.com/us/app/whatsapp-business/id1386412985", "app:1386412985/reviews", ], "limit": 5, } # Run the Actor and wait for it to finish run = client.actor("jupri/apple-apps").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 '{ "query": [ "google", "https://apps.apple.com/us/developer/whatsapp-inc/id310634000", "https://apps.apple.com/us/app/whatsapp-business/id1386412985", "app:1386412985/reviews" ], "limit": 5 }' | apify call jupri/apple-apps --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jupri/apple-apps", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "APPLE Apps Extractor", "description": "💫 All-in-One Apple APPS Scraper", "version": "0.1", "x-build-id": "45wypdcqfyX3VLGfv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jupri~apple-apps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jupri-apple-apps", "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/jupri~apple-apps/runs": { "post": { "operationId": "runs-sync-jupri-apple-apps", "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/jupri~apple-apps/run-sync": { "post": { "operationId": "run-sync-jupri-apple-apps", "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", "properties": { "query": { "title": "❓ Query", "type": "array", "description": "💡 Search Terms, Query, or Start URL(s)", "items": { "type": "string" } }, "limit": { "title": "♾️ Limit", "type": "integer", "description": "💡 Number of results" }, "country": { "title": "🧭 Country", "enum": [ "ai", "ag", "ar", "am", "au", "at", "az", "bs", "bh", "by", "be", "bz", "bm", "bo", "bw", "br", "bn", "bg", "kh", "ca", "cv", "ky", "cl", "co", "cr", "cy", "cz", "dk", "dm", "do", "ec", "eg", "sv", "ee", "fj", "fi", "fr", "gm", "de", "gh", "gr", "gd", "gt", "gw", "hn", "hk", "hu", "in", "id", "ie", "il", "it", "jp", "jo", "kr", "la", "lv", "lb", "lt", "lu", "mo", "my", "mt", "mu", "mx", "fm", "md", "mn", "mz", "na", "nl", "nz", "ni", "ne", "no", "om", "pa", "py", "pe", "ph", "pl", "pt", "qa", "ru", "sa", "sg", "sk", "si", "za", "es", "lk", "kn", "sz", "se", "ch", "tw", "tj", "th", "tt", "tr", "tm", "ug", "ua", "ae", "gb", "us", "ve", "vn", "vg", "zw" ], "type": "string", "description": "💡 Default to US (United States)" }, "dev_proxy_config": { "title": "🌐 PROXY NETWORKING", "type": "object", "description": "💡 Supported protocol:

HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port

Example: socks5://example.com:9000" }, "dev_custom_headers": { "title": "📜 HTTP HEADERS", "type": "array", "description": "💡 Additional HTTP Headers", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_custom_cookies": { "title": "🍰 HTTP COOKIES", "type": "array", "description": "💡 Additional HTTP Cookies", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_transform_fields": { "title": "♻️ CUSTOM FIELD", "type": "array", "description": "💡 Transform the resulting output. Select only needed fields.

For nested object use DOT. For example: 
address.streetAddress

For nested array use NUMBER (index of array element starting from index=0). For example: 
images.0.url
", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_dataset_name": { "title": "📁 CUSTOM STORAGE", "type": "string", "description": "💡 Save results into custom named Dataset, use mask to customize dataset name

{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)

This masks can be used to autogenerate Dataset Name.

example: data-{DATE}
Depending on today date the dataset name will be: data-20230603

default: data-{ACTOR}-{DATE}-{TIME}" }, "dev_dataset_clear": { "title": "Clear Storage", "type": "boolean", "description": "Clear Dataset before insert/update." }, "dev_no_strip": { "title": "Disable data cleansing", "type": "boolean", "description": "💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)" } } }, "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 } } } } } } } } } } ```