<!-- https://pricto.dev/docs/api/create-data-request · versión en inglés: https://pricto.dev/docs/api/create-data-request.en.md -->

# Pedir cobertura o datos que no existen

`POST https://pricto.dev/v1/data-requests`

A retailer, country, category, frequency or delivery format that is not covered. An agent reviews the request, estimates feasibility and price, and replies by email. Agents may call this on behalf of the user only after the user agrees.

| Créditos | MCP |
|---|---|
| 0 | [`request_data`](/docs/mcp#request_data) |

## Parámetros

Sin parámetros.

## Cuerpo

| Campo | Tipo | Descripción |
|---|---|---|
| `kind` **requerido** | `string` | Valores / values: `retailer`, `country`, `category`, `frequency`, `delivery`, `other`. |
| `description` **requerido** | `string` |  |
| `retailer_url` | `string (uri)` |  |
| `country` | `string` |  |
| `contact_email` | `string (email)` |  |

## Respuesta

`201` Request registered.

| Campo | Tipo | Descripción |
|---|---|---|
| `data` **requerido** | `DataRequest` |  |
| `data.kind` **requerido** | `string` | Valores / values: `retailer`, `country`, `category`, `frequency`, `delivery`, `other`. |
| `data.description` **requerido** | `string` |  |
| `data.retailer_url` | `string (uri)` |  |
| `data.country` | `string` |  |
| `data.contact_email` | `string (email)` |  |
| `data.id` **requerido** | `string` |  |
| `data.status` **requerido** | `string` | Valores / values: `received`, `reviewing`, `quoted`, `accepted`, `declined`, `done`. |
| `data.created_at` **requerido** | `string (date-time)` |  |
| `meta` **requerido** | `Meta` |  |

`meta` trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver [Convenciones](/docs/convenciones)).

## Errores

- [`invalid_parameter`](/docs/errores#invalid_parameter)
- [`unauthorized`](/docs/errores#unauthorized)

## Ejemplo

```bash
curl -X POST "https://pricto.dev/v1/data-requests" \
  -H "Authorization: Bearer sk_test_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"kind":"retailer","description":"Agregar una cadena regional de farmacias","country":"CL"}'
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.post(
    "https://pricto.dev/v1/data-requests",
    json={
        "kind": "retailer",
        "description": "Agregar una cadena regional de farmacias",
        "country": "CL",
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/data-requests", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "kind": "retailer",
    "description": "Agregar una cadena regional de farmacias",
    "country": "CL"
  }),
});
console.log(res.status, await res.json());
```

```json
{
  "data": {
    "id": "dreq_0001",
    "kind": "retailer",
    "description": "Agregar una cadena regional de farmacias",
    "country": "CL",
    "status": "received",
    "created_at": "2026-10-24T23:29:33.841Z"
  },
  "meta": {
    "request_id": "req_f46cfa2bf66f41a29669",
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}
```