# Deschave — Argentine Government Transparency Data (`mindful_fork/deschave-argentina-gov-transparency`) Actor

Export risk-ranked vendors, officials, suspicious cases, and official gazette alerts from deschave.com — Argentina's government transparency platform. No configuration needed — just pick a dataset and run.

- **URL**: https://apify.com/mindful\_fork/deschave-argentina-gov-transparency.md
- **Developed by:** [Deschave](https://apify.com/mindful_fork) (community)
- **Categories:** AI, News, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$49.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Deschave — Argentine Government Transparency Data

Export risk-ranked vendors, officials, suspicious cases, and official gazette alerts from **[deschave.com](https://deschave.com)** — Argentina's government transparency platform powered by open public data.

### What is this?

Deschave processes millions of public procurement contracts, subsidies, asset declarations, and political donations to generate risk scores for companies and individuals that interact with the Argentine state. This actor gives you programmatic access to that data in structured, ready-to-use format.

**No configuration required** — just pick a dataset and run.

### Available datasets

| Dataset | Description |
|---|---|
| `TOP_VENDORS` | Companies ranked by procurement risk score. Includes apocryphal vendors, shell company patterns, sole-source concentration, and more. |
| `TOP_PEOPLE` | Individuals ranked by risk. Includes government officials with conflict of interest signals, political donors, company directors. |
| `TOP_GOV_BODIES` | Government bodies ranked by risk exposure. |
| `CASES` | Detected suspicious cases: shell company clusters, kickback rings, regulatory capture patterns. |
| `BO_ACTS` | Official Gazette (Boletín Oficial) alerts — flagged acts involving high-risk entities. |
| `ENTITY_LOOKUP` | Look up any entity by CUIT/CUIL tax ID to get its full risk profile. |

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `dataset` | string | — | **Required.** One of the dataset values above. |
| `maxResults` | number | 1000 | Maximum records to export (up to 100,000). |
| `search` | string | | Filter by name/keyword (TOP_VENDORS, TOP_PEOPLE, TOP_GOV_BODIES, CASES). |
| `signalTypes` | string[] | | Filter by risk signal type (e.g. `APOCRYPHAL_VENDOR`, `SOLE_SOURCE`). |
| `years` | string[] | | Filter by contract year (e.g. `["2023", "2024"]`). |
| `daysBack` | number | 30 | Days back to fetch gazette alerts (BO_ACTS only). |
| `flaggedOnly` | boolean | false | Return only flagged acts (BO_ACTS only). |
| `year` | string | | Filter gazette by specific year (BO_ACTS only, overrides `daysBack`). |
| `cuits` | string[] | | List of CUIT/CUIL numbers to look up (ENTITY_LOOKUP only). |

### Output

Each record pushed to the Apify dataset contains the full entity or case object. Key fields:

**Vendors / People / Gov Bodies:**
- `name` — entity name
- `cuit` — Argentine tax ID
- `type` — `Company`, `Person`, or `GovernmentBody`
- `riskScore` — composite risk score 0–100
- `properties.risk_summary` — human-readable risk explanation
- `properties.contractCount` — number of state contracts
- `properties.totalAmount` — total contract value in ARS
- `properties.risk_signals_json` — full array of detected risk signals with evidence

**Cases:**
- `hubEntityName` — central entity in the case
- `caseType` — e.g. `SHELL_CLUSTER`, `SOLE_SOURCE_RING`
- `maxRiskScore` — highest risk score among involved entities
- `totalContractValue` — total ARS involved
- `summary` — plain-language description of the case

**Official Gazette Alerts:**
- `title` — act title
- `actType` — type of act (contract, appointment, etc.)
- `publishDate` — publication date
- `amount` — monetary value if present
- `urlDetalle` — link to full text in the official gazette

### Pricing

This actor uses **pay-per-event** pricing: **$0.001 per exported record** (= $1 per 1,000 records).

Exporting 10,000 vendors costs ~$10. The dataset is updated daily via the official gazette pipeline.

### Example: Export top 500 high-risk vendors

```json
{
  "dataset": "TOP_VENDORS",
  "maxResults": 500
}
````

### Example: Look up entities by CUIT

```json
{
  "dataset": "ENTITY_LOOKUP",
  "cuits": ["30715589443", "20123456789"]
}
```

### Example: Flagged gazette acts from the last 7 days

```json
{
  "dataset": "BO_ACTS",
  "daysBack": 7,
  "flaggedOnly": true
}
```

### Data sources

All data is sourced from Argentine government open data portals:

- **Contratar** (public procurement) — [contrataciones.gob.ar](https://contrataciones.gob.ar)
- **AFIP** — tax registry and apocryphal vendor lists
- **Boletín Oficial** — official gazette
- **Declaraciones juradas** — public officials' asset declarations
- **Aportes electorales** — political donation records

### About

Built and maintained by [deschave.com](https://deschave.com). For questions or enterprise access, visit the site.

# Actor input Schema

## `dataset` (type: `string`):

Which dataset to export.

## `maxResults` (type: `integer`):

Maximum number of records to export. Defaults to 1000.

## `search` (type: `string`):

Filter results by name or keyword (applies to TOP\_VENDORS, TOP\_PEOPLE, TOP\_GOV\_BODIES, CASES).

## `signalTypes` (type: `array`):

Filter by risk signal types (applies to TOP\_VENDORS, TOP\_PEOPLE, TOP\_GOV\_BODIES). Leave empty for all.

## `years` (type: `array`):

Filter by contract/subsidy years, e.g. \["2023", "2024"] (applies to TOP\_VENDORS, TOP\_GOV\_BODIES).

## `daysBack` (type: `integer`):

How many days back to fetch Official Gazette alerts (BO\_ACTS only). Defaults to 30.

## `flaggedOnly` (type: `boolean`):

Return only flagged/suspicious Official Gazette acts (BO\_ACTS only). Defaults to false.

## `year` (type: `string`):

Filter Official Gazette acts by a specific year, e.g. "2024" (BO\_ACTS only, overrides daysBack).

## `cuits` (type: `array`):

List of CUIT/CUIL numbers to look up (ENTITY\_LOOKUP only).

## Actor input object example

```json
{
  "dataset": "TOP_VENDORS",
  "maxResults": 1000,
  "daysBack": 30,
  "flaggedOnly": false
}
```

# Actor output Schema

## `name` (type: `string`):

Entity or act name

## `cuit` (type: `string`):

Argentine tax identification number

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

Entity type: Company, Person, or GovernmentBody

## `riskScore` (type: `string`):

Composite risk score 0–100

## `uid` (type: `string`):

Unique identifier

## `hubEntityName` (type: `string`):

Hub entity name (CASES dataset)

## `caseType` (type: `string`):

Type of suspicious case

## `maxRiskScore` (type: `string`):

Maximum risk score among involved entities

## `totalContractValue` (type: `string`):

Total value of contracts involved

## `companyCount` (type: `string`):

Number of companies in the case

## `summary` (type: `string`):

Case summary

## `computedAt` (type: `string`):

Timestamp when the score was last computed

## `actType` (type: `string`):

Type of official act

## `actNumber` (type: `string`):

Official act number

## `publishDate` (type: `string`):

Publication date in the official gazette

## `actContextType` (type: `string`):

Context category of the act

## `amount` (type: `string`):

Monetary amount mentioned in the act

## `urlDetalle` (type: `string`):

Link to the full act in the official gazette

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("mindful_fork/deschave-argentina-gov-transparency").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("mindful_fork/deschave-argentina-gov-transparency").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 '{}' |
apify call mindful_fork/deschave-argentina-gov-transparency --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=mindful_fork/deschave-argentina-gov-transparency",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Deschave — Argentine Government Transparency Data",
        "description": "Export risk-ranked vendors, officials, suspicious cases, and official gazette alerts from deschave.com — Argentina's government transparency platform. No configuration needed — just pick a dataset and run.",
        "version": "0.1",
        "x-build-id": "biBowxtIEN4nQ15AN"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/mindful_fork~deschave-argentina-gov-transparency/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-mindful_fork-deschave-argentina-gov-transparency",
                "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/mindful_fork~deschave-argentina-gov-transparency/runs": {
            "post": {
                "operationId": "runs-sync-mindful_fork-deschave-argentina-gov-transparency",
                "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/mindful_fork~deschave-argentina-gov-transparency/run-sync": {
            "post": {
                "operationId": "run-sync-mindful_fork-deschave-argentina-gov-transparency",
                "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": [
                    "dataset"
                ],
                "properties": {
                    "dataset": {
                        "title": "Dataset",
                        "enum": [
                            "TOP_VENDORS",
                            "TOP_PEOPLE",
                            "TOP_GOV_BODIES",
                            "CASES",
                            "BO_ACTS",
                            "ENTITY_LOOKUP"
                        ],
                        "type": "string",
                        "description": "Which dataset to export.",
                        "default": "TOP_VENDORS"
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Maximum number of records to export. Defaults to 1000.",
                        "default": 1000
                    },
                    "search": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Filter results by name or keyword (applies to TOP_VENDORS, TOP_PEOPLE, TOP_GOV_BODIES, CASES)."
                    },
                    "signalTypes": {
                        "title": "Signal Types",
                        "type": "array",
                        "description": "Filter by risk signal types (applies to TOP_VENDORS, TOP_PEOPLE, TOP_GOV_BODIES). Leave empty for all.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "years": {
                        "title": "Years",
                        "type": "array",
                        "description": "Filter by contract/subsidy years, e.g. [\"2023\", \"2024\"] (applies to TOP_VENDORS, TOP_GOV_BODIES).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "daysBack": {
                        "title": "Days Back",
                        "minimum": 1,
                        "type": "integer",
                        "description": "How many days back to fetch Official Gazette alerts (BO_ACTS only). Defaults to 30.",
                        "default": 30
                    },
                    "flaggedOnly": {
                        "title": "Flagged Only",
                        "type": "boolean",
                        "description": "Return only flagged/suspicious Official Gazette acts (BO_ACTS only). Defaults to false.",
                        "default": false
                    },
                    "year": {
                        "title": "Year Filter",
                        "type": "string",
                        "description": "Filter Official Gazette acts by a specific year, e.g. \"2024\" (BO_ACTS only, overrides daysBack)."
                    },
                    "cuits": {
                        "title": "CUITs",
                        "type": "array",
                        "description": "List of CUIT/CUIL numbers to look up (ENTITY_LOOKUP only).",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
