{
  "openapi": "3.0.1",
  "info": {
    "title": "PubMed Scraper — Medical Articles, Abstracts & New Paper Alerts",
    "description": "Search PubMed — 40M+ medical and life-science articles — by keyword, author, journal or date. Get titles, abstracts, authors, PMID, DOI and MeSH terms as clean records. No API key needed. $0.002 per article. New-paper alerts on any saved search.",
    "version": "0.0",
    "x-build-id": "v6yn87iukj37Rgyz0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magnova~pubmed-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magnova-pubmed-scraper",
        "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/magnova~pubmed-scraper/runs": {
      "post": {
        "operationId": "runs-sync-magnova-pubmed-scraper",
        "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/magnova~pubmed-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-magnova-pubmed-scraper",
        "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": {
          "authors": {
            "title": "Authors (optional — empty = all)",
            "type": "array",
            "description": "Optional author filter in PubMed's byline format, surname + initials (e.g. \"Fauci AS\", \"Smith J\"). Several names are combined with OR. Leave empty for all authors.",
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "Date from (optional)",
            "type": "string",
            "description": "Optional window start (ISO date, e.g. \"2026-10-01\"): only articles published on or after this date. The publication date is the electronic date when the article has one, else the journal issue date, and the window is enforced on exactly that date."
          },
          "dateTo": {
            "title": "Date to (optional)",
            "type": "string",
            "description": "Optional window end (ISO date, e.g. \"2026-10-31\"): only articles published on or before this date. May be given with or without Date from."
          },
          "journals": {
            "title": "Journals (optional — empty = all)",
            "type": "array",
            "description": "Optional journal filter: only articles published in these journals, by their full title as PubMed indexes it (e.g. \"Nature\", \"Lancet\", \"New England Journal of Medicine\"). Several titles are combined with OR. Leave empty for all journals.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum articles per run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Hard cap on articles delivered (and charged) in one run. Results come back newest first (by publication date), so a capped run delivers the most recent matches. Articles a capped run could not deliver stay unseen in monitoring mode and are delivered by the next run if they still fall in its window."
          },
          "maxTotalChargeUsd": {
            "title": "Maximum total charge per run (USD)",
            "minimum": 0.01,
            "type": "number",
            "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged articles reach this amount (checked conservatively at the highest per-article price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Undelivered new articles stay unseen, so the next run delivers them. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly."
          },
          "monitorOnlyNew": {
            "title": "Start monitoring silently (skip the first baseline)",
            "type": "boolean",
            "description": "Off (default): the first run delivers the search's current articles as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current articles without delivering or charging anything, and only articles published afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run."
          },
          "monitorStore": {
            "title": "Monitor state store (for only-new delivery)",
            "type": "string",
            "description": "A key-value store this Actor may read and write to remember which articles it has already seen — this is what makes only-new delivery work across runs. Use one store per saved search. Pick any store you own; the Actor keeps one small state record in it. Without a store, every run delivers the search's articles as a baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes. The Actor remembers every article it processed (including ones outside the window), so widening the window later does not re-deliver old articles."
          },
          "publicationTypes": {
            "title": "Publication types (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by PubMed publication type (e.g. \"Review\", \"Clinical Trial\", \"Meta-Analysis\", \"Randomized Controlled Trial\", \"Case Reports\"). Several types are combined with OR. Leave empty for all types.",
            "items": {
              "type": "string"
            }
          },
          "publishedSince": {
            "title": "Published on/after (stateless cursor)",
            "type": "string",
            "description": "Optional stateless cursor for workflow tools (Make, Zapier, your own scheduler) that hold state themselves: only articles published on this ISO date or later are delivered — for example \"2026-11-01\" or \"2026-11-01T00:00:00Z\". Publication dates compare by day, boundary-inclusive. The cursor raises the window start; it does not extend the window end. Leave empty for the normal window behavior."
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "string",
            "description": "What to search for in PubMed — a topic, a condition, a drug, a technique (e.g. \"machine learning\", \"glioblastoma immunotherapy\"). Full PubMed search syntax is supported, including field tags, AND/OR/NOT and quoted phrases. Combined with the filters below using AND. Leave empty to search by author, journal or publication type alone."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}