{ "openapi": "3.0.1", "info": { "title": "PubMed articles search - abstracts, authors, MeSH (E-utilities)", "description": "Search PubMed via NCBI's public E-utilities (esearch + efetch): one row per article with PMID, title, abstract, authors, journal, publication date, DOI, PMC id, MeSH terms, keywords and publication types. PubMed query syntax, date range, optional NCBI API key. Default: GLP-1 weight loss, last year.", "version": "0.1", "x-build-id": "LShUtnt0CkEuSwfcm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/retrainmapdata~pubmed-articles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-retrainmapdata-pubmed-articles", "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/retrainmapdata~pubmed-articles/runs": { "post": { "operationId": "runs-sync-retrainmapdata-pubmed-articles", "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/retrainmapdata~pubmed-articles/run-sync": { "post": { "operationId": "run-sync-retrainmapdata-pubmed-articles", "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": { "query": { "title": "Query (PubMed syntax)", "type": "string", "description": "Any PubMed search, exactly as on pubmed.ncbi.nlm.nih.gov: plain words, field tags such as semaglutide[Title], diabetes[MeSH Terms], randomized controlled trial[Publication Type], Smith J[Author], and AND / OR / NOT. PubMed's own query translation is stored in the run summary." }, "date_from": { "title": "Published on or after (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional; filters on the publication date (datetype=pdat). When both dates are empty the Actor uses the last 365 days. Use 1900-01-01 for no lower bound." }, "date_to": { "title": "Published on or before (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional, inclusive." }, "sort": { "title": "Sort by", "enum": [ "pub_date", "relevance", "most_recent" ], "type": "string", "description": "esearch sort: publication date (newest first), relevance (PubMed best match), or most recently added to PubMed.", "default": "pub_date" }, "include_abstracts": { "title": "Include abstracts", "type": "boolean", "description": "When off, the abstract column is left empty (the rest of the row is unchanged).", "default": true }, "max_records": { "title": "Maximum records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many articles have been written. esearch returns at most 10,000 ids per query; narrow the date range for more. Articles are fetched 100 per efetch request.", "default": 200 }, "ncbi_api_key": { "title": "NCBI API key (optional)", "type": "string", "description": "Raises NCBI's limit from 3 to 10 requests per second (free, from https://account.ncbi.nlm.nih.gov/settings/). Sent only to eutils.ncbi.nlm.nih.gov as the api_key parameter; never logged or stored." }, "contact_email": { "title": "Contact e-mail (NCBI email parameter + From: header)", "type": "string", "description": "NCBI asks every E-utilities client to identify itself with tool and email parameters (tool=retrainmap); the address is also sent in the standard From: request header (RFC 9110 s10.1.2).", "default": "info@steelyardclinical.com" } } }, "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 } } }, "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 } } } } } } } } } }