# Colombia Open Data Scraper (`parseforge/colombia-datos-gov-co-scraper`) Actor

Export records from datos.gov.co, Colombia's national open-data portal. Pull rows from any dataset resource: COVID cases, government contracts, education, transport, health, public salaries. Filter by field values, sort by column, paginate full datasets.

- **URL**: https://apify.com/parseforge/colombia-datos-gov-co-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Other, Education
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $14.00 / 1,000 result items

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)

## 🇨🇴 Colombia Open Data Scraper

> 🚀 **Export Colombia government datasets in seconds.** Pull COVID epidemiology, public spending, healthcare, education, government contracts, public salaries, and thousands more datasets from the official datos.gov.co catalog. No login, no manual CSV stitching.

> 🕒 **Last updated:** 2026-05-22 · **📊 3 fields** per record · **🇨🇴 Whole-of-government Colombia catalog** · **🏛️ Hundreds of publishers**

The **Colombia Open Data Scraper** taps the official datos.gov.co catalog and returns every row of any chosen dataset. The portal is the central transparency platform for the Colombian Government, hosting datasets from the Ministry of Health, DIAN tax authority, SECOP public-contracts system, DANE statistics agency, and dozens of other publishers.

Coverage spans **health, public spending, education, security, transport, demographics, government contracts, public salaries, and environmental data**. This Actor returns clean structured rows ready to download as CSV, Excel, JSON, or XML, with optional field filters and sort order applied at the source so you skip the data wrangling.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| LATAM data analysts, health-policy researchers, anti-corruption journalists, NGOs, civic-tech builders, public-contract auditors | Health-policy dashboards, public-spending audits, COVID retrospective analyses, contract-fraud detection, education access tracking |

---

### 📋 What the Colombia Open Data Scraper does

Three workflows in a single run:

- 🏛️ **Pull any dataset.** Provide a 4x4 dataset identifier and the Actor streams every row.
- 🎯 **Exact-field filters.** Combine column-level filters like department, sex, or status to slice the dataset.
- 🔤 **Custom sort order.** Sort rows ascending or descending by any field before download.

Each row is returned with its original column structure preserved under a `data` object, plus the resource identifier and a timestamp.

> 💡 **Why it matters:** Colombia is one of the most transparent governments in LATAM, but the catalog is huge and the column schemas vary wildly. This Actor handles pagination, filter encoding, and refresh logic so your analysts and journalists can focus on the story.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Colombia dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Rows to return. Free plan caps at 10, paid plan at 1,000,000.</td></tr>
<tr><td><code>resourceId</code></td><td>string</td><td><code>"gt2j-8ykr"</code></td><td>Dataset identifier (4x4 code) from datos.gov.co.</td></tr>
<tr><td><code>filters</code></td><td>object</td><td><code>{}</code></td><td>Exact-match column filters as a JSON object.</td></tr>
<tr><td><code>sortOrder</code></td><td>string</td><td><code>""</code></td><td>Sort spec, e.g. <code>"fecha_reporte_web DESC"</code>.</td></tr>
</tbody>
</table>

**Example: latest 50 reported COVID cases in Colombia.**

```json
{
    "maxItems": 50,
    "resourceId": "gt2j-8ykr",
    "sortOrder": "fecha_reporte_web DESC"
}
````

**Example: female COVID cases in Bogota.**

```json
{
    "maxItems": 100,
    "resourceId": "gt2j-8ykr",
    "filters": { "departamento_nom": "BOGOTA", "sexo": "F" }
}
```

> ⚠️ **Good to Know:** dataset schemas vary by publisher and update cadence. Health datasets refresh daily, public-contract datasets can refresh hourly, and historical retrospective releases are static after publication. Always inspect the source dataset page for refresh notes before scheduling production pipelines.

***

### 📊 Output

Each row contains **3 top-level fields**, with the full original column set nested in `data`. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🏷️ `resourceId` | string | `"gt2j-8ykr"` |
| 📦 `data` | object | `{ "fecha_reporte_web": "2026-05-20T00:00:00.000", "departamento_nom": "BOGOTA", "edad": "37", "sexo": "F", ... }` |
| 🕒 `scrapedAt` | ISO 8601 | `"2026-05-22T00:00:00.000Z"` |

#### 📦 Sample record

<details>
<summary><strong>🦠 COVID-19 case row from Bogota</strong></summary>

```json
{
    "resourceId": "gt2j-8ykr",
    "data": {
        "fecha_reporte_web": "2026-05-20T00:00:00.000",
        "id_de_caso": "5212345",
        "departamento_nom": "BOGOTA",
        "ciudad_municipio_nom": "BOGOTA",
        "edad": "37",
        "sexo": "F",
        "ubicacion": "Casa",
        "estado": "Leve",
        "recuperado": "Recuperado"
    },
    "scrapedAt": "2026-05-22T00:00:00.000Z"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🇨🇴 | **Whole-of-government catalog.** Thousands of Colombian datasets in one Actor. |
| 🎯 | **Server-side filters.** Exact-column filters reduce the dataset before download. |
| 🔤 | **Custom sort order.** Sort rows ascending or descending by any field. |
| 🔄 | **Always fresh.** Every run streams the latest published rows. |
| ⚡ | **Fast.** Pages of 100 rows, automatic retries on transient errors. |
| 🔓 | **No login.** The Colombia Open Data catalog is free and public. |
| 📦 | **Export anywhere.** CSV, Excel, JSON, or XML straight from the Apify dataset. |

> 📊 Whether you are auditing SECOP contracts, modelling COVID waves, or tracking education enrolment, the same Actor backs every workflow.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ Colombia Open Data Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **Thousands of CO datasets** | **Live per run** | filters, sort | ⚡ 2 min |
| Manual CSV downloads from datos.gov.co | Free | Whole catalog | Re-download manually | None | 🐢 Slow |
| Custom Socrata clients | Free + dev time | Catalog | Self-managed | Self-coded | 🐌 Days |
| Paid LATAM data vendors | $$$ subscription | Curated subset | Vendor cadence | Vendor schema | ⏳ Weeks |

Pick this Actor when you want server-side filtering, sort, and pagination with zero pipeline maintenance.

***

### 🚀 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 Colombia Open Data Scraper page on the Apify Store.
3. 🎯 **Set input.** Paste a 4x4 dataset identifier from datos.gov.co, optionally add filters or sort order.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your rows.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 🦠 Health Policy & Epidemiology

- COVID retrospective analyses by department
- Vaccination uptake and coverage dashboards
- Hospital capacity and ICU utilisation tracking
- Disease-surveillance dashboards

</td>
<td width="50%" valign="top">

#### 💼 Public Spending & Anti-Corruption

- SECOP contract audits and anomaly detection
- Public-salary transparency dashboards
- Ministry budget vs. execution tracking
- Procurement-fraud red flags

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🚍 Transport & Security

- TransMilenio and SITP ridership trends
- Traffic-accident analytics by city
- Crime statistics and policing dashboards
- Highway tolls and concession analysis

</td>
<td width="50%" valign="top">

#### 🎓 Education & Demographics

- Enrolment and dropout tracking by region
- ICFES test-score analyses
- Teacher distribution and access maps
- Census-adjacent demographic dashboards

</td>
</tr>
</table>

***

### 🔌 Automating Colombia Open Data 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. Hourly, daily, or weekly refreshes keep downstream warehouses in sync automatically.

***

### 🌟 Beyond business use cases

Colombia open data fuels more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Public-health studies using ministry datasets
- LATAM political-economy theses
- Education-access research using ICFES microdata
- Reproducible studies with cited dataset pulls

</td>
<td width="50%">

#### 🎨 Personal and creative

- Indie data-journalism projects
- Side projects exploring Colombian history and demographics
- Personal dashboards on public spending
- Hobbyist epidemiology tracker tools

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Anti-corruption transparency dashboards on SECOP
- NGO targeting using health and education data
- Election-adjacent civic analyses
- Investigative journalism on ministry budgets

</td>
<td width="50%">

#### 🧪 Experimentation

- Train Spanish-language NLP on government text
- Prototype civic-tech apps with real public data
- Validate health-tech product hypotheses with ministry data
- Build geospatial demos for Colombian departments

</td>
</tr>
</table>

***

### 🤖 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%20Colombia%20Open%20Data%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%20Colombia%20Open%20Data%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%20Colombia%20Open%20Data%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%20Colombia%20Open%20Data%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?

Paste a 4x4 dataset identifier from datos.gov.co, optionally add column filters and a sort order, and the Actor streams every matching row to your Apify dataset with the original schema preserved.

#### 🔎 Where do I find a dataset identifier?

Open the dataset page on datos.gov.co. The identifier is the short alphanumeric code shown in the dataset URL after `/resource/`, formatted as four characters, dash, four characters (for example `gt2j-8ykr`).

#### 📏 Does it cover every Colombian dataset?

The Actor works with any dataset published to the central catalog by national ministries, SECOP, DIAN, DANE, and partner publishers.

#### 🔁 How fresh is the data?

Each run pulls the latest rows published at run time. The publishing cadence depends on the source publisher, ranging from hourly contract feeds to daily health updates.

#### ⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to refresh your dataset on any cron interval and keep downstream pipelines in sync.

#### 🎯 Can I filter the rows?

Yes. Use `filters` for exact-column matches and `sortOrder` for ascending or descending order by any field.

#### 🆔 What does the 4x4 identifier mean?

It is the canonical short ID assigned by datos.gov.co to every published dataset. Two groups of four characters separated by a dash, used in dataset URLs and the data feed.

#### ⚖️ Is this data legal to use?

The datos.gov.co catalog is published under permissive open licenses. Always review the specific dataset license for attribution requirements and downstream compliance.

#### 💼 Can I use this data commercially?

Yes. Most datasets are published under licenses that allow commercial reuse with attribution. You are responsible for downstream compliance in your own product.

#### 💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 rows per run). A paid plan lifts the limit and unlocks scheduling, higher concurrency, and bigger datasets.

#### 🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. Partial datasets are preserved so you never lose progress.

#### 🆘 What if I need help?

Our support team is here to help. Reach us through the Apify platform or via the Tally form linked below.

***

### 🔌 Integrate with any app

Colombia Open Data Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe Colombia datasets into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh Colombia rows into your product backend, or alert your team in Slack.

***

### 🔗 Recommended Actors

- [**🇦🇷 Argentina Open Data Scraper**](https://apify.com/parseforge/argentina-datos-gob-ar-scraper) - National open-data catalog for Argentina
- [**🇨🇱 Chile Open Data Scraper**](https://apify.com/parseforge/chile-datos-gob-cl-scraper) - National open-data catalog for Chile
- [**🇸🇬 Singapore Open Data Scraper**](https://apify.com/parseforge/singapore-data-gov-sg-scraper) - Whole-of-government Singapore datasets
- [**🇮🇳 India Postal PIN Code Scraper**](https://apify.com/parseforge/india-postal-pincode-scraper) - India Post nationwide directory
- [**📈 Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 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, endorsed by, or sponsored by the Government of Colombia, the Colombian open-data portal, or any publishing agency. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `resourceId` (type: `string`):

Dataset identifier from datos.gov.co (the 4x4 character code in the dataset URL). Example: gt2j-8ykr (COVID-19 cases Colombia).

## `filters` (type: `object`):

Exact-match filters as a JSON object. Example: {"departamento\_nom":"BOGOTA","sexo":"F"}.

## `sortOrder` (type: `string`):

Sort specification. Format: 'field\_name ASC' or 'field\_name DESC'. Example: 'fecha\_reporte\_web DESC'.

## Actor input object example

```json
{
  "maxItems": 10,
  "resourceId": "gt2j-8ykr"
}
```

# Actor output Schema

## `overview` (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 = {
    "maxItems": 10,
    "resourceId": "gt2j-8ykr"
};

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

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "resourceId": "gt2j-8ykr",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/colombia-datos-gov-co-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 '{
  "maxItems": 10,
  "resourceId": "gt2j-8ykr"
}' |
apify call parseforge/colombia-datos-gov-co-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/colombia-datos-gov-co-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Colombia Open Data Scraper",
        "description": "Export records from datos.gov.co, Colombia's national open-data portal. Pull rows from any dataset resource: COVID cases, government contracts, education, transport, health, public salaries. Filter by field values, sort by column, paginate full datasets.",
        "version": "1.0",
        "x-build-id": "IdVbPRjzopBRcDrEg"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~colombia-datos-gov-co-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-colombia-datos-gov-co-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~colombia-datos-gov-co-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-colombia-datos-gov-co-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~colombia-datos-gov-co-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-colombia-datos-gov-co-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": [
                    "resourceId"
                ],
                "properties": {
                    "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"
                    },
                    "resourceId": {
                        "title": "Resource ID",
                        "type": "string",
                        "description": "Dataset identifier from datos.gov.co (the 4x4 character code in the dataset URL). Example: gt2j-8ykr (COVID-19 cases Colombia)."
                    },
                    "filters": {
                        "title": "Field Filters",
                        "type": "object",
                        "description": "Exact-match filters as a JSON object. Example: {\"departamento_nom\":\"BOGOTA\",\"sexo\":\"F\"}."
                    },
                    "sortOrder": {
                        "title": "Sort Order",
                        "type": "string",
                        "description": "Sort specification. Format: 'field_name ASC' or 'field_name DESC'. Example: 'fecha_reporte_web DESC'."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
