{ "openapi": "3.0.1", "info": { "title": "PubMed Papers API", "description": "Search PubMed and Europe PMC papers, or look up PMIDs, PMCIDs and DOIs. One row per paper with title, abstract snippet, journal, year, DOI, MeSH terms, keywords, citation count and open access flag. No author fields. Independent tool, not affiliated with Europe PMC or NCBI.", "version": "0.0", "x-build-id": "mBwSuEzVFpdhdxIox" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/conserving_celerytop~pubmed-europepmc-papers-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-conserving_celerytop-pubmed-europepmc-papers-api", "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/conserving_celerytop~pubmed-europepmc-papers-api/runs": { "post": { "operationId": "runs-sync-conserving_celerytop-pubmed-europepmc-papers-api", "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/conserving_celerytop~pubmed-europepmc-papers-api/run-sync": { "post": { "operationId": "run-sync-conserving_celerytop-pubmed-europepmc-papers-api", "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", "properties": { "queries": { "title": "Search queries", "maxItems": 50, "type": "array", "description": "Enter one search per line, in plain words or in PubMed and Europe PMC syntax, for example: CRISPR AND gene therapy, or MESH:\"Diabetes Mellitus\" AND exercise. Leave empty if you only look up identifiers.", "items": { "type": "string" } }, "searchIn": { "title": "Search in", "enum": [ "title_abstract", "everywhere" ], "type": "string", "description": "Where plain search words must appear. Title and abstract gives on-topic results. A query that names a field, such as MESH:\"Asthma\", is used as typed.", "default": "title_abstract" }, "ids": { "title": "PMIDs, PMCIDs or DOIs", "maxItems": 1000, "type": "array", "description": "Enter one identifier per line: a PubMed ID such as 31516036, a PMC ID such as PMC3000000, or a DOI such as 10.1038/nature12373. An identifier that matches nothing returns one not_found row. Filters do not apply to lookups.", "items": { "type": "string" } }, "listDatasetId": { "title": "Dataset with the list", "type": "string", "description": "Pick an Apify Dataset that holds your list, one entry per item. It is added to the entries typed above." }, "listDatasetField": { "title": "Field in the dataset", "type": "string", "description": "Name of the dataset field that holds the entry. Leave empty to use the first text field it finds." }, "listFileUrl": { "title": "List file URL", "type": "string", "description": "Web address of a .txt, .csv or .json file with one entry per line. A header row is skipped. Up to 10 MB." }, "yearFrom": { "title": "Publication year from", "minimum": 1800, "type": "integer", "description": "Keep papers published in this year or later, for example 2020." }, "yearTo": { "title": "Publication year to", "minimum": 1800, "type": "integer", "description": "Keep papers published in this year or earlier, for example 2025." }, "openAccessOnly": { "title": "Open access only", "type": "boolean", "description": "Keep only papers with a free full text in Europe PMC.", "default": false }, "publicationTypes": { "title": "Publication types", "type": "array", "description": "Keep only these publication types. Leave empty for all types.", "items": { "type": "string", "enum": [ "Review", "Systematic Review", "Meta-Analysis", "Clinical Trial", "Randomized Controlled Trial", "Case Reports", "Guideline" ] } }, "source": { "title": "Source", "enum": [ "pubmed", "preprints", "all" ], "type": "string", "description": "Which part of Europe PMC to search. PubMed records is the default.", "default": "pubmed" }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "most_cited" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "Return only items that this monitor has not delivered before. The first run returns everything and becomes the baseline. Use it with a daily schedule.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Names the memory of this monitor. Use one name per saved task, so two tasks never share their memory.", "default": "default" }, "abstractMode": { "title": "Abstract mode", "enum": [ "snippet", "none", "full" ], "type": "string", "description": "Europe PMC says articles stay under publisher copyright. Snippet returns the first 300 characters and is the default. Full returns the whole abstract only for open access papers with a license that allows commercial use (cc0, cc by, cc by-sa). Papers with a non-commercial or no-derivatives license, or no license, return a snippet. The field abstractTruncatedReason tells you why a text was cut.", "default": "snippet" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Return at most this many rows in total, across all searches and lookups, including not_found rows. Each row returned is one charged result.", "default": 100 } } }, "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 } } } } } } } } } }