# StatCite — Economic Data & Stat Verification (with citations) (`asokore/statcite-economic-data`) Actor Official economic statistics with full citations — World Bank, IMF WEO, ECB — plus verify\_stat: check any claimed figure against the official series. 42 indicators, 200+ economies, ~120 currencies, inflation adjustment, historical FX. - **URL**: https://apify.com/asokore/statcite-economic-data.md - **Developed by:** [Asokore Beckles](https://apify.com/asokore) (community) - **Categories:** MCP servers, Agents - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 statcite queries This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## StatCite — Economic Data & Stat Verification (with citations) **Official economic statistics where every number ships with its citation — plus a verifier that checks any claimed figure against the official series.** Built and curated by a professional economist. AI agents and analysts constantly need macro numbers they can defend: GDP growth, inflation, unemployment, government debt, exchange rates. This actor returns the official value **and the receipt** — source, dataset, series ID, canonical URL, license, retrieval date, and a ready-to-paste citation sentence. ### What it does | Operation | What you get | |---|---| | `indicator` | Values for any of **42 curated indicators** (inflation, GDP growth, debt/GDP, current account, FDI, …) for **200+ economies**, with citation | | `verify` | **Check a claimed figure** against the official series → `match / close / mismatch / cannot_verify`, with diagnostics (wrong year? percent-vs-decimal? millions-vs-billions?) and the correct citable value | | `snapshot` | 11 headline indicators for one country, each with its own citation — instant country brief | | `inflation` | "What is \$100 (1995) worth in 2025 money?" — CPI-ratio method, formula disclosed, any country | | `fx` | Currency conversion: ECB daily reference rates (~30 majors since 1999) + official annual rates for ~90 more currencies (BBD, XCD, JMD, KES…) | | `series` | Raw access: `worldbank/CODE`, `dbnomics/IMF/WEO:latest/...` | | `search` / `registry` | Discover indicators and datasets | ### Sources World Bank World Development Indicators (CC BY 4.0) · IMF World Economic Outlook via DBnomics · ECB euro reference rates · optional FRED. Data is fetched live from official APIs — this actor adds no numbers of its own, and labels IMF projections as projections. ### Example: verify a stat before publishing Input: ```json { "operation": "verify", "indicator": "inflation_cpi", "country": "USA", "period": "2023", "claimed_value": 4.1 } ```` Output (dataset item): ```json { "ok": true, "result": { "verdict": "match", "official_value": 4.116338, "explanation": "Claimed 4.1 vs official 4.1163 % for 2023 — consistent (within normal rounding).", "citation": { "source": "World Bank", "series_id": "FP.CPI.TOTL.ZG", "source_url": "https://data.worldbank.org/indicator/FP.CPI.TOTL.ZG?locations=USA", "license": "CC BY 4.0", "citation_text": "World Bank, World Development Indicators, series FP.CPI.TOTL.ZG (Inflation, consumer prices, annual %) …" } } } ``` ### Batch mode Pass `items` (array of parameter objects, each may set its own `operation`) to run many queries in one call — one pay-per-event charge per **successful** item; failures are free and reported per item. ```json { "operation": "indicator", "items": [ { "operation": "verify", "indicator": "gdp_growth", "country": "Guyana", "period": "2022", "claimed_value": 62.3 }, { "operation": "indicator", "indicator": "govt_debt_gdp", "country": "Japan", "latest_only": true }, { "operation": "fx", "amount": 1000, "from": "USD", "to": "JMD", "date": "2023" } ] } ``` ### Pricing Pay per successful query event — failures are never charged. A generous free web tier of the same engine exists at [statcite.com](https://statcite.com) (MCP + REST); this actor is for pipelines that want Apify-managed runs, storage, scheduling, and invoicing. ### Use from AI agents (MCP) Via the [Apify MCP server](https://mcp.apify.com), agents can discover and call this actor directly. There is also a free hosted MCP endpoint at `https://statcite.com/mcp`. ### Support hello@statcite.com · [statcite.com/docs.html](https://statcite.com/docs.html) # Actor input Schema ## `operation` (type: `string`): What to do: indicator (get values), verify (check a claimed figure), snapshot (country overview), inflation (adjust across years), fx (convert currencies), series (raw series id), search, registry (list indicators). ## `indicator` (type: `string`): e.g. inflation\_cpi, gdp\_growth, unemployment\_rate, govt\_debt\_gdp (run operation=registry for the full list). ## `country` (type: `string`): ISO3/ISO2 code or English name, e.g. USA, Barbados, Japan. ## `period` (type: `string`): Year of the claim, e.g. 2024. ## `claimed_value` (type: `string`): The figure to check, in the series' own units. ## `start_year` (type: `integer`): Optional: only return observations from this year onward. ## `end_year` (type: `integer`): Optional: only return observations up to this year. ## `latest_only` (type: `boolean`): Return just the most recent published observation. ## `transform` (type: `string`): Computed transform (with method note). ## `series_id` (type: `string`): worldbank/CODE, fred/ID, or dbnomics/PROVIDER/DATASET/SERIES. ## `amount` (type: `string`): Numeric amount. ## `from_year` (type: `integer`): The year the amount is denominated in, e.g. 1995. ## `to_year` (type: `integer`): The year to convert the amount into, e.g. 2025. ## `from` (type: `string`): ISO 4217, e.g. USD. ## `to` (type: `string`): ISO 4217, e.g. BBD. ## `date` (type: `string`): YYYY-MM-DD (daily) or YYYY (annual average). ## `query` (type: `string`): Free-text search over indicators and DBnomics datasets. ## `items` (type: `array`): Optional: array of parameter objects to run in one call (each may set its own operation). One pay-per-event charge per successful item. ## Actor input object example ```json { "operation": "indicator", "indicator": "inflation_cpi", "country": "USA", "latest_only": false, "transform": "none" } ``` # Actor output Schema ## `results` (type: `string`): Every item from this run: `ok`, `operation`, plus `result` (with citation) or `error`. # 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 = { "indicator": "inflation_cpi", "country": "USA" }; // Run the Actor and wait for it to finish const run = await client.actor("asokore/statcite-economic-data").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 = { "indicator": "inflation_cpi", "country": "USA", } # Run the Actor and wait for it to finish run = client.actor("asokore/statcite-economic-data").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 '{ "indicator": "inflation_cpi", "country": "USA" }' | apify call asokore/statcite-economic-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=asokore/statcite-economic-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "StatCite — Economic Data & Stat Verification (with citations)", "description": "Official economic statistics with full citations — World Bank, IMF WEO, ECB — plus verify_stat: check any claimed figure against the official series. 42 indicators, 200+ economies, ~120 currencies, inflation adjustment, historical FX.", "version": "1.0", "x-build-id": "8jMaQJV0Io7uRVMOi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/asokore~statcite-economic-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-asokore-statcite-economic-data", "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/asokore~statcite-economic-data/runs": { "post": { "operationId": "runs-sync-asokore-statcite-economic-data", "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/asokore~statcite-economic-data/run-sync": { "post": { "operationId": "run-sync-asokore-statcite-economic-data", "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": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "indicator", "verify", "snapshot", "inflation", "fx", "series", "search", "registry" ], "type": "string", "description": "What to do: indicator (get values), verify (check a claimed figure), snapshot (country overview), inflation (adjust across years), fx (convert currencies), series (raw series id), search, registry (list indicators).", "default": "indicator" }, "indicator": { "title": "Indicator key", "type": "string", "description": "e.g. inflation_cpi, gdp_growth, unemployment_rate, govt_debt_gdp (run operation=registry for the full list)." }, "country": { "title": "Country", "type": "string", "description": "ISO3/ISO2 code or English name, e.g. USA, Barbados, Japan." }, "period": { "title": "Period (verify)", "type": "string", "description": "Year of the claim, e.g. 2024." }, "claimed_value": { "title": "Claimed value (verify)", "type": "string", "description": "The figure to check, in the series' own units." }, "start_year": { "title": "Start year", "type": "integer", "description": "Optional: only return observations from this year onward." }, "end_year": { "title": "End year", "type": "integer", "description": "Optional: only return observations up to this year." }, "latest_only": { "title": "Latest value only", "type": "boolean", "description": "Return just the most recent published observation.", "default": false }, "transform": { "title": "Transform", "enum": [ "none", "yoy", "pct_change", "index" ], "type": "string", "description": "Computed transform (with method note).", "default": "none" }, "series_id": { "title": "Series id (series)", "type": "string", "description": "worldbank/CODE, fred/ID, or dbnomics/PROVIDER/DATASET/SERIES." }, "amount": { "title": "Amount (inflation / fx)", "type": "string", "description": "Numeric amount." }, "from_year": { "title": "From year (inflation)", "type": "integer", "description": "The year the amount is denominated in, e.g. 1995." }, "to_year": { "title": "To year (inflation)", "type": "integer", "description": "The year to convert the amount into, e.g. 2025." }, "from": { "title": "From currency (fx)", "type": "string", "description": "ISO 4217, e.g. USD." }, "to": { "title": "To currency (fx)", "type": "string", "description": "ISO 4217, e.g. BBD." }, "date": { "title": "Date (fx)", "type": "string", "description": "YYYY-MM-DD (daily) or YYYY (annual average)." }, "query": { "title": "Query (search)", "type": "string", "description": "Free-text search over indicators and DBnomics datasets." }, "items": { "title": "Batch items", "type": "array", "description": "Optional: array of parameter objects to run in one call (each may set its own operation). One pay-per-event charge per successful item." } } }, "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 } } } } } } } } } } ```