{
  "openapi": "3.0.1",
  "info": {
    "title": "FDA MAUDE, 510(k) & Warning Letters Scraper and Alerts",
    "description": "Track FDA 510(k) device clearances, MAUDE adverse event reports (deaths, injuries, malfunctions) and warning letters from fda.gov in one Actor. Filter by device, company, product code or FDA office. 'Only new' mode for daily regulatory alerts. No API key, no login.",
    "version": "0.1",
    "x-build-id": "m3HbEhbqEd7TQSdry"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/radiant_opuntia~fda-compliance-alerts/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-radiant_opuntia-fda-compliance-alerts",
        "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/radiant_opuntia~fda-compliance-alerts/runs": {
      "post": {
        "operationId": "runs-sync-radiant_opuntia-fda-compliance-alerts",
        "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/radiant_opuntia~fda-compliance-alerts/run-sync": {
      "post": {
        "operationId": "run-sync-radiant_opuntia-fda-compliance-alerts",
        "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": {
          "dataset": {
            "title": "What to watch",
            "enum": [
              "510k",
              "maude",
              "warning_letters"
            ],
            "type": "string",
            "description": "510(k) = new FDA device clearances (decisions). MAUDE = adverse event / malfunction / death reports on medical devices. Warning letters = FDA enforcement letters to drug, device, food, cosmetic and tobacco firms.",
            "default": "510k"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "510(k): matches the device name. MAUDE: matches the brand or generic device name. Warning letters: matches the company name or the violation subject (e.g. 'CGMP', 'Adulterated', 'Unapproved')."
          },
          "company": {
            "title": "Company",
            "type": "string",
            "description": "510(k): applicant. MAUDE: manufacturer. Warning letters: company name. Example: 'Medtronic'."
          },
          "productCodes": {
            "title": "FDA product codes (510(k) and MAUDE)",
            "type": "array",
            "description": "Three-letter FDA product codes, e.g. 'DSP' (intra-aortic balloon pump) or 'QFG' (insulin pump controller). Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Look back (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only records with a decision / received / posted date in the last N days. Note: openFDA publishes 510(k) weekly and MAUDE about monthly, so use 30+ days for MAUDE. Ignored if a start date is set.",
            "default": 30
          },
          "startDate": {
            "title": "Start date (optional)",
            "type": "string",
            "description": "YYYY-MM-DD. Overrides the look back."
          },
          "endDate": {
            "title": "End date (optional)",
            "type": "string",
            "description": "YYYY-MM-DD. Leave empty for today."
          },
          "decisions": {
            "title": "510(k) decision",
            "type": "array",
            "description": "Only for 510(k). SESE = Substantially Equivalent. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "SESE",
                "SESK",
                "SESU",
                "SESP",
                "SESD",
                "SEKD",
                "SESG"
              ],
              "enumTitles": [
                "SESE - Substantially equivalent",
                "SESK - Substantially equivalent (with limitations)",
                "SESU - Substantially equivalent (unsterile / other)",
                "SESP - Substantially equivalent (postmarket)",
                "SESD - Substantially equivalent (de novo down-classification)",
                "SEKD - Substantially equivalent (kit)",
                "SESG - Substantially equivalent (guidance)"
              ]
            },
            "default": []
          },
          "clearanceTypes": {
            "title": "510(k) clearance type",
            "type": "array",
            "description": "Only for 510(k).",
            "items": {
              "type": "string",
              "enum": [
                "Traditional",
                "Special",
                "Abbreviated",
                "Direct",
                "Dual Track"
              ],
              "enumTitles": [
                "Traditional",
                "Special",
                "Abbreviated",
                "Direct",
                "Dual Track"
              ]
            },
            "default": []
          },
          "applicantState": {
            "title": "Applicant state (510(k))",
            "type": "string",
            "description": "Two-letter US state of the 510(k) applicant, e.g. 'MN'. Leave empty for all."
          },
          "eventTypes": {
            "title": "MAUDE event types",
            "type": "array",
            "description": "Only for MAUDE. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "Death",
                "Injury",
                "Malfunction",
                "Other",
                "No answer provided"
              ],
              "enumTitles": [
                "Death",
                "Injury",
                "Malfunction",
                "Other",
                "No answer provided"
              ]
            },
            "default": []
          },
          "issuingOffices": {
            "title": "Issuing office (warning letters)",
            "type": "array",
            "description": "Only warning letters from FDA offices whose name contains one of these words, e.g. 'CDRH' (devices), 'CDER' (drugs), 'Human Foods', 'Tobacco'. Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeNarrative": {
            "title": "Include MAUDE narrative",
            "type": "boolean",
            "description": "Include the first part of the event description text for MAUDE reports (up to 1,500 characters).",
            "default": true
          },
          "onlyNew": {
            "title": "Only new since last run",
            "type": "boolean",
            "description": "Skip records already returned by a previous run with the same alert name. Use this for daily alerts.",
            "default": false
          },
          "stateKey": {
            "title": "Alert name (for only-new mode)",
            "type": "string",
            "description": "Name this alert so each saved search tracks its own history, e.g. 'device-deaths'. Leave empty to derive it from the search."
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Maximum number of records to return in one run.",
            "default": 200
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}