API para desarrolladores

Documentación de la API.

Consulta leyes, artículos, tesis y sentencias de México desde tus aplicaciones, con los mismos datos que ves en SoyLic. Solo de servidor a servidor.

Crear cuenta gratis Ir a mis claves

URL base: https://api.soylic.mx/v1 · OpenAPI

Empezar

Crea una clave en Configuraciones → Desarrolladores. La primera clave trae créditos de regalo para probar.
Guárdala en tu servidor. Se muestra una sola vez.
Haz tu primera consulta:

curl -H "Authorization: Bearer lic_live_…" \
  "https://api.soylic.mx/v1/articulos/buscar?q=pension%20alimenticia&entidad=Jalisco"

Autenticación

Manda tu clave en cada petición con el encabezado Authorization: Bearer lic_live_…. No la pongas en una página web ni en una app que corra en el teléfono: quien la vea puede gastar tus créditos. Si se filtra, revócala y crea otra.

Créditos

La API se paga con paquetes de créditos que compras en Configuraciones → Desarrolladores. Los créditos no vencen. Cada endpoint indica cuántos descuenta, también cuando responde 404. Con el saldo en 0, la API responde 402 no_credits. Tu saldo viene en X-Lic-Credits-Remaining y en GET /v1/uso. Los paquetes y sus precios están en Precios.

Límites

Hay peticiones por minuto (por clave y por cuenta), una cuota de unidades por día (por clave) y un tope de seguridad por mes (por cuenta). Consulta los tuyos en GET /v1/uso. Las búsquedas devuelven 20 resultados por página y solo se recorren los primeros 100: para encontrar algo, afina la búsqueda.

La API es para integrar SoyLic en tu sistema, no para copiar el contenido. Las descargas masivas (recorrer registros en orden, paginar todas las búsquedas, ritmo automático continuo) se detectan: primero bajan tus límites y después se suspende la clave.

Encabezados de respuesta

Encabezado	Qué indica
`X-Lic-Credits-Remaining`	Créditos que le quedan a tu cuenta.
`X-Lic-Units-Remaining`	Unidades que le quedan a tu cuenta antes del tope de seguridad del mes.
`RateLimit-Limit`	Peticiones permitidas por minuto.
`RateLimit-Remaining`	Peticiones que quedan en este minuto.
`RateLimit-Reset`	Segundos para que se reinicie el minuto.
`Retry-After`	En un 429, segundos que debes esperar.

Errores

Siempre con la forma {"error":{"code":"…","message":"…"}}. El message está en español y se puede mostrar a la persona usuaria.

HTTP	code	Cuándo
400	`validation`, `pagination_too_deep`	Parámetros no válidos o página más allá de los primeros 100 resultados.
401	`unauthorized`, `key_revoked`	Falta la clave, no es válida o fue revocada.
402	`no_credits`	Tu cuenta no tiene créditos.
403	`forbidden`, `key_suspended`, `plan_required`	Sin el permiso necesario, clave suspendida o API apagada para tu cuenta.
404	`not_found`	El registro o el endpoint no existe.
429	`rate_limited`, `quota_exceeded`	Límite por minuto, cuota del día o tope del mes. Respeta `Retry-After`.

Endpoints

Todos son GET y todos piden clave, salvo /v1/openapi.json.

GET /v1/leyes/buscar 1 crédito

Buscar leyes

Permiso leyes:read.

Parámetro	Dónde	Descripción
`q` obligatorio	consulta	Búsqueda (3 a 200 caracteres)
`entidad`	consulta	«Federal» o el nombre de una entidad federativa
`pagina`	consulta	Página de 20 resultados. Solo se recorren los primeros 100 resultados de cada búsqueda.

GET /v1/leyes/{id} 1 crédito

Una ley: datos e índice

Permiso leyes:read. No incluye el texto completo.

Parámetro	Dónde	Descripción
`id` obligatorio	ruta	Id de la ley

GET /v1/leyes/{id}/articulos/{clave} 1 crédito

Un artículo de una ley

Permiso leyes:read. La clave es la del índice («27», «27-bis», «transitorio-1»).

Parámetro	Dónde	Descripción
`id` obligatorio	ruta	Id de la ley
`clave` obligatorio	ruta	Clave del artículo

GET /v1/articulos/buscar 1 crédito

Buscar artículos

Permiso leyes:read. Búsqueda por texto y por sentido.

Parámetro	Dónde	Descripción
`q` obligatorio	consulta	Búsqueda (3 a 200 caracteres)
`entidad`	consulta	«Federal» o el nombre de una entidad federativa
`pagina`	consulta	Página de 20 resultados. Solo se recorren los primeros 100 resultados de cada búsqueda.

GET /v1/tesis/buscar 1 crédito

Buscar tesis

Permiso tesis:read.

Parámetro	Dónde	Descripción
`q` obligatorio	consulta	Búsqueda (3 a 200 caracteres)
`pagina`	consulta	Página de 20 resultados. Solo se recorren los primeros 100 resultados de cada búsqueda.

GET /v1/tesis/{registro} 1 crédito

Una tesis

Permiso tesis:read.

Parámetro	Dónde	Descripción
`registro` obligatorio	ruta	Registro digital

GET /v1/sentencias/buscar 2 créditos

Buscar sentencias

Permiso sentencias:read (se habilita por cuenta).

Parámetro	Dónde	Descripción
`q` obligatorio	consulta	Búsqueda (3 a 200 caracteres)
`pagina`	consulta	Página de 20 resultados. Solo se recorren los primeros 100 resultados de cada búsqueda.

GET /v1/sentencias/{id} 2 créditos

Una sentencia