# Argentina Economic Data API — inflation, USD, macro (no key) (`synthetic.ia/argentina-economic-data`) Actor

Official Argentine economic time series (Series de Tiempo, datos.gob.ar): inflation/CPI, official USD exchange rate, EMAE, employment, trade — 30,000+ series. Search indicators and pull aligned time series. No API key. HTTP API + MCP. Pay per query.

- **URL**: https://apify.com/synthetic.ia/argentina-economic-data.md
- **Developed by:** [Synthetic](https://apify.com/synthetic.ia) (community)
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 series queries

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Argentina Economic Data API — inflation, USD, macro (no key)

Argentina's official economic indicators as a clean HTTP API (and MCP tool). Search **30,000+ time series** from the national open-data portal — **inflation (CPI/IPC)**, the **official USD exchange rate**, **EMAE** (monthly activity), employment, wages, trade, monetary aggregates — and pull them as aligned, typed JSON. Official data (INDEC, Programación Macroeconómica, BCRA-sourced series via *Series de Tiempo*, `datos.gob.ar`), **no API key**, one price per query.

- 🔎 **Search** — find indicators by text (`inflación`, `tipo de cambio`, `EMAE`, `desempleo`) → series id + title + units + frequency + coverage + source.
- 📈 **Series** — fetch one or many series **aligned by date**, with date range, resampling (`collapse` to month/quarter/year), aggregation, and level/change/percent-change representations.
- 🇦🇷 **The Argentine surface almost nobody wraps for the world** — clean JSON, English-friendly output, ready for agents.
- 💵 Pay per query · no key · official data.

### The use case it was built for

Argentine macro data is authoritative and free, but scattered across INDEC, the central bank and dozens of datasets, each with its own format and series codes. Fintech apps, dashboards, newsrooms and analysts end up re-parsing the same portals. This Actor gives you one endpoint: **search** to discover the series id you need, then **series** to pull the values (single or multi-series, with the transforms you want). Perfect for an inflation tracker, a "blue vs official dollar" panel, or feeding a trading/econ agent over MCP.

### Sample output (`series`, CPI last 3 months)

```json
{
  "ids": ["148.3_INIVELNAL_DICI_M_26"],
  "columns": ["date", "148.3_INIVELNAL_DICI_M_26"],
  "frequency": "month",
  "series": [{ "id": "148.3_INIVELNAL_DICI_M_26", "title": "IPC nivel general",
               "units": "Índice", "publisher": "INDEC" }],
  "data": [["2026-04-01", 8234.1], ["2026-05-01", 8456.7], ["2026-06-01", 8611.2]]
}
```

### How to use

- **HTTP API (Standby):** POST or GET `/search`, `/series`. `GET /` returns help. Example: `GET /series?ids=168.1_T_CAMBIOR_D_0_0_26&last=30` (last 30 days of the official USD rate).
- **Normal run / daily job:** pass `{ operation, ... }` as input; the result lands in the dataset and key-value store.
- **MCP tool:** expose it to your agent via Apify's MCP server.

### Input

- **operation** — `search` or `series`.
- **q** — (search) text to find indicators.
- **ids** — (series) one or more series ids (from search), max 20 per query.
- **start\_date / end\_date** — `YYYY`, `YYYY-MM` or `YYYY-MM-DD`.
- **collapse** — resample: `day` · `week` · `month` · `quarter` · `year`; **aggregation** — `avg` · `sum` · `end_of_period` · `min` · `max`.
- **representation** — `value`, `change`, `percent_change`, `*_since_beginning_of_year`, `*_a_year_ago`.
- **last / limit** — last N observations, or a row cap. **metadata** — `none` · `simple` · `full`. **sort** — `asc` · `desc`.

### Pricing

**Per query** from **$0.01** (drops to $0.003 on higher tiers). One `search` or `series` call = one query; a `series` call can return many aligned series at once. Lightweight (pure HTTPS, no proxy/browser).

### Related Actors

- **[Yahoo Finance API](https://apify.com/synthetic.ia/yahoo-finance-api)** — global quotes, OHLCV, FX and fundamentals.
- **[CoinGecko Crypto API](https://apify.com/synthetic.ia/coingecko-crypto)** — crypto prices and markets.

### FAQ

**Do I need a key?** No. The datos.gob.ar Series de Tiempo API is keyless.

**How do I find a series id?** Use `search` with plain text (Spanish works best, e.g. `inflación`, `tipo de cambio`, `reservas`). Each result includes the `id` to pass to `series`.

**What about the BCRA's own API?** Its direct endpoints changed versions; this Actor uses *Series de Tiempo*, which already carries the dollar, inflation and reserves series, so you don't need to chase BCRA versions.

**Is this investment advice?** No — official statistics as-is; how you use them is your responsibility.

### Notes & limits

Data comes from the Argentine national open-data portal (`apis.datos.gob.ar`). Coverage and revisions follow the publishing agencies (INDEC, etc.). Max 20 series ids per `series` call.

# Changelog

This Actor's version history is a separate document: https://apify.com/synthetic.ia/argentina-economic-data/changelog.md

# Actor input Schema

## `operation` (type: `string`):

Search for indicators, or fetch time-series values.

## `q` (type: `string`):

For operation=search: text to find indicators, e.g. "inflación", "tipo de cambio", "EMAE", "desempleo".

## `ids` (type: `array`):

For operation=series: one or more series ids (find them with search). Max 20 per query.

## `start_date` (type: `string`):

Earliest date to return: YYYY, YYYY-MM or YYYY-MM-DD.

## `end_date` (type: `string`):

Latest date to return: YYYY, YYYY-MM or YYYY-MM-DD.

## `collapse` (type: `string`):

Resample to a coarser frequency. Empty = the series' native frequency.

## `aggregation` (type: `string`):

How to aggregate when collapsing.

## `representation` (type: `string`):

Transform the values (levels, or changes / percent changes).

## `last` (type: `integer`):

Return only the last N observations (overrides limit). 1-4000.

## `limit` (type: `integer`):

Max rows (series ≤5000, search ≤100).

## `offset` (type: `integer`):

For search pagination.

## `metadata` (type: `string`):

How much per-series metadata to include.

## `sort` (type: `string`):

Chronological order of the returned rows.

## Actor input object example

```json
{
  "operation": "series",
  "q": "inflación",
  "ids": [
    "148.3_INIVELNAL_DICI_M_26"
  ],
  "aggregation": "avg",
  "representation": "value",
  "metadata": "simple",
  "sort": "asc"
}
```

# Actor output Schema

## `result` (type: `string`):

The query result JSON.

## `runs` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "q": "inflación",
    "ids": [
        "148.3_INIVELNAL_DICI_M_26"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("synthetic.ia/argentina-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "q": "inflación",
    "ids": ["148.3_INIVELNAL_DICI_M_26"],
}

# Run the Actor and wait for it to finish
run = client.actor("synthetic.ia/argentina-economic-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "q": "inflación",
  "ids": [
    "148.3_INIVELNAL_DICI_M_26"
  ]
}' |
apify call synthetic.ia/argentina-economic-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,synthetic.ia/argentina-economic-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UK1ts2jUgKmci8VmF/builds/0eqQkT2DDIpui53mb/openapi.json
