{ "openapi": "3.0.1", "info": { "title": "Academic Papers Search (unofficial PubMed, arXiv, Crossref)", "description": "Search PubMed, arXiv, and Crossref for scholarly papers and return one de-duplicated row per work. OpenAlex is optional with your own API key. Unofficial; not affiliated with NCBI, arXiv, Crossref, or OpenAlex.", "version": "0.1", "x-build-id": "IbbHTtLdl2767mZcf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plusonets~academic-papers-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plusonets-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/plusonets~academic-papers-search/runs": { "post": { "operationId": "runs-sync-plusonets-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/plusonets~academic-papers-search/run-sync": { "post": { "operationId": "run-sync-plusonets-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", "sources", "maxResultsPerSource", "contactEmail" ], "properties": { "query": { "title": "Query", "minLength": 1, "maxLength": 400, "type": "string", "description": "Keyword query sent to every selected source. Example: machine learning. Date limits are applied separately and are not part of this string.", "default": "machine learning" }, "sources": { "title": "Sources", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Literature sources to search. OpenAlex is skipped unless openalexApiKey is set.", "items": { "type": "string", "enum": [ "pubmed", "arxiv", "crossref", "openalex" ], "enumTitles": [ "PubMed (NCBI E-utilities)", "arXiv", "Crossref", "OpenAlex (your API key)" ] }, "default": [ "pubmed", "arxiv", "crossref" ] }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Keep works published on or after this day (YYYY-MM-DD). arXiv filters on the submission date. Leave empty for no start bound." }, "publishedBefore": { "title": "Published before", "type": "string", "description": "Keep works published on or before this day (YYYY-MM-DD). Leave empty for no end bound." }, "maxResultsPerSource": { "title": "Max results per source", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum papers to return from each source before DOI de-duplication. The default of 3 keeps the daily run small.", "default": 3 }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Return papers this monitor has not already returned. Leave this off for a one-off search. The default input leaves it off so a repeated run still returns papers.", "default": false }, "monitorKey": { "title": "Monitor key", "minLength": 1, "maxLength": 80, "type": "string", "description": "Name of the memory used when only-new mode is on. Use one key per saved search. Changing the query while keeping the key still skips papers the old query already returned.", "default": "default" }, "contactEmail": { "title": "Contact email", "type": "string", "description": "Sent as NCBI's email parameter and Crossref's mailto so those services can reach the person running the search. Defaults to the Actor maintainer's contact address. You can replace it with your own address.", "default": "plusonecares@gmail.com" }, "ncbiApiKey": { "title": "NCBI API key", "type": "string", "description": "Optional key from your NCBI account. Without it this Actor stays under 3 PubMed requests per second. With it, the cap rises to 10 per second. The key is sent only to NCBI." }, "openalexApiKey": { "title": "OpenAlex API key", "type": "string", "description": "Required only when OpenAlex is selected. Create a free key in your OpenAlex account. Keyless OpenAlex calls are not made." } } }, "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 } } } } } } } } } }