# Consultas vinculantes de la DGT con texto completo (`opendata-cr/consultas-dgt`) Actor

Consultas vinculantes de la Dirección General de Tributos con la contestación completa, fecha y normativa citada. Busque por palabras, número, impuesto (IRPF, IVA, Sociedades) o artículo, y reciba solo las nuevas con el modo monitor. Para asesores fiscales y despachos. No oficial.

- **URL**: https://apify.com/opendata-cr/consultas-dgt.md
- **Developed by:** [Tornwar](https://apify.com/opendata-cr) (community)
- **Categories:** Business, Automation, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 consultas

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/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

## Consultas vinculantes de la DGT (España) / Spanish DGT binding tax rulings

Obtenga las consultas vinculantes y generales de la Dirección General de Tributos (DGT, Ministerio de Hacienda) desde su buscador oficial, PETETE, con el texto completo de la contestación, la normativa citada separada por norma y artículo, y un modo monitor que entrega solo las consultas nuevas. El Actor no inicia sesión, no usa navegador y normalmente no necesita proxy.

Binding and general tax rulings issued by Spain's Dirección General de Tributos, from its official search engine, with the full answer, the cited legislation split into law and article, and a monitor mode for new rulings. English below.

> **Actor no oficial.** No tiene relación con la Dirección General de Tributos ni con el Ministerio de Hacienda, que no participan, patrocinan ni apoyan este Actor. Origen de los datos: Ministerio de Hacienda.

***

### Español

#### Para quién es

- Asesores fiscales y despachos que siguen la doctrina de la DGT sobre un impuesto, una norma o un tema.
- Departamentos fiscales de empresas que quieren una alerta semanal o mensual de consultas nuevas sobre IVA, IRPF, Impuesto sobre Sociedades o tributos locales.
- Editoriales jurídicas y equipos de datos que necesitan las consultas en JSON, con campos separados, en lugar de copiarlas del buscador.

Puede leer el dataset y el resumen de cada ejecución (registro `OUTPUT`) con la API de Apify o descargarlos en JSON, CSV o Excel.

#### Qué devuelve

| Contenido (`outputMode`) | Cada resultado es | Evento |
|---|---|---|
| Texto completo (`fullText`, por defecto) | Una consulta completa: número, órgano, fecha de salida, normativa (texto y desglose por norma y artículos), descripción de hechos, cuestión planteada y contestación completa | Consulta |
| Solo metadatos (`metadata`) | Número, descripción de hechos y cuestión planteada, tal como aparecen en la lista de resultados del buscador oficial. Sin órgano, fecha, normativa ni contestación | Metadatos de consulta |

Todos los resultados incluyen `url` (enlace que abre la consulta en el buscador oficial), `fuente` ("Origen de los datos: Ministerio de Hacienda…"), `baseActualizadaA` (fecha de actualización que indica la fuente), `condicionesReutilizacion` y `aviso` de no afiliación.

#### Filtros

Todos los filtros se combinan entre sí: una consulta debe cumplirlos todos.

| Campo | Qué hace |
|---|---|
| `keywords` | Texto a buscar. Las palabras de una misma línea deben aparecer todas, en cualquier orden. Para una frase exacta, escríbala entre comillas: `"vivienda habitual"`. `keywordsMatch`: `all` (todas las líneas) o `any` (alguna). `keywordsField`: `textoLibre` (toda la consulta, incluida la contestación), `cuestion` o `hechos`. Admite los operadores del buscador oficial: `.Y`, `.O`, `.NO`, `*` (cualquier terminación) y `?` (un carácter). |
| `consultaNumbers` | Números `Vxxxx-aa` (vinculantes) o `xxxx-aa` (generales). También acepta `V123-25` o `V0123/25`. |
| `dateFrom`, `dateTo` | Fecha de salida, inclusive (AAAA-MM-DD). Sin fechas, puede usar `recentDays`. |
| `organos` | Subdirección General que firma. Atajos: `IRPF`, `IS`, `IVA`, `INTERNACIONAL`/`IRNR`, `LOCALES`, `PATRIMONIALES`/`ITP`/`ISD`, `ESPECIALES`/`IIEE`, `FINANCIERAS`. También acepta el nombre, por ejemplo `SG de Tributos Locales`. |
| `impuestos` | Impuesto citado en la normativa. Atajos: `IRPF`, `IVA`, `IS`, `ITP`, `ISD`, `IRNR`, `LOCALES`, `IIEE`, `IP`, `LGT`. Cada atajo incluye las siglas y la ley principal, porque la normativa se escribe de forma distinta según el año de la consulta. |
| `normativa` | Norma citada: `Ley 35/2006`, `RD 439/2007`, `Ley 37/1992`. Con artículos: `Ley 35/2006 art. 33, 34`. Con texto completo, solo se entregan y cobran las consultas que citan esos artículos de esa norma. |
| `onlyCriterioInteres` | Solo consultas que la DGT marca como criterio de interés general (desde 2022). |
| `tipo` | `vinculantes` (por defecto), `generales` o `ambas`. |

Consultas vinculantes de 2025 por órgano: Impuestos sobre la Renta de las Personas Físicas 1.204, Impuestos sobre el Consumo 524, Impuestos sobre las Personas Jurídicas 303, Impuestos Patrimoniales 142, Tributación de las Operaciones Financieras 142, Tributos Locales 75, Impuestos Especiales 66 y Fiscalidad Internacional 50.

#### Precio (pago por evento)

| Evento | Precio | Se cobra por |
|---|---|---|
| Inicio | US$0,05 | Una vez por ejecución, cuando la base oficial responde a la primera búsqueda. También en modo monitor, aunque no haya consultas nuevas |
| Consulta | US$0,008 | Cada consulta con texto completo entregada en el dataset |
| Metadatos de consulta | US$0,002 | Cada consulta entregada solo con metadatos |

No se cobra una consulta que no se pudo descargar ni una que no cumple el filtro de artículos. Si la fuente no responde, tampoco se cobra el inicio. Por ejemplo, 50 consultas con texto completo cuestan US$0,05 + 50 × US$0,008 = US$0,45.

`maxResults` limita los resultados por ejecución (100 si lo deja vacío; el formulario propone 10; máximo 5.000). Si fija un máximo a cobrar por ejecución, el Actor descarga solo las consultas que caben en ese importe y termina con éxito al alcanzarlo, con los resultados ya entregados. El máximo debe ser de al menos US$0,06 (inicio y una consulta); si no alcanza, el Actor no consulta la fuente.

#### Ejemplo: búsqueda con texto completo

```json
{
    "keywords": ["criptomonedas"],
    "dateFrom": "2026-01-01",
    "dateTo": "2026-08-31",
    "outputMode": "fullText",
    "maxResults": 3
}
```

Resultado real, obtenido el 4 de octubre de 2026 (aquí se recortan los hechos y la contestación; el dataset los incluye completos):

```json
{
    "numeroConsulta": "V5346-26",
    "tipo": "vinculante",
    "textoCompleto": true,
    "organo": "SG de Impuestos sobre la Renta de las Personas Físicas",
    "fechaSalida": "2026-07-28",
    "normativa": [
        "Ley 35/2006 Impuesto sobre la Renta de las Personas Físicas IRPF - 33 - 34 - 35 - 36"
    ],
    "normas": [
        {
            "texto": "Ley 35/2006 Impuesto sobre la Renta de las Personas Físicas IRPF - 33 - 34 - 35 - 36",
            "referencia": "Ley 35/2006",
            "titulo": "Impuesto sobre la Renta de las Personas Físicas IRPF",
            "articulos": ["33", "34", "35", "36"]
        }
    ],
    "descripcionHechos": "La consultante fue víctima durante el año 2024 de una estafa financiera en la que los autores del fraude utilizaron ilícitamente sus datos personales para abrir, sin su consentimiento, una cuenta en u […]",
    "cuestionPlanteada": "Determinación del momento de imputación temporal, a efectos del IRPF, de la pérdida patrimonial derivada de la estafa sufrida.",
    "contestacion": "La determinación legal del concepto de ganancias y pérdidas patrimoniales se recoge en el artículo 33.1 de la Ley 35/2006, de 28 de noviembre, del Impuesto sobre la Renta de las Personas Físicas […]",
    "caracteresContestacion": 7613,
    "otrosCampos": null,
    "url": "https://petete.tributos.hacienda.gob.es/consultas/?num_consulta=V5346-26",
    "docId": "70215",
    "extraidoEn": "2026-10-05T01:26:41Z",
    "fuente": "Origen de los datos: Ministerio de Hacienda (Dirección General de Tributos, buscador PETETE)",
    "fuenteUrl": "https://petete.tributos.hacienda.gob.es/consultas/",
    "baseActualizadaA": "2026-08-31",
    "condicionesReutilizacion": "https://www.hacienda.gob.es/es-ES/Paginas/AvisoLegal.aspx",
    "aviso": "Actor no oficial. Sin afiliación con la Dirección General de Tributos ni con el Ministerio de Hacienda, que no participan, patrocinan ni apoyan esta reutilización. Texto reproducido sin alterar su sentido; consulte la fuente oficial."
}
```

La contestación conserva un párrafo por línea. `normas` desglosa cada norma citada y sus artículos; el texto original se mantiene en `normativa` y en `normas[].texto`.

#### Ejemplo: solo metadatos de un órgano y un año

```json
{
    "organos": ["LOCALES"],
    "dateFrom": "2025-01-01",
    "dateTo": "2025-12-31",
    "outputMode": "metadata",
    "maxResults": 25
}
```

```json
{
    "numeroConsulta": "V2619-25",
    "tipo": "vinculante",
    "textoCompleto": false,
    "descripcionHechos": "Terrenos clasificados urbanísticamente en el municipio donde están ubicados como suelo rústico de asentamiento irregular. Sin embargo, dichos terrenos figuran en el Catastro como terrenos de naturaleza urbana al cumplir las condiciones previstas en el artículo 7.2.d) del TRLCI.",
    "cuestionPlanteada": "Se plantea si la transmisión de los terrenos debe considerarse sujeta al Impuesto sobre el Incremento de Valor de los Terrenos de Naturaleza Urbana.",
    "url": "https://petete.tributos.hacienda.gob.es/consultas/?num_consulta=V2619-25",
    "docId": "58762",
    "fuente": "Origen de los datos: Ministerio de Hacienda (Dirección General de Tributos, buscador PETETE)",
    "baseActualizadaA": "2026-08-31"
}
```

#### Ejemplo: consultas por número

```json
{
    "consultaNumbers": ["V5346-26", "V2539-25", "V0001-97"],
    "outputMode": "fullText"
}
```

#### Alerta de consultas nuevas (modo monitor)

```json
{
    "impuestos": ["IVA"],
    "onlyNewSinceLastRun": true,
    "monitorStoreName": "alerta-iva",
    "outputMode": "fullText",
    "maxResults": 200
}
```

Programe la tarea en Apify (Schedules) de forma semanal o mensual. Cada ejecución revisa las consultas más recientes por fecha de salida, entrega y cobra solo los números que no se entregaron antes con el mismo `monitorStoreName` y los guarda en ese almacén. Si no indica fechas, el monitor revisa los últimos 120 días de fecha de salida (`recentDays` lo cambia). Una consulta que no se pudo descargar no se marca como entregada y se vuelve a intentar en la siguiente ejecución.

Tenga en cuenta que el inicio (US$0,05) se cobra en cada ejecución, aunque no haya consultas nuevas. Como la base oficial se actualiza una vez al mes, una ejecución semanal suele encontrar novedades solo una vez al mes.

#### Volumen

Consultas vinculantes por año de fecha de salida, contadas en el buscador oficial el 4 de octubre de 2026:

| Año | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 2024 | 2025 | 2026 (hasta 31/08) |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Vinculantes | 5.485 | 3.322 | 3.293 | 3.548 | 3.703 | 3.238 | 2.677 | 3.361 | 2.660 | 2.646 | 2.192 |

Las consultas generales son pocas (12 en 2025 y 9 en 2026).

#### Limitaciones

- **Actualización mensual con retraso.** La base oficial se actualiza por lotes mensuales, con más de un mes de retraso. El 4 de octubre de 2026 indicaba "actualizada a 31/08/2026". Una consulta aparece en el dataset solo cuando la fuente la publica.
- **Consultas lentas.** La fuente puede tardar cerca de un minuto por consulta con texto completo; una búsqueda grande puede demorarse varios minutos. El modo solo metadatos es mucho más rápido. Si ve muchos avisos de la fuente, baje `concurrency` a 1 o 2.
- **El monitor cobra el inicio en cada ejecución.** En modo monitor, el inicio (US$0,05) se cobra en cada ejecución aunque no haya consultas nuevas, siempre que la fuente responda.
- **Metadatos sin fecha ni órgano.** El modo solo metadatos no trae órgano, fecha de salida ni normativa, porque la lista de resultados de la fuente no los muestra.
- **Normativa con formatos distintos.** La forma de citar la normativa cambia según el año de la consulta. El filtro por artículos se aplica con texto completo; en algún caso un formato poco habitual puede no reconocerse.
- **Numeración de 2026.** Los números V1690-26 a V4999-26 no existen, por un cambio de numeración que indica la propia fuente.

#### Fuente y condiciones de reutilización

- Fuente: [PETETE, buscador de consultas de la Dirección General de Tributos](https://petete.tributos.hacienda.gob.es/consultas/), también listado en [datos.gob.es](https://datos.gob.es/es/catalogo/e05250001-consultas-tributarias-de-la-direccion-general-de-tributos).
- Condiciones: [aviso legal del Ministerio de Hacienda](https://www.hacienda.gob.es/es-ES/Paginas/AvisoLegal.aspx), "Condiciones generales para la reutilización de información". Permiten la reutilización comercial y no comercial siempre que se cite la fuente ("Origen de los datos: Ministerio de Hacienda"), se indique la fecha de última actualización, no se altere el sentido de la información y no se sugiera que el Ministerio participa, patrocina o apoya la reutilización.
- Cada resultado incluye la cita, la fecha de actualización de la fuente (`baseActualizadaA`) y el enlace a las condiciones. Si redistribuye los datos, consérvelos.
- El texto se reproduce tal como lo publica la fuente, sin resúmenes ni cambios de redacción.
- Las consultas vinculantes obligan a la Administración en relación con quien las presentó (art. 89 de la Ley 58/2003, General Tributaria). Este Actor no presta asesoramiento fiscal; compruebe siempre la fuente oficial.

***

### English

#### Who it is for

- Tax advisers and firms tracking DGT doctrine on a tax, a law or a topic.
- In-house tax teams that want a weekly or monthly alert of new rulings on VAT, personal income tax, corporate tax or local taxes.
- Legal publishers and data teams that need the rulings as JSON with separate fields.

#### What you get

- Full text (`outputMode: fullText`, default; event Consulta): ruling number, issuing body (`organo`), issue date (`fechaSalida`), cited legislation (`normativa`, plus `normas` split into law and articles), facts, question and the full answer (`contestacion`).
- Metadata only (`outputMode: metadata`; event Metadatos de consulta): number, facts and question from the official result list. Much faster; no issuing body, date, legislation or answer.
- Every item includes `url` (opens the ruling in the official search engine), the attribution `fuente`, `baseActualizadaA`, the reuse-conditions link and a no-affiliation notice.

Field names are in Spanish. Text is kept as published.

#### Filters (all combined)

`keywords` (words on one line must all appear; quotes for an exact phrase; `keywordsMatch` all/any; `keywordsField` textoLibre/cuestion/hechos), `consultaNumbers` (`V1234-25`), `dateFrom`/`dateTo` or `recentDays` (issue date), `organos` (shortcuts IRPF, IS, IVA, INTERNACIONAL, LOCALES, PATRIMONIALES, ESPECIALES, FINANCIERAS), `impuestos` (IRPF, IVA, IS, ITP, ISD, IRNR, LOCALES, IIEE, IP, LGT), `normativa` (`Ley 35/2006`, or `Ley 35/2006 art. 33, 34` to keep only rulings citing those articles of that law), `onlyCriterioInteres`, `tipo` (vinculantes, generales, ambas).

#### Pricing (pay per event)

| Event | Price | Charged for |
|---|---|---|
| Inicio (start) | US$0.05 | Once per run, after the official database answers the first search. Also in monitor mode when nothing is new |
| Consulta (ruling) | US$0.008 | Each full-text ruling delivered to the dataset |
| Metadatos de consulta (ruling metadata) | US$0.002 | Each metadata-only ruling delivered to the dataset |

Rulings that fail to download or fail the article filter are not charged. Example: 50 full-text rulings cost US$0.05 + 50 × US$0.008 = US$0.45. With a maximum charge per run, the Actor only downloads what fits and finishes successfully when it is reached. The maximum charge must be at least US$0.06.

#### Monitor mode

Set `onlyNewSinceLastRun: true` and one `monitorStoreName` per alert, then schedule the task. Each run delivers and charges only ruling numbers not delivered before with that store. Without dates, it checks the last 120 days of issue dates.

#### Limitations

- The official database is updated in monthly batches with more than a month of lag (on 4 Oct 2026 it said "updated to 31/08/2026").
- Some queries are slow: the source can take about a minute per full-text ruling, so a large search can take several minutes. Metadata mode is much faster.
- Monitor mode charges the start fee (US$0.05) on every run, even when there is nothing new.
- Metadata-only results have no issuing body, issue date or legislation.

#### Volume

About 2,600–3,400 binding rulings per year (2,646 in 2025; 2,192 in 2026 up to 31 Aug).

#### Source and reuse conditions

Source: [PETETE](https://petete.tributos.hacienda.gob.es/consultas/), the official search engine of the Dirección General de Tributos. Reuse is allowed for commercial and non-commercial purposes under the [Ministerio de Hacienda legal notice](https://www.hacienda.gob.es/es-ES/Paginas/AvisoLegal.aspx): cite "Origen de los datos: Ministerio de Hacienda", state the last update date, do not distort the meaning and do not suggest that the Ministry takes part in, sponsors or supports the reuse. Each item carries this attribution. **This Actor is not affiliated with the DGT or the Ministerio de Hacienda** and is not tax advice.

# Actor input Schema

## `keywords` (type: `array`):

Texto a buscar. Las palabras de una misma línea deben aparecer todas, en cualquier orden. Para una frase exacta, escríbala entre comillas, por ejemplo "vivienda habitual". No distingue mayúsculas ni tildes. Admite los operadores del buscador oficial: .Y, .O, .NO, \* (cualquier terminación) y ? (un carácter). Words on one line must all appear; use quotes for an exact phrase.

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

Todas: cada línea debe aparecer. Alguna: basta con una línea. All lines, or at least one.

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

Texto libre busca en toda la consulta, incluida la contestación. También puede limitar la búsqueda a la cuestión planteada o a la descripción de hechos. Free text searches the whole ruling, including the answer.

## `consultaNumbers` (type: `array`):

Formato Vxxxx-aa para consultas vinculantes (por ejemplo V1234-25) y xxxx-aa para generales. También se aceptan V123-25 y V0123/25. Format Vxxxx-yy.

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

Fecha de salida (emisión) de la consulta, inclusive, en formato AAAA-MM-DD. Si solo indica esta fecha, el rango llega hasta hoy. Issue date, inclusive.

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

Fin del rango, inclusive, en formato AAAA-MM-DD. End date, inclusive.

## `recentDays` (type: `integer`):

Consultas con fecha de salida en los últimos N días. Se usa cuando no indica fechas ni números de consulta. En modo monitor, si lo deja vacío, se usan 120 días. La base oficial se actualiza por lotes mensuales, con más de un mes de retraso. Issue date within the last N days.

## `organos` (type: `array`):

Subdirección General que firma la consulta. Basta con que coincida uno. Escriba el nombre (por ejemplo SG de Tributos Locales) o un atajo: IRPF, IS, IVA, INTERNACIONAL (o IRNR), LOCALES, PATRIMONIALES (ITP, ISD), ESPECIALES (IIEE) o FINANCIERAS. Any of these bodies.

## `impuestos` (type: `array`):

Impuesto citado en la normativa de la consulta. Atajos: IRPF, IVA, IS, ITP, ISD, IRNR, LOCALES, IIEE, IP o LGT; cada atajo incluye las siglas y la ley principal. También puede escribir otras siglas, por ejemplo IBI o IIVTNU. Basta con que coincida uno. Tax cited in the ruling; any of them.

## `normativa` (type: `array`):

Norma citada, por ejemplo Ley 35/2006, RD 439/2007 o Ley 37/1992. Cada línea debe aparecer. Puede añadir artículos: Ley 35/2006 art. 33, 34. Con texto completo, solo se entregan y cobran las consultas que citan esos artículos de esa norma. Each line must be cited.

## `onlyCriterioInteres` (type: `boolean`):

Solo las consultas que la Dirección General de Tributos marca como criterio de interés general (desde 2022). Only rulings flagged as of general interest.

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

Vinculantes (por defecto), generales o ambas. Si indica números de consulta, el tipo se deduce del número (V = vinculante). Binding rulings, general rulings or both.

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

Texto completo: cada consulta con órgano, fecha, normativa y contestación completa (evento Consulta). Solo metadatos: número, hechos y cuestión planteada, mucho más rápido (evento Metadatos de consulta). Full text or metadata only.

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

Por fecha de salida: más recientes o más antiguas primero. By issue date.

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

Cantidad máxima de consultas entregadas (y cobradas) por ejecución. Si lo deja vacío, 100. Si antes se alcanza el máximo a cobrar de la ejecución, esta termina con éxito con lo ya entregado. Maximum results per run.

## `onlyNewSinceLastRun` (type: `boolean`):

Entrega y cobra solo las consultas que no se entregaron antes con el mismo almacén. El inicio se cobra en cada ejecución, aunque no haya consultas nuevas. Only rulings not delivered before; the start fee applies on every run.

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

Almacén (Key-Value Store) con nombre donde se guardan los números ya entregados. Use un nombre distinto para cada alerta. Letras, números y guiones. Use one name per alert.

## `concurrency` (type: `integer`):

Cuántas consultas con texto completo se descargan a la vez (1 a 4). Si la fuente responde con avisos o errores, baje a 1 o 2. / How many full-text rulings to download at once (1 to 4).

## `proxyConfiguration` (type: `object`):

Normalmente no hace falta. Úselo solo si las ejecuciones fallan por errores de conexión. Usually not needed.

## Actor input object example

```json
{
  "keywords": [
    "criptomonedas"
  ],
  "keywordsMatch": "all",
  "keywordsField": "textoLibre",
  "onlyCriterioInteres": false,
  "tipo": "vinculantes",
  "outputMode": "fullText",
  "sortOrder": "newest",
  "maxResults": 10,
  "onlyNewSinceLastRun": false,
  "monitorStoreName": "consultas-dgt-monitor",
  "concurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "keywords": [
        "criptomonedas"
    ],
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("opendata-cr/consultas-dgt").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 = {
    "keywords": ["criptomonedas"],
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("opendata-cr/consultas-dgt").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 '{
  "keywords": [
    "criptomonedas"
  ],
  "maxResults": 10
}' |
apify call opendata-cr/consultas-dgt --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,opendata-cr/consultas-dgt"
        }
    }
}
```

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/WPCrG892ebEXROodZ/builds/BPD23Qd3lptZS4ldT/openapi.json
