De cero a la primera respuesta en cinco minutos.
Una API key, un comando y tu agente ya consulta fuentes oficiales de Argentina, Brasil, Chile y México. Esta página es la referencia completa: herramientas, parámetros, errores y límites, con respuestas reales del servidor.
Primeros pasos
1. Obtén tu key
Elige un plan en la página de planes y entra con tu email: te enviamos un enlace, sin contraseña. En el panel, genera una API key. Se muestra una sola vez, así que guárdala como un secreto. Toda key empieza con jn_live_.
2. Conecta tu cliente
El servidor habla MCP por HTTP (streamable HTTP) y se autentica con la key en un header. Sirve cualquier cliente que acepte un servidor remoto por HTTP con headers.
Endpoint, transporte y header: es todo lo que necesita un cliente. El MCP acepta X-API-Key: <key> o Authorization: Bearer <key>. El servidor no guarda estado: cada solicitud se sostiene sola.
Claude en la web y en escritorio, y ChatGPT, agregan servidores remotos con OAuth, no con API keys. OAuth está en camino; mientras tanto, usa uno de los clientes de arriba.
3. Tu primera llamada REST
La misma key abre la API REST. Una llamada, una respuesta en JSON:
Prueba esto con tu agente
- «Busca las tesis de la Suprema Corte sobre la suspensión del acto reclamado en el amparo y dame el enlace oficial de cada una».
- «¿Qué leyes modificaron la Ley 24.240 de Defensa del Consumidor? Ordénalas por fecha».
- «Busca fallos de la SCBA sobre despido por embarazo desde 2020 y resume el criterio, citando cada fallo».
Las cuatro herramientas
Respuestas reales del servicio, recortadas por largo.
search
Busca en todas las fuentes de tu plan. Devuelve resultados ordenados por relevancia, cada uno con su enlace oficial.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
query | string | obligatorio | Palabras clave o una cita («Ley 24.240»). |
country | string | — | Código ISO: AR, BR, CL o MX. Sin él, todos los países de tu plan. |
source | string | — | Un id de fuente de list_sources, por ejemplo AR/SCBA. |
type | string | — | Tipo de documento tal como figura en los resultados: legislation, case_law. |
date_from · date_to | string | — | Fechas ISO, AAAA-MM-DD. |
tipo_norma · numero_norma | string | — | Filtros exactos de InfoLEG: Ley y 24240. |
limit | integer | 10 | Resultados por página, de 1 a 50. |
offset | integer | 0 | Resultados a saltear, hasta 1.000. |
Cada resultado trae id (úsalo con get_document), source, type, title, citation, date, issuer, url (la fuente oficial), un text_snippet con las coincidencias marcadas con <mark> y un score de relevancia.
get_document
Trae los metadatos y el texto de un documento por el id numérico que devuelve search. Los textos largos llegan por partes.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
id | integer | obligatorio | El id de un resultado de búsqueda. |
max_chars | integer | 20000 | Caracteres de texto por llamada, hasta 100.000. |
offset_chars | integer | 0 | Desde dónde leer. Pasa el text_next_offset anterior. |
text_length es el largo total; text_next_offset vale null cuando ya leíste hasta el final.
list_sources
Lista las fuentes que tu key puede leer, con totales por país y la fecha de la última corrida de actualización de cada fuente.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
country | string | — | AR, BR, CL o MX. Sin él, todos los países de tu plan. |
doc_count cambia todos los días, por eso el ejemplo lo oculta. last_run es la fecha de la última actualización de esa fuente.
get_relations
Recorre la legislación argentina: qué normas modifican una ley y qué leyes modifica ella. Datos de InfoLEG.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
id | integer | obligatorio | El id de un documento de InfoLEG (source = AR/INFOLEG-SEED). |
direction | string | both | modificada_por, modifica_a o both. |
limit | integer | 50 | Relaciones por página, de 1 a 200. |
cursor | string | — | El next_cursor anterior. |
Cada relación apunta a la otra norma por related_document_id, que puedes pasar a get_document.
API REST
La API REST lee los mismos datos que las herramientas. Envía la key en X-API-Key: la API REST no acepta Authorization: Bearer.
URL base: https://api.jurisnet.ai/api/raw
| Método y ruta | Herramienta | Notas |
|---|---|---|
GET /search?q=… | search | Los mismos filtros, con q en lugar de query. limit de 1 a 100, 20 por defecto. Sin offset: para paginar a fondo, usa el MCP. |
GET /documents/{id} | get_document | Todo el texto disponible en una sola respuesta, más raw_payload (los metadatos propios de la fuente), fetched_at y last_seen_at. |
GET /sources | list_sources | Incluye el status de cada fuente. |
GET /documents/{id}/relations | get_relations | direction, limit (1 a 200) y cursor. |
Búsqueda y filtros
- Escribe pocas palabras clave, en el idioma de los documentos: español para Argentina, Chile y México; portugués para Brasil.
- Pasa
countrysiempre que lo sepas, ysourcecuando sepas dónde está la respuesta. Acota la búsqueda y la hace más rápida. - Cita las normas por número:
Ley 24.240,Decreto 70/2023. - La respuesta trae
total, la cantidad de coincidencias. Con la búsqueda mejorada traehas_moreen su lugar, ymatch: "any_terms"cuando ningún documento tenía todas las palabras y los resultados pasan a documentos con algunas.
Paginado
search: sumalimitaoffseten cada llamada. Hasta 1.000 resultados de profundidad.get_document: vuelve a llamar conoffset_chars=text_next_offsethasta que seanull.get_relations: pasanext_cursorcomocursorhasta que seanull.
Errores y límites
Los errores de autenticación y de límite llegan como códigos HTTP:
Dentro de una herramienta, los problemas de la solicitud vuelven como un resultado normal con un campo error: un documento que no existe o está fuera de tu plan, un país que tu plan no incluye, un cursor inválido. Tu agente lee el mensaje y se corrige.
La API REST usa códigos HTTP para todo:
Límites
- Solo: 30 solicitudes por minuto por key, 1 key activa.
- Builder: 120 solicitudes por minuto por key, hasta 5 keys activas.
- Si superas el límite, recibes
429conRATE_LIMITED. Espera unos segundos y reintenta. - Una key revocada responde
401. Las keys se revocan cuando termina la suscripción. - Cada key lee los países de su plan: hasta 2 a elección con Solo; con Builder, hasta 5, que hoy son los cuatro disponibles (AR, BR, CL, MX). Pedir un país fuera de tu plan devuelve un error.
Texto completo, sumario o ficha
Cada documento trae sus metadatos, su cita y el enlace oficial. Cuánto texto lo acompaña depende de la fuente: en Brasil la mayoría de los documentos trae el texto completo; en Argentina, Chile y México la mayoría son fichas, con el texto donde la fuente lo publica.
- Completo:
texttrae el documento entero, tal como lo publica la fuente. - Parcial:
texttrae un resumen que escribe la propia fuente (un sumario o una tesis), o el texto de solo una parte de la colección. - Ficha:
texttrae los metadatos y una descripción breve. El documento completo está enurl, muchas veces un PDF oficial.
Cómo citar
- Cita la
url: es la fuente oficial. JurisNet es el camino al documento, no el documento. - Arma la referencia con
titleocitation,issuerydate. - Antes de apoyarte en una norma, verifica en el sitio oficial que siga vigente y que ningún texto posterior la haya reemplazado.
JurisNet devuelve documentos de fuentes oficiales. No presta asesoramiento jurídico y no garantiza que un documento esté completo, actualizado o vigente.
¿Falta algo o hay un error en esta página? Escríbenos · help@jurisnet.ai