{ "openapi": "3.0.1", "info": { "title": "Academic Papers Search: OpenAlex, Crossref, arXiv, PubMed", "description": "Search research papers across OpenAlex, Crossref, arXiv and PubMed in one run. Results are deduplicated by DOI, arXiv ID and PMID and merged into one row per paper with citations, open-access PDF links and abstracts. Official open APIs, no Google Scholar scraping.", "version": "0.1", "x-build-id": "2a5c0MMCPR3zd8k16" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bisketapis~academic-papers-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bisketapis-academic-papers-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/bisketapis~academic-papers-search/runs": { "post": { "operationId": "runs-sync-bisketapis-academic-papers-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/bisketapis~academic-papers-search/run-sync": { "post": { "operationId": "run-sync-bisketapis-academic-papers-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Keywords or a phrase, for example: graph neural networks drug discovery. The same query is sent to every selected source." }, "sources": { "title": "Sources", "type": "array", "description": "Which open APIs to query. Papers found in several sources are merged into one row.", "items": { "type": "string", "enum": [ "openalex", "crossref", "arxiv", "pubmed" ], "enumTitles": [ "OpenAlex (250M+ works, citations, open-access links)", "Crossref (DOI registry, publisher metadata)", "arXiv (preprints, always open access)", "PubMed (biomedical, abstracts)" ] }, "default": [ "openalex", "crossref", "arxiv", "pubmed" ] }, "yearFrom": { "title": "Published from year", "minimum": 1000, "maximum": 2200, "type": "integer", "description": "Earliest publication year. Leave empty for no limit." }, "yearTo": { "title": "Published up to year", "minimum": 1000, "maximum": 2200, "type": "integer", "description": "Latest publication year. Leave empty for no limit." }, "openAccessOnly": { "title": "Open access only", "type": "boolean", "description": "Return only papers with a known free full text (arXiv, PubMed Central, OpenAlex open-access flag).", "default": false }, "sort": { "title": "Sort by", "enum": [ "relevance", "citations", "date" ], "type": "string", "description": "Relevance blends each source's ranking; papers found by several sources rank higher. Citations use OpenAlex and Crossref counts.", "default": "relevance" }, "maxItems": { "title": "Max papers", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper limit of papers returned (you are charged per paper). Each source is asked for this many before merging.", "default": 50 }, "onlyNew": { "title": "Only papers not seen before (alerts)", "type": "boolean", "description": "Skip papers already returned by an earlier run with the same query, sources, years and open-access setting. Schedule the actor to get new-paper alerts. Remembered in a store named academic-papers-seen.", "default": false }, "openAlexApiKey": { "title": "OpenAlex API key (optional)", "type": "string", "description": "Free key from openalex.org/settings/api. Without one, OpenAlex shares a small daily budget per IP address; add a key if OpenAlex rows are missing on busy days." }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Not needed: the sources are open APIs. Leave empty unless you want requests to leave from an Apify proxy." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }