{
  "openapi": "3.0.1",
  "info": {
    "title": "UK and EU Product Recalls and Safety Alerts Feed",
    "description": "Product recalls API for the UK and EU. Search or monitor OPSS product recalls, FSA food and allergy alerts, MHRA drug and medical device alerts and EU Safety Gate (RAPEX) notices in one schema, by brand or barcode (GTIN/EAN). Alert mode for scheduled watch lists. Official sources, pay per result.",
    "version": "0.1",
    "x-build-id": "hEOFDaW0Rd6h6l3e4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yappman~uk-eu-recalls-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yappman-uk-eu-recalls-feed",
        "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/yappman~uk-eu-recalls-feed/runs": {
      "post": {
        "operationId": "runs-sync-yappman-uk-eu-recalls-feed",
        "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/yappman~uk-eu-recalls-feed/run-sync": {
      "post": {
        "operationId": "run-sync-yappman-uk-eu-recalls-feed",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "new-since",
              "alert"
            ],
            "type": "string",
            "description": "search reads the last sinceDays days; new-since reads everything published on or after the date in since; alert returns only items your alertId has never been sent.",
            "default": "search"
          },
          "sources": {
            "title": "Sources",
            "type": "array",
            "description": "Which sources to read. Canada is opt-in and is not read unless you add it.",
            "items": {
              "type": "string",
              "enum": [
                "opss",
                "fsa",
                "mhra",
                "safetygate",
                "canada"
              ],
              "enumTitles": [
                "UK OPSS product recalls",
                "UK FSA food alerts",
                "UK MHRA drug and device alerts",
                "EU Safety Gate",
                "Canada recalls and safety alerts"
              ]
            },
            "default": [
              "opss",
              "fsa",
              "mhra",
              "safetygate"
            ]
          },
          "keywords": {
            "title": "Keywords (all must match)",
            "type": "array",
            "description": "Every keyword must appear in the title, product, brand, hazard or category. Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "kinds": {
            "title": "Kinds",
            "type": "array",
            "description": "Match any (substring) of the row kind, for example food recall, vehicle recall, medical device recall, allergy alert, field safety notices. Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "Brands or companies",
            "type": "array",
            "description": "Match any (substring). Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Match any (substring), for example toys or cosmetics. Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "riskLevels": {
            "title": "Risk levels",
            "type": "array",
            "description": "Match any (substring), for example serious or high. The wording differs by source. Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "barcodes": {
            "title": "Barcodes (GTIN/EAN)",
            "type": "array",
            "description": "Match any, up to 2,000 GTIN/EAN/UPC codes: digits only (spaces or hyphens allowed), 8 to 14 digits each; anything else is refused before the run starts. 12, 13 and 14-digit forms of one code match each other. Rows with no barcode never match.",
            "items": {
              "type": "string"
            }
          },
          "countriesOfOrigin": {
            "title": "Countries of origin",
            "type": "array",
            "description": "Match any (Safety Gate rows only carry this). Up to 200 entries.",
            "items": {
              "type": "string"
            }
          },
          "sinceDays": {
            "title": "Days back (search, alert)",
            "minimum": 1,
            "maximum": 400,
            "type": "integer",
            "description": "How many days back to read, counted from today (1 to 400). Used by search and alert; new-since uses the since date instead.",
            "default": 30
          },
          "since": {
            "title": "Since date (new-since)",
            "type": "string",
            "description": "Read everything published on or after this date (YYYY-MM-DD). Required for new-since mode; ignored otherwise unless you also set it for search."
          },
          "alertId": {
            "title": "Alert id (alert)",
            "pattern": "^[a-z0-9][a-z0-9-]{0,39}$",
            "type": "string",
            "description": "Your name for this alert: 1 to 40 lower-case letters, digits or hyphens. The Actor remembers what it sent in a key-value store named recalls-alert-<alertId> in your account."
          },
          "maxItems": {
            "title": "Maximum rows",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Rows are charged one by one; the run never returns more than this.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}