Saltar al contenido principal
Citelink

API

Verifica cualquier cosa.
En una sola solicitud.

Citelink ofrece un endpoint que verifica una URL, una afirmación o una publicación en redes y devuelve un informe estructurado. Dos verificaciones al día no necesitan cuenta; inicia sesión y envía tu cookie de sesión para tener 25. Las respuestas de la API están en inglés.

Qué puedes verificar

  • urlUn artículo de noticias, un estudio o cualquier página web. Citelink revisa las fuentes, contrasta las afirmaciones y devuelve un informe fundamentado.
  • claimUna afirmación concreta para verificar (por ejemplo, “las vacunas causan autismo”). Tú aportas la afirmación; nosotros buscamos y evaluamos las pruebas.
  • social_postUn tuit, una publicación de Reddit u otro contenido de redes. Rastreamos la afirmación original y cómo se difundió.

Cómo funciona

  1. 1Opcional: inicia sesión y copia tu cookie de sesión para tener 25 verificaciones al día en lugar de 2.
  2. 2Envía una solicitud POST a /api/v1/verify con tu contenido y su tipo.
  3. 3Recibe un informe estructurado con las fuentes, su postura y la confianza de la verificación.

Endpoint

POST/api/v1/verify

Cuerpo de la solicitud

{
  "type": "url",
  "value": "https://example.com/article",
  "context": "optional extra details"
}
type
'url' | 'claim' | 'social_post' obligatorio
value
string obligatorio, de 1 a 10.000 caracteres tras quitar espacios
context
string opcional, hasta 4.000 caracteres. Los valores vacíos se descartan.

Límites y autenticación

  • Auth: opcional. Sin cookie de sesión tienes 2 verificaciones gratis al día; con ella (igual que al iniciar sesión), 25 al día. Por ahora no hace falta clave de API.
  • Rate limit: 5 solicitudes cada 60s. Si te pasas, recibes 429. Cuando se agotan las verificaciones gratuitas también se devuelve 429, con code: "sign_in_required".
  • Timeout: cada verificación dura hasta 60s. Encadena la búsqueda, el análisis de postura y la verificación una tras otra.

Ejemplo de solicitud

curl -X POST https://www.citelink.news/api/v1/verify \
  -H "Content-Type: application/json" \
  -H "Cookie: __Secure-authjs.session-token=..." \
  -d '{
    "type": "url",
    "value": "https://example.com/fake-news",
    "context": "checking a viral tweet about it"
  }'

Códigos de estado

200Correcto. Devuelve el informe de verificación con las fuentes y su postura.
400Entrada no válida: revisa type, value o context.
401La sesión caducó. Vuelve a iniciar sesión o quita la cookie para usar las verificaciones gratuitas.
429Límite de frecuencia, límite diario alcanzado o verificaciones gratuitas agotadas (code: "sign_in_required").
503Se alcanzó la capacidad diaria o el tope de gasto, o la verificación no está disponible temporalmente. Inténtalo más tarde.
500Error interno. Algo falló de nuestro lado.

Más endpoints

GET/api/v1/verify/quota

Verificaciones que le quedan a quien llama en el periodo actual: las 25 de una cuenta o las 2 gratuitas de quien no ha iniciado sesión.

{ "signedIn": true, "used": 7, "limit": 25, "remaining": 18 }
GET/api/v1/stories/lookup?url=…

Si un artículo pertenece a una noticia que Citelink ha publicado. Público, sin cuenta, con un límite de 60 solicitudes por minuto por dirección. Devuelve { "found": false } si no hay coincidencia.

{
  "found": true,
  "story": {
    "headline": "…",
    "whyItMatters": "…",
    "publishedAt": "2026-10-18T12:00:00.000Z",
    "url": "https://www.citelink.news/brief/…",
    "storyUrl": "https://www.citelink.news/story/…",
    "outletCount": 6,
    "outlets": ["Reuters", "AP", "…"]
  }
}

Investigación y uso masivo

Investigadores, estudiantes y redacciones que estudian cómo se difunden las afirmaciones pueden usar los endpoints anteriores dentro de los límites diarios. Si necesitas más verificaciones para un estudio, o una exportación masiva de los resúmenes publicados y su procedencia, escribe a hello@citelink.news contándonos qué investigas y cuántas verificaciones necesitas aproximadamente. Los resúmenes publicados también están disponibles por RSS en /rss.xml. Documentamos aquí los cambios a medida que se publican; nada de esta página describe una ruta que no esté activa.