{ "openapi": "3.0.1", "info": { "title": "FDA Warning Letters Scraper", "description": "[💰 $15 / 1K] Scrape the official FDA Warning Letters database. Get company, posted and issue dates, issuing office, subject, response and closeout status, letter URL, and full letter text. Filter by keyword, company, office, subject, or date range.", "version": "1.0", "x-build-id": "5qJhamvyoVFHwobby" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~fda-warning-letters-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-fda-warning-letters-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/solidcode~fda-warning-letters-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-fda-warning-letters-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/solidcode~fda-warning-letters-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-fda-warning-letters-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One or more keywords to search across company name, subject, and issuing office (e.g. \"recall\", \"adulterated\", \"CGMP\", or a company name). Each term is searched separately and the results are merged and de-duplicated. Leave blank to collect all warning letters, newest first.", "items": { "type": "string" } }, "companyName": { "title": "Company name contains", "type": "string", "description": "Keep only letters whose recipient company or individual name contains this text (case-insensitive). For example, enter \"Pharma\" to keep only companies with \"Pharma\" in the name. Leave blank to keep every company." }, "issuingOffice": { "title": "Issuing office contains", "type": "string", "description": "Keep only letters issued by an FDA office whose name contains this text (case-insensitive). For example, \"CDER\" or \"Center for Drug\" for drug letters, \"CDRH\" for devices, \"Human and Animal Food\" for food. Leave blank to include every office." }, "subject": { "title": "Subject contains", "type": "string", "description": "Keep only letters whose subject or violation topic contains this text (case-insensitive), e.g. \"unapproved\", \"misbranded\", \"tobacco\", \"CGMP\". Leave blank to include every subject." }, "dateFrom": { "title": "Posted on or after", "type": "string", "description": "Only include letters posted on or after this date. Use the format YYYY-MM-DD (e.g. 2024-01-01). Leave blank for no start date." }, "dateTo": { "title": "Posted on or before", "type": "string", "description": "Only include letters posted on or before this date. Use the format YYYY-MM-DD (e.g. 2025-12-31). Leave blank for no end date." }, "includeLetterBody": { "title": "Include full letter text", "type": "boolean", "description": "Also open each letter's page to capture the full letter text and extra details (reference number, delivery method). Turn this off for faster, cheaper runs that return only the listing-level summary for each letter.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "How many letters to collect in total across all searches. Default 100 — increase for bigger runs, or set to 0 to collect as many as possible (bounded to the full published set of warning letters).", "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 } } }, "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 } } } } } } } } } }