Demosciencia

Datos abiertos

API y datos abiertos

Toda la metadata y contenido público de Demosciencia está disponible mediante APIs estándar. Sin autenticación para lectura pública, sin límites de uso razonables (sé cordial con nuestros servidores).

REST (Payload)

Todas las colecciones públicas están expuestas en /api/{collection} con paginación, filtros y sort.

GET
/api/articles?limit=10&depth=1

Lista artículos publicados con autoría y número.

GET
/api/articles/{id}

Detalle de un artículo por ID.

GET
/api/issues?sort=-publishedAt

Números publicados, ordenados del más reciente al más antiguo.

GET
/api/authors?where[orcid][exists]=true

Autoras/es con ORCID verificado.

GET
/api/articles?where[and][0][_status][equals]=published&where[and][1][publishedAt][greater_than]=2025-01-01

Filtros encadenados con sintaxis where[op][...] de Payload.

curl 'https://demosciencia.org/api/articles?limit=3&depth=0' \
  -H 'Accept: application/json'

GraphQL

Endpoint único en /api/graphql. Tipos generados automáticamente desde el esquema de Payload.

query LatestArticles {
  Articles(
    limit: 5
    sort: "-publishedAt"
    where: { _status: { equals: published } }
  ) {
    docs {
      slug
      title
      doi
      publishedAt
      authors { author { fullName orcid } }
      keywords { value }
    }
    totalDocs
  }
}
curl 'https://demosciencia.org/api/graphql' \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"query":"{ Articles(limit:3){ docs{ slug title } } }"}'

OAI-PMH (cosecha por agregadores)

Protocolo Open Archives Initiative para que repositorios y agregadores (DOAJ, BASE, SciELO) descarguen metadata Dublin Core.

GET
/oai-pmh?verb=Identify

Información del repositorio.

GET
/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc

Lista todos los registros en Dublin Core.

GET
/oai-pmh?verb=GetRecord&identifier={oai}&metadataPrefix=oai_dc

Registro individual por identificador OAI.

Atom feed

Suscripción RSS-compatible para lectores y servicios de notificación.

GET
/feed.atom

Últimos artículos publicados, formato Atom 1.0.

JATS XML por artículo

Cada artículo expone su versión JATS 1.3 (Journal Article Tag Suite), formato estándar para SciELO, PubMed Central y agregadores académicos.

GET
/api/articles/{slug}/jats.xml

JATS 1.3 con front (autoría, identificadores), body (cuerpo) y back (referencias).

GET
/api/articles/{slug}/pdf

PDF del artículo (cargado por la editorial o autogenerado).

GET
/api/articles/{slug}/citations

Conteo de citas vía Crossref (is-referenced-by-count) para el artículo y sus referencias con DOI.

Texto completo individual

Descarga /articulos/{slug}/fulltext.md para texto, secciones, referencias y enlaces a figuras. El catálogo /llms-full.txt contiene resúmenes y enlaces, no el cuerpo completo.

Los PDF están en /articulos/{slug}/fulltext.pdf. Los artículos con tablas o fórmulas requieren PDF editorial; una exportación que no pueda conservar su contenido devuelve HTTP 422.

Identificadores y datos estructurados

Cada artículo expone metadatos para máquinas:

  • DOI persistente vía Crossref.
  • Highwire Press meta tags (citation_*) en cada página de artículo, para Google Scholar.
  • JSON-LD ScholarlyArticle con autoría+ORCID, license y jerarquía Periodical → Volume → Issue → Article.
  • ISSN-e pendiente.

Buenas prácticas

  • Identifica tu cliente con un User-Agent descriptivo (incluye contacto).
  • Cachea resultados; los datos cambian con baja frecuencia.
  • Si vas a cosechar todo el corpus, usa OAI-PMH con resumptionToken. La primera petición usa metadataPrefix=oai_dc; las siguientes envían únicamente verb y el token recibido. Cada página contiene hasta 100 registros. Los tokens expiran en una hora. Los filtros from/until admiten días completos o segundos UTC, con igual granularidad. Si un registro cambia durante la cosecha, recupéralo en la siguiente cosecha incremental.
  • Reporta abusos o problemas a el correo editorial.

Licencia de los datos

La metadata se publica bajo CC0 (dominio público). El contenido de los artículos hereda la licencia indicada en cada uno (por defecto CC BY 4.0).