Scopus APIs

Curso introductorio

Alberto Zigoni SciVal Consultant a.zigoni@elsevier.com

Agenda

Introduccin y aplicaciones Cmo solicitar la activacin de las APIs?

Informaciones que se pueden buscar con las APIs

Cmo buscar y recuperar datos? Preguntas

Introduccin y aplicacines

Qu es una API?

A pplication P rogramming I nterface

Es una forma de habilitar las herramientas de software, en lugar de los usuarios, para consultar Scopus.

Javascript APIs

Federated Search APIs

SciVerse Content APIs

Aplicacines (y polticas de contenidos)

Mostrar publicaccines de Scopus en el sitio web de una institucin o investigador Mostrar citas recebidas para un documento en una pgina web Integracin con Repositorios institucionales, plataformas de gestin de la investigacin, VIVO Bsquedas federadas (Federated search)

Ejemplo: Digital.CSIC

Ejemplo: Honk Kong University Scholars Hub

Ejemplo: Pure

Cmo solicitar la activacin de las APIs?

Cmo solicitar la activacin de las APIs?

Vuestra institucin debe tener una suscripcin a Scopus Ir a http://developers.elsevier.com Clicar sobre Register new Site y completar los campos Enviar un correo a vuestro consultor (Alberto, a.zigoni@elsevier.com) o PSM (David, d.mino@elsevier.com) con esta informacin:
Clave API Alcance de direccines IP (el mismo de Scopus) Direccin de correo electrnico del usuario que pide la activacin Resumen del projecto (para verificar las polticas de contenidos)

Si todo est correcto, en unas 2 o 3 das aproximadamente la activacn se habr completado.

10

Informacin que se pueden buscar con las APIs

11

Estructura de Scopus
ACCIONES
= Buscar / Recuperar = Metadatos

Autores

Documentos

Revistas / Libros

Institucines

12

SciVerse Content APIs: REST Interface

Cada servicio / recurso tiene una direccin web que lo identifica (URL) Los URL para las APIs tienen la estructura siguiente:
Parte fija: http://api.elsevier.com/content Parte central dependiendo de la accin pedida:
Buscar Recuperar Metadatos

Parte final dependiendo de lo que se va buscando / recuperando Parmetros de consulta (cadena de bsqueda, paginado, ordenar, campos pedidos,)

13

Cmo buscar y recuperar datos?

14

Herramientas
Cualquier lenguaje de programacin que puede ejecutar llamadas HTTP (interface REST) Navegador Web
Firefox + RESTClient Chrome + Advanced REST Client

Otros clientes REST Mis herramientas: Firefox + RESTClient

15

Sintaxis para buscar

URL basico = Parte fija + /search/index: http://api.elsevier.com/content/search/index: Que se va buscando:
Documentos: SCOPUS Autores: AUTHOR Institucines: AFFILIATION

Parmetros de bsqueda:
Carcter separador: ? [obligatorio] Cadena de bsqueda: query=<scopus_query_as_in_advanced_search> [obligatorio] Criterios de localizacin: &start= <primero _resultado>&count=<nmero_de_resultados_25_max_200> [opcional] Campos de respuesta [opcional] Criterios de clasificacin [opcional]

16

Ejemplos
Bsqueda de documentos:
http://api.elsevier.com/content/search/index:SCOPUS?query=doi(10.1007/s11192-011-0387-9)&view=COMPLETE

Bsqueda de autores: http://api.elsevier.com/content/search/index:AUTHOR?query=authlast(Escalante) and authfirst(Ricardo)

Bsqueda de institucines: http://api.elsevier.com/content/search/index:AFFILIATION?query=affil(FECyT)

Obtener citas de un documento:

http://api.elsevier.com/content/search/index:SCOPUS?query=doi(10.1007/s11192-011-0387-9)&field=citedby-count

17

Cmo realizar una llamada de bsqueda

La direccin se compone siguiendo las reglas La clave API se pone en un encabezado HTTP X-ELS-ApiKey=<Your_API_Key> Se especifica el formato de datos en un encabezado HTTP
JSON (application/json) XML (application/atom+xml)

Accept=application/atom+xml Version de las APIs es colocado como un encabezado HTTP X-ELS-ResourceVersion=XOCS Vamos ver las APIs en accin...
18

Sintaxis para recuperar

URL bsico = parte fija http://api.elsevier.com/content De donde recuperamos los datos:
Documentos: /abstract Autores: /author Instituciones: /affiliation

Identificacin del objeto:

Documentos: SCOPUS_ID:<Scopus Document ID> (EID, DOI, PUBMED_ID) Autores: AUTHOR_ID:<Scopus Author ID> Instituciones: AFFILIATION_ID:<Scopus Affiliation ID> Vista o campos de respuesta [opcional]

Encabezados como para la bsqueda, pero si queris el formato XML se debe usar este encabezado:

Accept=text/xml
19

Ejemplos
Recuperacin de un documento: http://api.elsevier.com/content/abstract/SCOPUS_ID:84862295360

Recuperacin de un autor: http://api.elsevier.com/content/author/AUTHOR_ID:7004321762

Recuperacin de una institucin: http://api.elsevier.com/content/affiliation/AFFILIATION_ID:60004770

20

Preguntas?

21