{
  "openapi": "3.0.1",
  "info": {
    "title": "France Pesticide Products (E-Phy) - Authorised Uses & Doses",
    "description": "Search the official French pesticide register (Anses E-Phy): authorised uses by crop and pest, doses, pre-harvest intervals, buffer zones, withdrawal dates.",
    "version": "1.0",
    "x-build-id": "dhN7wZOVK8XKBUJI7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/eurodata-lab~france-pesticide-products-ephy/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-eurodata-lab-france-pesticide-products-ephy",
        "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/eurodata-lab~france-pesticide-products-ephy/runs": {
      "post": {
        "operationId": "runs-sync-eurodata-lab-france-pesticide-products-ephy",
        "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/eurodata-lab~france-pesticide-products-ephy/run-sync": {
      "post": {
        "operationId": "run-sync-eurodata-lab-france-pesticide-products-ephy",
        "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": {
          "crop": {
            "title": "Crop",
            "type": "string",
            "description": "Keep only uses on crops whose name contains this text (French crop names as used by E-Phy, accents and case ignored, at least 3 characters), for example Vigne (vine), Blé (wheat), Pomme de terre (potato), Fruits à pépins (apple and pear) or Tomate. Rapeseed is listed under Crucifères oléagineuses. Leave empty for all crops.",
            "default": ""
          },
          "target": {
            "title": "Pest, disease or treatment",
            "type": "string",
            "description": "Keep only uses whose target pest or disease, or treatment type, contains this text (French E-Phy wording, accents and case ignored, at least 3 characters), for example Mildiou (downy mildew), Pucerons (aphids), Oïdium (powdery mildew), Désherbage (weed control), Trt Sem. (seed treatment). Leave empty for all.",
            "default": ""
          },
          "productName": {
            "title": "Product name",
            "type": "string",
            "description": "Keep only products whose trade name or secondary trade name contains this text (accents and case ignored, at least 3 characters), for example ROUNDUP or BOUILLIE BORDELAISE. Leave empty for all products.",
            "default": ""
          },
          "activeSubstance": {
            "title": "Active substance",
            "type": "string",
            "description": "Keep only products containing an active substance whose French or English name contains this text (at least 3 characters), for example glyphosate, cuivre / copper, deltaméthrine / deltamethrin. Leave empty for all substances.",
            "default": ""
          },
          "productFunction": {
            "title": "Product function",
            "enum": [
              "any",
              "herbicide",
              "fungicide",
              "insecticide",
              "acaricide",
              "molluscicide",
              "nematicide",
              "bactericide",
              "growthRegulator",
              "adjuvant",
              "pheromone",
              "repellent",
              "rodenticide",
              "defenceStimulator"
            ],
            "type": "string",
            "description": "Keep only products with this function (a product can have several, for example fungicide and insecticide).",
            "default": "any"
          },
          "holder": {
            "title": "Authorisation holder",
            "type": "string",
            "description": "Keep only products whose authorisation holder (the company that holds the marketing authorisation) contains this text, for example BAYER, SYNGENTA or DE SANGOSSE (at least 3 characters). Holders that are private individuals are never named and never match. Leave empty for all holders.",
            "default": ""
          },
          "authorisationNumbers": {
            "title": "Authorisation (AMM) numbers",
            "maxItems": 20000,
            "type": "array",
            "description": "French marketing authorisation numbers (AMM, 7 digits), for example 2180347. Use it to check a list of products you sell or recommend. Numbers that are not found are listed in the run log and are not billed. Set \"Product status\" to \"Any\" to also see withdrawn products.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "productStatus": {
            "title": "Product status",
            "enum": [
              "authorised",
              "withdrawn",
              "any"
            ],
            "type": "string",
            "description": "<b>Authorised</b>: products currently on the market. <b>Withdrawn</b>: products whose authorisation was withdrawn (with their end-of-sale and end-of-use dates). When an end-of-use date filter is set, \"Authorised\" is read as \"Any\".",
            "default": "authorised"
          },
          "usageStatus": {
            "title": "Use status",
            "enum": [
              "authorised",
              "withdrawn",
              "any"
            ],
            "type": "string",
            "description": "Status of each crop and pest use. <b>Authorised</b> includes provisional authorisations. A product can still be authorised while some of its uses have been withdrawn. When an end-of-use date filter is set, \"Authorised\" is read as \"Withdrawn\" (only withdrawn uses have an end-of-use date).",
            "default": "authorised"
          },
          "endOfUseFrom": {
            "title": "End of use on or after",
            "type": "string",
            "description": "Keep only withdrawn uses whose end-of-use date (last day the product may be used for this use) is on or after this date. Enter a date (2026-12-31), \"today\", or a period relative to the run date such as \"+30 days\" or \"1 year ago\". \"today\" lists the uses still in their grace period. Leave empty for no lower bound.",
            "default": ""
          },
          "endOfUseTo": {
            "title": "End of use on or before",
            "type": "string",
            "description": "Keep only withdrawn uses whose end-of-use date is on or before this date, for example \"in 6 months\". With \"End of use on or after\" = today, it lists the uses that must stop within that period. Leave empty for no upper bound.",
            "default": ""
          },
          "decisionDateFrom": {
            "title": "Decision on or after",
            "type": "string",
            "description": "Keep only uses whose latest Anses decision is on or after this date (2026-01-01, or a relative period such as \"90 days ago\"). Handy to follow new authorisations and changes. Leave empty for any date.",
            "default": ""
          },
          "gardenUseOnly": {
            "title": "Only products allowed in home gardens",
            "type": "boolean",
            "description": "Keep only products carrying the mention \"Emploi autorisé dans les jardins\" (allowed for amateur use in home gardens).",
            "default": false
          },
          "biocontrolOnly": {
            "title": "Only biocontrol products",
            "type": "boolean",
            "description": "Keep only products on the official French biocontrol list (Liste biocontrôle).",
            "default": false
          },
          "organicFarmingOnly": {
            "title": "Only products usable in organic farming",
            "type": "boolean",
            "description": "Keep only products marked as usable in organic farming (professional or amateur organic production).",
            "default": false
          },
          "includeProductConditions": {
            "title": "Include conditions of use",
            "type": "boolean",
            "description": "Add the product's full conditions of use to each result (re-entry interval, operator protection, environmental and labelling conditions). Off by default because the texts are long.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "sourceOrder",
              "productName",
              "endOfUseDate",
              "decisionDateDesc"
            ],
            "type": "string",
            "description": "Order of the results. <b>End-of-use date</b> puts the uses that must stop first at the top. <b>Latest decision</b> puts the newest Anses decisions first.",
            "default": "sourceOrder"
          },
          "maxResults": {
            "title": "Maximum number of results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Safety cap on the number of product uses returned. The run stops once it is reached, so you never pay for more than this.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}