GraphQL API

Documentación API

Schema auto-generado desde los lexicons AT Protocol de TransparencIA. Consulta, filtra y agrega datos en tiempo real.

Probar en vivo

Endpoint

POSThttps://transparencia-explorer.vercel.app/api/graphql

Acceso

Público; X-API-Key opcional

Content-Type

application/json

Colecciones disponibles

techTransparenciaNewsArticleNoticias indexadas con metadata completa

techTransparenciaNewsSourceMedios y portales como fuentes de información

techTransparenciaNewsEnrichmentAnálisis IA: sentimiento, entidades, orientación política

Notas verificadas en vivo

Ordenamiento

En listas usa sortBy: [{ field: indexedAt, direction: DESC }]. orderBy aplica a consultas *Aggregate.

Filtros booleanos

Los combinadores son AND y OR en mayúsculas; or minúscula falla en validación.

Referencias

source y article son strongRef. Para leer datos de la fuente o artículo usa sourceResolved o articleResolved con fragmentos inline.

Búsquedas temáticas

Usa filtros where sobre campos concretos. Evita keywords ambiguas como campo: también matchean nombres propios como Maru Campos.

Ejemplos de consultas probadas

Artículos recién indexados

graphql

query RecentArticles {
  techTransparenciaNewsArticle(
    first: 10
    sortBy: [{ field: indexedAt, direction: DESC }]
  ) {
    edges {
      node {
        uri
        title
        url
        indexedAt
        publishedAt
        sourceResolved {
          __typename
          ... on TechTransparenciaNewsSource {
            displayName
            baseUrl
          }
        }
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Noticias de agricultura por título

graphql

query AgricultureNews {
  techTransparenciaNewsArticle(
    where: {
      OR: [
        { title: { contains: "agricultura" } }
        { title: { contains: "agropecuario" } }
        { title: { contains: "maíz" } }
        { title: { contains: "ganadería" } }
        { title: { contains: "sequía" } }
        { title: { contains: "cultivos" } }
      ]
    }
    first: 10
    sortBy: [{ field: indexedAt, direction: DESC }]
  ) {
    edges {
      node {
        title
        url
        publishedAt
        sourceResolved {
          __typename
          ... on TechTransparenciaNewsSource {
            displayName
            baseUrl
          }
        }
      }
    }
  }
}

Enriquecimiento con análisis IA

graphql

query EnrichedArticles {
  techTransparenciaNewsEnrichment(
    first: 5
    sortBy: [{ field: indexedAt, direction: DESC }]
  ) {
    edges {
      node {
        summary
        impactLevel
        emotionalTone
        clickbaitScore
        politicalOrientation
        articleResolved {
          __typename
          ... on TechTransparenciaNewsArticle {
            title
            url
          }
        }
      }
    }
  }
}

Agregación por idioma

graphql

query ArticlesByLanguage {
  techTransparenciaNewsArticleAggregate(
    groupBy: [language]
    orderBy: COUNT_DESC
  ) {
    count
    groups {
      language
      count
    }
  }
}

Smoke test del endpoint

bash

curl -X POST https://transparencia-explorer.vercel.app/api/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ __typename }"}'

Capacidades

✓Filtros anidados con eq, in, contains, gt/gte/lt/lte y AND/OR

✓Paginación cursor-based (first, after, pageInfo)

✓Ordenamiento de listas con sortBy sobre campos indexados

✓Búsqueda por campo con contains en title, description y otros campos

✓Resolución de strongRef con sourceResolved y articleResolved

✓Agregaciones con *Aggregate, count, groupBy y COUNT_ASC/DESC

¿Quieres acceso al API?

El endpoint acepta smoke tests públicos. Para uso intensivo o acceso con llave, cuéntanos sobre tu proyecto.

tech@transparencia.tech

También puedes explorar el MCP Server para integraciones con agentes IA.