AgentDataFeed Product Recalls API

openapi: 3.2.0
info:
  title: agentdatafeed Product Recalls API
  version: 1.10.0
  description: Paid per-query factual datasets for AI agents.
  x-guidance: 'Free, no payment: GET /v1/datasets for the catalogue and GET /v1/{dataset}/sample for 5 current records. Paid: GET /v1/{dataset} with the query filters listed per operation, one x402 payment per call (USDC on Base), up to 100 records. Free feedback: POST /v1/feedback (why you did not buy, or which data you want). MCP server: https://agentdatafeed.com/mcp. Datasets: amsterdam-events (Amsterdam events, $0.005); security-advisories (Security advisories, $0.003); vulnerability-watch (Vulnerability watch, $0.003); eu-tenders (EU public tenders, $0.01); uk-tenders (UK public tenders, $0.005); eu-funding (EU funding calls and grants, $0.005); cert-advisories (European CERT security advisories, $0.003); eu-medicines (EU medicines: authorisations, shortages, safety communications and referrals (EMA), $0.005); sanctions-entities (Sanctioned entities, vessels and aircraft (EU and OFAC lists), $0.005); product-recalls (Product recalls and safety alerts (US FDA, US CPSC, US NHTSA, Health Canada, Transport Canada, CFIA, UK FSA, UK OPSS), $0.005); eu-legislation (EU legislation: new and amended acts in the Official Journal (regulations, directives, decisions), $0.005); drug-shortages (Medicine shortages (US FDA, EMA), $0.005); public-holidays (Public and bank holidays (official government lists, current and next year), $0.002).'
  contact:
    name: agentdatafeed
    email: ops@agentdatafeed.com
    url: https://agentdatafeed.com
servers:
- url: https://agentdatafeed.com
tags:
- name: Product Recalls
paths:
  /v1/product-recalls:
    get:
      operationId: query_product_recalls
      summary: Product recalls and safety alerts (US FDA, US CPSC, US NHTSA, Health Canada…
      description: 'Product recalls and safety alerts from eight official regulators in one feed, last 12 months, refreshed daily: US FDA enforcement reports for food, drugs and medical devices (openFDA), US Consumer Product Safety Commission (CPSC) consumer product recalls, US National Highway Traffic Safety Administration (NHTSA) vehicle, equipment, tyre and child seat recalls, Health Canada recalls and safety alerts (consumer products, vehicles from Transport Canada, food from the Canadian Food Inspection Agency, drugs, health products and medical devices), UK Food Standards Agency allergy alerts and food recall notices, and UK Office for Product Safety and Standards product safety alerts, reports and recalls. Filter by text, country, regulator, source, category, recall class or risk level, firm, allergen, status and date. Fields: recall ID, country, regulator, category, published category, title, product, hazard, allergens, classification, status, firm, published and updated dates, official link, FDA, CPSC or NHTSA recall number, event ID, lot codes and distribution, units affected, CPSC remedy, NHTSA component and do-not-drive or park-outside advice, OPSS measures, verification, paid placement.'
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Text in title, product, hazard or firm (case-insensitive)
      - name: country
        in: query
        required: false
        schema:
          type: string
        description: US, CA or GB
      - name: authority
        in: query
        required: false
        schema:
          type: string
        description: Regulator name (substring, case-insensitive), for example FDA, CPSC, NHTSA, Health Canada, Transport Canada, CFIA, FSA or OPSS
      - name: source
        in: query
        required: false
        schema:
          type: string
        description: 'Source ID: openfda-enforcement, cpsc-recalls, nhtsa-recalls, health-canada-recalls, uk-fsa-food-alerts or uk-opss-product-safety'
      - name: category
        in: query
        required: false
        schema:
          type: string
        description: food, drug, medical-device, vehicle, consumer-product, health-product, cosmetic or other
      - name: classification
        in: query
        required: false
        schema:
          type: string
        description: Recall class or risk level as whole words (case-insensitive), for example Class I (not Class II), Type II, serious, Allergy alert
      - name: firm
        in: query
        required: false
        schema:
          type: string
        description: Recalling firm, reporting business or vehicle manufacturer (substring, case-insensitive), for example Toyota or 3M
      - name: allergen
        in: query
        required: false
        schema:
          type: string
        description: Allergen named in a UK FSA allergy alert (substring, case-insensitive), for example milk or peanut
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: Status as published (case-insensitive), for example Ongoing, Completed, Terminated
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: ISO date; recalls published or updated on or after this date
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1 to 100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Default 0
      responses:
        '200':
          description: Matching records
        '402':
          description: x402 payment required; see accepts[]
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      tags:
      - Product Recalls
  /v1/product-recalls/sample:
    get:
      operationId: sample_product_recalls
      summary: Product recalls and safety alerts (US FDA, US CPSC, US NHTSA, Health Canada…
      security: []
      responses:
        '200':
          description: Sample
      tags:
      - Product Recalls