{
  "openapi": "3.0.1",
  "info": {
    "title": "EU Organic Certified Suppliers & Importers Scraper - TRACES",
    "description": "EU organic certified suppliers, importers, exporters and processors from the European Commission TRACES directory: certificate status, company address, activities, product categories, expiry, control body and PDF link. Companies only. $1.00 per 1,000, no start fee.",
    "version": "1.0",
    "x-build-id": "ULrD0GpOcQbFHmOYs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rel8ble~eu-organic-operators-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rel8ble-eu-organic-operators-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/rel8ble~eu-organic-operators-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rel8ble-eu-organic-operators-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/rel8ble~eu-organic-operators-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rel8ble-eu-organic-operators-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": {
          "productName": {
            "title": "Product",
            "type": "string",
            "description": "Product the operator is certified for, e.g. \"coffee\", \"cocoa\", \"olive oil\", \"tea\", \"rice\", \"honey\". Matches the certified product list, so it finds suppliers by what they sell."
          },
          "searchTerms": {
            "title": "Search terms (operator name / free text)",
            "type": "array",
            "description": "Words to find in the operator name or certificate text, e.g. \"Nestle\", \"kaffee\", \"GmbH\", or a certificate reference. Each term is a separate search; results are merged and de-duplicated.",
            "items": {
              "type": "string"
            }
          },
          "activities": {
            "title": "Activities",
            "type": "array",
            "description": "Keep operators certified for any of these activities. Import / export find traders; production finds growers; preparation finds processors and packers.",
            "items": {
              "type": "string",
              "enum": [
                "production",
                "preparation",
                "import",
                "export",
                "distribution",
                "placing_on_the_market",
                "storing"
              ],
              "enumTitles": [
                "Production",
                "Preparation",
                "Import",
                "Export",
                "Distribution",
                "Distribution/Placing on the market",
                "Storing"
              ]
            }
          },
          "productCategories": {
            "title": "Product categories",
            "type": "array",
            "description": "Regulation (EU) 2018/848 categories. Any match counts.",
            "items": {
              "type": "string",
              "enum": [
                "a",
                "b",
                "c",
                "d",
                "e",
                "f",
                "g"
              ],
              "enumTitles": [
                "(a) Unprocessed plants and plant products, including seeds and other plant reproductive material",
                "(b) Livestock and unprocessed livestock products",
                "(c) Algae and unprocessed aquaculture products",
                "(d) Processed agricultural products, including aquaculture products, for use as food",
                "(e) Feed",
                "(f) Wine",
                "(g) Other products listed in Annex I to Regulation (EU) 2018/848 or not covered by the previous categories"
              ]
            }
          },
          "operatorCountries": {
            "title": "Operator countries",
            "type": "array",
            "description": "Country where the operator is based (EU 27, Norway, Iceland, Northern Ireland). Each country is a separate search. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "AT",
                "BE",
                "BG",
                "HR",
                "CY",
                "CZ",
                "DK",
                "EE",
                "FI",
                "FR",
                "DE",
                "GR",
                "HU",
                "IS",
                "IE",
                "IT",
                "LV",
                "LT",
                "LU",
                "MT",
                "NL",
                "NO",
                "PL",
                "PT",
                "RO",
                "SK",
                "SI",
                "ES",
                "SE",
                "XI"
              ],
              "enumTitles": [
                "Austria (AT)",
                "Belgium (BE)",
                "Bulgaria (BG)",
                "Croatia (HR)",
                "Cyprus (CY)",
                "Czechia (CZ)",
                "Denmark (DK)",
                "Estonia (EE)",
                "Finland (FI)",
                "France (FR)",
                "Germany (DE)",
                "Greece (GR)",
                "Hungary (HU)",
                "Iceland (IS)",
                "Ireland (IE)",
                "Italy (IT)",
                "Latvia (LV)",
                "Lithuania (LT)",
                "Luxembourg (LU)",
                "Malta (MT)",
                "Netherlands (NL)",
                "Norway (NO)",
                "Poland (PL)",
                "Portugal (PT)",
                "Romania (RO)",
                "Slovakia (SK)",
                "Slovenia (SI)",
                "Spain (ES)",
                "Sweden (SE)",
                "United Kingdom (Northern Ireland) (XI)"
              ]
            }
          },
          "postcode": {
            "title": "Postal code",
            "type": "string",
            "description": "Operator postal code, e.g. \"20457\". Best combined with one country."
          },
          "operatorIdentifier": {
            "title": "Operator number (exact)",
            "type": "string",
            "description": "Exact operator identifier from a certificate, e.g. \"276-0008227\", to verify one supplier and see all its certificates."
          },
          "statuses": {
            "title": "Certificate statuses",
            "type": "array",
            "description": "Default: valid (issued) certificates only. Add Expired / Withdrawn / Suspended for history or compliance checks.",
            "items": {
              "type": "string",
              "enum": [
                "ISSUED",
                "SUSPENDED",
                "WITHDRAWN",
                "EXPIRED"
              ],
              "enumTitles": [
                "Issued (valid)",
                "Suspended",
                "Withdrawn",
                "Expired"
              ]
            },
            "default": [
              "ISSUED"
            ]
          },
          "expiresAfter": {
            "title": "Expires on or after",
            "type": "string",
            "description": "Keep certificates valid until at least this date (YYYY-MM-DD). Applied while paging."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "newest_issued",
              "oldest_issued",
              "expires_soonest",
              "expires_latest",
              "operator_name",
              "reference"
            ],
            "type": "string",
            "description": "Order of results within each search. Default: newest issued first.",
            "default": "newest_issued"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Rows to save (and pay for). 0 = all that match (one search serves at most 10,000 certificates; split by country for more).",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}