Método: Buscar Artículos Académicos desde un Objetivo General

Este endpoint permite iniciar una búsqueda automatizada de artículos académicos relevantes a partir de un objetivo general de investigación. El sistema analiza el contenido del objetivo y lanza una búsqueda en OpenAlex, una base de datos con más de 250 millones de trabajos procedentes de unas 250.000 fuentes (revistas, repositorios, congresos) y que añade cerca de 50.000 registros cada día.


Endpoint


Autenticación


Input (body en JSON)

{ "user_id": "01H8EZ8PSW2ACDKT7MGQGEJ67M", "general_objective": "Objetivo general de investigación : Evaluar la efectividad de la integración de la inteligencia artificial en el diseño de viviendas residenciales durante un período de un año, con el objetivo de identificar los beneficios y desafíos asociados, y proporcionar recomendaciones para mejorar y optimizar la implementación de la inteligencia artificial en este ámbito, con el fin de incrementar la eficiencia energética, la funcionalidad y el bienestar de los residentes.", "lang": "esp" }
Descripción de los campos:
Campo Tipo Descripción
user_id String Identificador único del usuario.
general_objective String Objetivo general que será utilizado para realizar la búsqueda académica.
lang String Idioma preferido para los resultados: "esp" o "eng".

Output

{ "job_id": 5 }
Campo Tipo Descripción
job_id Integer ID del proceso de búsqueda. Usar en el siguiente paso.

Perfecto, aquí tienes la documentación para el método /get_status_search_paper_from_obj:



Método: Verificar Estado de Búsqueda de Artículos desde Objetivo

Este endpoint permite consultar si ya está lista la búsqueda de artículos académicos realizada con el método /paper_search_from_obj. Cuando el estado es "ready", también entrega los resultados obtenidos, incluyendo metadatos relevantes.


Endpoint


Input (body en JSON)

{ "job_id": 5 }
Campo Tipo Descripción
job_id Integer ID del proceso entregado previamente.

Output (si status = ready)

{ "job_id": 5, "status": "ready", "results": [ { "id": "https://openalex.org/W3131063705", "display_name": "ForeSight - AI-based Smart Living Platform Approach", "publication_year": 2020, "cited_by_count": 2, "authorships": "Jochen Bauer, Michael Hechtel, ...", "locations": "Current Directions in Biomedical Engineering, Publication Server of Goethe University Frankfurt am Main", "open_access": true, "from_abstract": 1 }, { "id": "https://openalex.org/W4403139143", "display_name": "Advanced Building Information Modeling (BIM) for affordable housing projects: Enhancing design efficiency and cost management", "publication_year": 2024, "cited_by_count": 3, "authorships": "None Abiodun Benedict Adeyemi, None Tochi Chimaobi Ohakawa, ...", "locations": "Comprehensive research and reviews in science and technology", "open_access": false, "from_abstract": 1 } ] }
Campo Tipo Descripción
status String "ready" si está completado, "processing" si aún está en curso
results Array Lista de artículos relacionados con el objetivo general.
display_name String Título del artículo.
publication_year Integer Año de publicación.
cited_by_count Integer Número de veces citado.
authorships String Lista de autores.
locations String Publicaciones y bases donde se encuentra.
open_access Boolean Indica si es de acceso abierto.
id URL Enlace al artículo en OpenAlex.
from_abstract Integer Indica si el resultado proviene del análisis del abstract (1 o 0).