Developers + agents

tacosdedatos Guides developer interface

Discover one-off guide offers, inspect their availability, retrieve free resources, and understand the boundaries around paid checkout and private delivery. The read interfaces are public and require no API key.

OpenAPI 3.1

Typed requests, responses, errors, and safety notes for the public HTTP surface.

/api/openapi.json

Versioned catalog

Current free, paid, and paused offers with canonical URLs and delivery methods.

GET /api/v1/catalog

Agent skills

Installable skills for dataset profiling in Spanish and English.

/.well-known/agent-skills/index.json

API catalog

RFC 9727 discovery for clients that start at the domain.

/.well-known/api-catalog

Quickstart

Read the catalog before acting. It is the source for current availability and tells you whether an offer is free, paid, or paused.

curl -sS https://guias.tacosdedatos.com/api/v1/catalog
curl -sS -H 'Accept: text/markdown' https://guias.tacosdedatos.com/

Safety and authorization

Catalog, health, OpenAPI, and agent-skill discovery are public read operations.
A paid checkout creates an external payment session. An agent must have explicit user approval for the exact product and displayed USD price before calling it.
Free resources use POST /api/free-download and do not require signup or payment.
Paid-download session URLs are private bearer capabilities. Never log, share, index, or reuse them for another product.
Subscriber identity and entitlements belong to Biblioteca, not this API.

Errors, versions, and deprecation

API failures use RFC 9457 application/problem+json. Every problem includes a stable code, a human-readable detail, and a recovery hint. Stable public REST reads use the /api/v1 path. A breaking change will use a new major path; deprecated operations will be documented here and signaled with Deprecation and Sunset headers before removal.

No public request quota is currently advertised. Clients should cache catalog responses according to their HTTP cache headers, avoid polling, and honor Retry-After if a future 429 response supplies it.

Support

For a contract question or a failed private delivery, contact hola@tacosdedatos.com. Never include a private Checkout Session URL in a public issue.