# Export Intelligence Monitor (`datapilot/export-intelligence-monitor`) Actor A comprehensive export intelligence scraper that combines World Bank trade indicators, UN Comtrade data, Google News regulations, and competitor insights. It delivers export trends, market intelligence, compliance alerts, top trading partners, and actionable - **URL**: https://apify.com/datapilot/export-intelligence-monitor.md - **Developed by:** [Data Pilot](https://apify.com/datapilot) (community) - **Categories:** News, Developer tools, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 scraped results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Export Intelligence Monitor 🌍 **Export Intelligence Monitor** is a powerful Apify Actor designed to aggregate and analyze comprehensive **Export Intelligence** data from multiple authoritative sources including World Bank, UN Comtrade, and regulatory news. This tool provides detailed **Export Intelligence** including trade flows, market regulations, competitor activity, and export metrics. Whether you're analyzing export markets, monitoring trade trends, or conducting competitive intelligence, the Export Intelligence Monitor delivers actionable **Export Intelligence** insights efficiently. With multi-source integration from World Bank, UN Comtrade, and news feeds, comprehensive country/product support, intelligent data aggregation, and PPE billing, the Export Intelligence Monitor ensures complete **Export Intelligence** discovery. It focuses on key **Export Intelligence** metrics including trade values, regulatory changes, and competitor activities, making it an essential tool for **Export Intelligence** research and international trade analysis. --- ### 📋 Table of Contents - [Features](#-features) - [Data Sources](#-data-sources) - [How It Works](#-how-it-works) - [Input](#-input) - [Output](#-output) - [Technical Stack](#-technical-stack) - [Data Fields](#-data-fields) - [Supported Countries](#-supported-countries) - [Use Cases](#-use-cases) - [Quick Start](#-quick-start) - [Configuration](#-configuration) - [Performance](#-performance) - [Billing](#-billing) - [Important Notes](#-important-notes) - [Keywords](#-keywords) - [Changelog](#-changelog) - [Support](#-support) --- ### 🔥 Features - **World Bank Integration** – Fetches trade indicators from World Bank API (10 key indicators). - **UN Comtrade Integration** – Queries UN Comtrade for detailed trade flow data. - **Product/HS Code Support** – Search by HS (Harmonized System) code or "TOTAL" for all products. - **Country Coverage** – Supports 25+ countries with automatic code mapping. - **Trade Indicators** – Extracts merchandise exports, imports, trade % of GDP, and specialized metrics. - **Export Flow Data** – Captures export volumes, values, and partner information. - **Regulatory Monitoring** – Tracks export regulations and restrictions via news monitoring. - **Competitor Intelligence** – Identifies competing exporters and market leaders. - **Multi-Year Support** – Configurable year for historical and current data. - **Company Extraction** – Automatically extracts company names from news sources. - **Partner Analysis** – Identifies top trading partners for products. - **Yearly Trends** – Tracks export value trends over time. - **Regulatory Alerts** – Aggregates regulatory news and restrictions. - **Competitor Tracking** – Monitors competitor export activity and news. - **Summary Generation** – Generates comprehensive market intelligence summary. - **Data Aggregation** – Combines data from 4 sources into coherent intelligence. - **PPE Billing Integration** – Pay-per-event billing per **Export Intelligence** record. - **Charge Limit Handling** – Respects user's maximum PPE charge limits. - **Proxy Support** – Apify residential proxy support for reliability. - **Real-Time Dataset Push** – Pushes results to Apify Dataset with metadata. - **Detailed Logging** – Comprehensive logging of charges and progress. - **Asyncio-Friendly** – Non-blocking async/await architecture. --- ### 🌍 Data Sources #### **1. World Bank API** - **Authority**: Official World Bank trade data - **Coverage**: 200+ countries and regions - **Data**: 10 key trade indicators - **Indicators**: - Merchandise exports (USD) - Exports of goods & services (USD) - Manufactures exports (% of merchandise) - Agricultural exports (% of merchandise) - Fuel exports (% of merchandise) - High-tech exports (% of manufactured) - Trade % of GDP - Imports data - And more #### **2. UN Comtrade** - **Authority**: United Nations trade database - **Coverage**: Detailed trade flows by product - **Data**: Trade values, volumes, partners, weights - **HS Codes**: Full Harmonized System classification - **Granularity**: Country-pair, product-level trade data #### **3. Google News (Regulations)** - **Coverage**: Real-time regulatory news - **Data**: Export restrictions, bans, tariffs, compliance rules - **Freshness**: Latest regulatory changes - **Sources**: Official news outlets #### **4. Google News (Competitors)** - **Coverage**: Competitor activity and market news - **Data**: Company mentions, export deals, market share - **Freshness**: Latest industry developments - **Intelligence**: Competitive positioning --- ### ⚙️ How It Works The Export Intelligence Monitor takes a product name, HS code, country, and year as inputs. It simultaneously fetches trade indicators from World Bank, detailed trade flows from UN Comtrade, regulatory news from Google News, and competitor activity. All data is aggregated, deduplicated, analyzed for market insights, and pushed to the dataset with PPE charging. A comprehensive summary is generated for strategic intelligence. **Key Processing Steps:** 1. **Input Parsing** – Accept product, HS code, country, year 2. **Proxy Setup** – Configure Apify residential proxy 3. **Country Mapping** – Convert country name to ISO codes 4. **World Bank Fetch** – Query 10 trade indicators 5. **Comtrade Fetch** – Query detailed trade flows 6. **Regulatory Fetch** – Query Google News for regulations 7. **Competitor Fetch** – Query Google News for competitors 8. **Data Aggregation** – Combine all sources 9. **Summary Generation** – Build market intelligence 10. **Company Extraction** – Extract and rank companies 11. **Partner Analysis** – Identify top trading partners 12. **Trend Analysis** – Analyze yearly trends 13. **Dataset Push** – Push all records 14. **PPE Charging** – Charge per record 15. **Completion** – Report statistics **Key Benefits:** - Understand **Export Intelligence** market dynamics - Monitor regulatory changes and compliance - Track competitor export activities - Identify market opportunities - Analyze trade patterns and trends - Make informed trading decisions --- ### 📥 Input The Actor accepts the following input parameters: | Field | Type | Default | Description | |-------|------|---------|-------------| | `product` | string | required | Product name or description (e.g., "textiles", "machinery") | | `hsCode` | string | "TOTAL" | HS Code for product (or "TOTAL" for all products) | | `country` | string | required | Exporting country (e.g., "Bangladesh", "Vietnam", "China") | | `year` | integer | `2022` | Year for trade data (e.g., 2022, 2023, 2024) | | `useApifyProxy` | boolean | `true` | Enable Apify residential proxies | | `apifyProxyGroups` | array | `["RESIDENTIAL"]` | Proxy group configuration | **Example Input:** ```json { "product": "textiles", "hsCode": "6204", "country": "Bangladesh", "year": 2023, "useApifyProxy": true } ```` **All Products Example:** ```json { "product": "electronics", "hsCode": "TOTAL", "country": "China", "year": 2024 } ``` *** ### 📤 Output The Actor pushes **Export Intelligence** records with the following structure: **World Bank Record:** ```json { "source": "World Bank", "data_type": "trade_indicator", "country": "Bangladesh", "country_code": "BD", "indicator": "Merchandise exports (USD)", "indicator_code": "TX.VAL.MRCH.CD.WT", "year": "2023", "value": "47234000000", "unit": "USD", "scraped_at": "2025-02-14T12:00:00" } ``` **Comtrade Record:** ```json { "source": "UN Comtrade", "data_type": "trade_flow", "hs_code": "6204", "hs_description": "Women's or girls' suits, jackets, blazers, dresses, skirts, trousers", "reporter": "Bangladesh", "partner": "United States", "year": "2023", "trade_flow": "Export", "trade_value_usd": "5234567000", "net_weight_kg": "123456789", "quantity": "45678", "scraped_at": "2025-02-14T12:00:00" } ``` **Regulation Record:** ```json { "source": "Google News", "data_type": "regulation", "product": "textiles", "country": "Bangladesh", "title": "New export restrictions on textiles announced", "description": "Bangladesh government announces new tariff policies...", "news_source": "News Agency", "date": "2025-02-10", "url": "https://news.example.com/...", "scraped_at": "2025-02-14T12:00:00" } ``` **Competitor Record:** ```json { "source": "Google News", "data_type": "competitor", "product": "textiles", "country": "Bangladesh", "title": "Bangladesh textile exports surge with new manufacturing deals", "description": "Major textile exporters expand capacity...", "companies_mentioned": "Company A, Company B, Company C", "news_source": "Business News", "date": "2025-02-12", "url": "https://news.example.com/...", "scraped_at": "2025-02-14T12:00:00" } ``` **Summary Record:** ```json { "type": "SUMMARY", "summary": { "product": "textiles", "country": "Bangladesh", "generated_at": "2025-02-14T12:00:00", "trade_summary": { "total_export_value_usd": "47234000000", "comtrade_records": 45, "top_partners": [ { "country": "United States", "value_usd": "5234567000" }, { "country": "EU", "value_usd": "3456789000" } ], "yearly_trend": [ {"year": "2022", "value_usd": "45000000000"}, {"year": "2023", "value_usd": "47234000000"} ] }, "worldbank_highlights": { "Merchandise exports (USD)": { "value": "47234000000", "year": "2023" } }, "regulation_alerts": { "count": 8, "alerts": [ { "title": "New export restrictions announced", "date": "2025-02-10", "source": "Official News" } ] }, "competitor_intelligence": { "top_companies": ["Company A", "Company B", "Company C"], "news_count": 12, "recent": [ { "title": "Major export deals signed", "companies": "Company A, Company B", "date": "2025-02-12" } ] } } } ``` *** ### 🧰 Technical Stack - **APIs:** World Bank REST API, UN Comtrade API - **News Feeds:** Google News RSS - **HTML/XML Parsing:** BeautifulSoup - **Async:** asyncio for non-blocking operations - **Data Structure:** Collections (Counter, defaultdict) - **Regex:** Pattern matching for company extraction - **Proxy:** Apify Proxy with RESIDENTIAL configuration - **Logging:** Apify Actor logging system - **Platform:** Apify Actor serverless environment - **Billing:** Apify PPE (Pay-Per-Event) system *** ### 📊 Data Fields Explained #### **Trade Data** - **trade\_value\_usd**: Export value in US dollars - **partner**: Trading partner country - **year**: Calendar year - **hs\_code**: Harmonized System code #### **Indicators** - **indicator**: Type of trade metric - **value**: Numerical value - **unit**: Measurement unit (USD, %) #### **Regulatory** - **regulation**: Export restriction or policy - **date**: When regulation was announced - **description**: Details of regulation #### **Competitor** - **companies\_mentioned**: Exporting companies - **market\_activity**: Export deals and news - **date**: When activity occurred *** ### 🌍 Supported Countries The Actor supports 25+ countries including: - **Americas**: USA, Canada, Brazil, Mexico - **Europe**: UK, Germany, France, Italy, Spain, Netherlands - **Asia**: China, India, Japan, Singapore, Vietnam, Thailand, South Korea, Indonesia, Pakistan, Bangladesh - **Middle East**: UAE, Egypt, Turkey - **Oceania**: Australia Use country names or common abbreviations. *** ### 🎯 Use Cases - **Market Research** – Research **Export Intelligence** for target markets - **Trade Analysis** – Analyze export trends and opportunities - **Regulatory Compliance** – Monitor export restrictions and regulations - **Competitor Intelligence** – Track competitor export activities - **Supply Chain Planning** – Plan exports based on market data - **Export Strategy** – Develop export strategies using **Export Intelligence** - **Risk Assessment** – Assess export market risks and opportunities - **Investment Analysis** – Evaluate export market attractiveness - **Trade Negotiations** – Gather data for trade discussions - **Market Entry** – Research target markets for product exports - **Trend Analysis** – Identify growing export opportunities - **Regulation Tracking** – Monitor changing export regulations - **Partner Identification** – Identify potential export partners - **Competitive Positioning** – Understand competitive landscape - **Business Intelligence** – Gather market intelligence for decisions *** ### 🚀 Quick Start #### **1. Prepare Input** Go to Apify Console and enter: ```json { "product": "textiles", "hsCode": "6204", "country": "Bangladesh", "year": 2023, "useApifyProxy": true } ``` #### **2. Run the Actor** Click **Start** button. The Actor will: - Fetch World Bank indicators - Query UN Comtrade data - Monitor regulatory news - Track competitor activity - Generate summary - Push to Dataset #### **3. Monitor Progress** Console shows: ``` Product: textiles | HS: 6204 | Country: Bangladesh | Year: 2023 Proxy active: RESIDENTIAL [World Bank] Fetching trade indicators... [UN Comtrade] HS:6204 | Bangladesh | 2023 [Regulations] textiles export rules for Bangladesh [Competitors] textiles export activity Summary pushed. ✅ [CHARGED] Record saved | Source: World Bank | Type: trade_indicator | Total: 1 ✅ [CHARGED] Record saved | Source: UN Comtrade | Type: trade_flow | Total: 2 ... 🎉 Done! WorldBank=10 | Comtrade=45 | Regulations=8 | Competitors=12 | Total charged=75 ``` #### **4. View & Download Results** - **Results Tab**: All **Export Intelligence** records + summary - **Export**: JSON, CSV, Excel - **Filter**: By data type or source - **Sort**: By trade value or date *** ### ⚙️ Configuration #### **Product Search** Specific HS Code: ```json { "hsCode": "6204" } ``` All products: ```json { "hsCode": "TOTAL" } ``` #### **Time Period** Current year: ```json { "year": 2024 } ``` Historical: ```json { "year": 2020 } ``` *** ### 📈 Performance #### **Processing Speed** - \~30-60 seconds for all sources - \~50-100 records per search - Concurrent API requests - News parsing adds ~20-30 seconds #### **Resource Usage** - Memory: ~100-200MB - CPU: ~40-50% during processing - Network: ~3-8MB per search - API calls: ~4-6 depending on data *** ### 💰 Billing #### **PPE (Pay-Per-Event) Billing** - **Event Name:** "scraped-result" - **Charge:** 1 credit per **Export Intelligence** record - **Billing Trigger:** Per record (WB, Comtrade, regulation, competitor) - **Typical Cost:** 50-100 credits per search #### **Cost Examples** - 10 WB indicators + 45 Comtrade + 8 regulations + 12 competitors = 75 credits - 10 WB + 20 Comtrade + 5 regulations + 8 competitors = 43 credits *** ### ⚠️ Important Notes #### **Legal & Compliance** - **Fair Use**: Respects API rate limits and ToS - **Attribution**: Respects data sources (World Bank, UN) - **Accuracy**: Data as provided by official sources - **Proxy**: Recommended for reliability - **Rate Limiting**: Includes appropriate delays #### **Data Quality** - **Completeness**: Varies by country/product - **Freshness**: World Bank yearly, Comtrade updated, news real-time - **Accuracy**: Official source data - **Availability**: Depends on source coverage - **Verification**: Always verify with official sources #### **Best Practices** - Use residential proxies - Respect API rate limits - Verify trade data independently - Check regulatory news with official sources - Validate competitor information - Monitor for data updates - Follow export regulations - Consult trade experts ### 📦 Changelog **Initial Release:** - World Bank API integration (10 indicators) - UN Comtrade API integration (2 endpoints) - Google News RSS parsing for regulations - Google News RSS parsing for competitors - Country code mapping (25+ countries) - HS Code support (or "TOTAL" for all) - Multi-year data support - Trade indicator extraction - Trade flow aggregation - Regulatory news aggregation - Company name extraction - Partner country identification - Yearly trend analysis - Summary generation - Trade summary statistics - Sentiment/regulatory alert compilation - Competitor intelligence ranking - PPE billing per record - Charge limit detection - Apify proxy support - Real-time Dataset push - Detailed progress logging - Comprehensive error handling - Asyncio executor support *** ### 🧑‍💻 Support & Feedback - **Issues:** Submit via Apify console with product/country - **Documentation:** Check Actor details page - **Community:** Apify forum discussions - **Feature Requests:** Suggest new data sources - **Bug Reports:** Include inputs and error details *** ### 💾 Apify Integration #### **Automatic Features** ```python ## Multi-source fetching wb_data = fetch_worldbank(country, session) comtrade = fetch_comtrade(hs_code, country, year, session) reg_data = fetch_regulations(product, country, session) comp_data = fetch_competitors(product, country, session) ## Real-time Dataset push await dataset.push_data(row) ## PPE charging per record charge_result = await Actor.charge(event_name=PPE_EVENT_NAME) ``` #### **Output Access** - **Results Tab**: All **Export Intelligence** records - **Export**: JSON, CSV, Excel - **Filter**: By source or type - **API**: Query via Apify API *** ### 📄 License & Legal **Terms of Use:** - Use for legitimate trade research - Respect all source ToS and rate limits - Respect data sources and attribution - Don't republish without permission - Comply with trade regulations - Use data ethically and responsibly **Disclaimer:** Export Intelligence Monitor is provided as-is for research purposes. Users are responsible for ensuring compliance with World Bank, UN, and trade regulations. Always verify data with official sources. *** ### 🎉 Get Started Today **Deploy now for **Export Intelligence** research!** Use for: - 📊 Trade Research - 🔍 Market Analysis - 💡 Export Planning - 📈 Trend Tracking - 🎯 Regulatory Monitoring **Perfect for:** - Exporters - Trade Analysts - Business Strategists - Market Researchers - Trade Compliance Officers *** **Last Updated:** February 2025\ **Version:** 1.0.0\ **Status:** Production Ready\ **Platform:** Apify Actor\ **Architecture:** Async/Await\ **Sources:** 4 (World Bank, Comtrade, Regulations, Competitors)\ **Countries Supported:** 25+ *** ### 📚 Related Tools - Developer Tools Scraper - App Review Intelligence Monitor - Business Social Media Finder - Google Keyword Finder **Your complete Apify-powered **Export Intelligence** analysis solution!** 🚀✨ *** ### 🌍 Export Intelligence Excellence This Actor is optimized for **Export Intelligence** research with: - ✅ Multi-source aggregation (4 sources) - ✅ World Bank API integration - ✅ UN Comtrade integration - ✅ Regulatory monitoring - ✅ Competitor intelligence - ✅ Summary generation - ✅ PPE billing support - ✅ Real-time Dataset push - ✅ Error recovery - ✅ Production-ready code **Analyze export markets effortlessly!** 💎🚀 # Actor input Schema ## `product` (type: `string`): Product to research. e.g: textile, steel, electronics, wheat, pharmaceuticals ## `country` (type: `string`): Country to analyze. e.g: Bangladesh, India, China, USA, Vietnam ## `hsCode` (type: `string`): Harmonized System commodity code. e.g: 61=clothing, 72=steel, 85=electronics, 10=cereals, 27=fuel. Leave blank for TOTAL. ## `year` (type: `integer`): Trade data year to query from UN Comtrade. ## `useApifyProxy` (type: `boolean`): Recommended to avoid rate limiting from news sources. ## `apifyProxyGroups` (type: `array`): RESIDENTIAL works best for Google News scraping. ## Actor input object example ```json { "product": "textile", "country": "Bangladesh", "hsCode": "61", "year": 2022, "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } ``` # 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 = { "product": "textile", "country": "Bangladesh", "hsCode": "61" }; // Run the Actor and wait for it to finish const run = await client.actor("datapilot/export-intelligence-monitor").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 = { "product": "textile", "country": "Bangladesh", "hsCode": "61", } # Run the Actor and wait for it to finish run = client.actor("datapilot/export-intelligence-monitor").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 '{ "product": "textile", "country": "Bangladesh", "hsCode": "61" }' | apify call datapilot/export-intelligence-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datapilot/export-intelligence-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Export Intelligence Monitor", "description": "A comprehensive export intelligence scraper that combines World Bank trade indicators, UN Comtrade data, Google News regulations, and competitor insights. It delivers export trends, market intelligence, compliance alerts, top trading partners, and actionable", "version": "0.0", "x-build-id": "k5t0IsByrf38EsC9G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datapilot~export-intelligence-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datapilot-export-intelligence-monitor", "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/datapilot~export-intelligence-monitor/runs": { "post": { "operationId": "runs-sync-datapilot-export-intelligence-monitor", "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/datapilot~export-intelligence-monitor/run-sync": { "post": { "operationId": "run-sync-datapilot-export-intelligence-monitor", "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": [ "product", "country" ], "properties": { "product": { "title": "Product Name", "type": "string", "description": "Product to research. e.g: textile, steel, electronics, wheat, pharmaceuticals" }, "country": { "title": "Exporting Country", "type": "string", "description": "Country to analyze. e.g: Bangladesh, India, China, USA, Vietnam" }, "hsCode": { "title": "HS Code (optional)", "type": "string", "description": "Harmonized System commodity code. e.g: 61=clothing, 72=steel, 85=electronics, 10=cereals, 27=fuel. Leave blank for TOTAL." }, "year": { "title": "Year", "minimum": 2010, "maximum": 2024, "type": "integer", "description": "Trade data year to query from UN Comtrade.", "default": 2022 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Recommended to avoid rate limiting from news sources.", "default": true }, "apifyProxyGroups": { "title": "Proxy Groups", "uniqueItems": true, "type": "array", "description": "RESIDENTIAL works best for Google News scraping.", "items": { "type": "string", "enum": [ "RESIDENTIAL", "DATACENTER", "GOOGLE" ] }, "default": [ "RESIDENTIAL" ] } } }, "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 } } } } } } } } } } ```