{
  "openapi": "3.0.1",
  "info": {
    "title": "EU & UK Public Tenders Scraper: TED + UK Find a Tender",
    "description": "EU and UK tenders and public procurement scraper: open government contracts from TED (all of Europe, incl. German Ausschreibungen) and UK Find a Tender, with deadline, days left, value, duration, award criteria, CPV in English and links.",
    "version": "1.0",
    "x-build-id": "tKsybQ79hZS7ddRVI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/michael80~eu-public-tenders-ted/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-michael80-eu-public-tenders-ted",
        "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/michael80~eu-public-tenders-ted/runs": {
      "post": {
        "operationId": "runs-sync-michael80-eu-public-tenders-ted",
        "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/michael80~eu-public-tenders-ted/run-sync": {
      "post": {
        "operationId": "run-sync-michael80-eu-public-tenders-ted",
        "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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Optional full-text search, one keyword or phrase per line (any language, e.g. 'software', 'Photovoltaik', 'medical devices'). Each line is a separate search; results are merged without duplicates. Leave empty to get all tenders that match the other filters.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Buyer countries",
            "type": "array",
            "description": "Optional country codes of the contracting authority, two or three letters (e.g. 'DE', 'FR', 'AT', 'UK', 'US'). Covers EU, EEA and other countries publishing on TED, the United Kingdom via Find a Tender and, if you add 'US', US federal tenders via SAM.gov (needs a free SAM.gov key). Leave empty for all of Europe incl. UK.",
            "items": {
              "type": "string"
            }
          },
          "includeUk": {
            "title": "Include United Kingdom (Find a Tender)",
            "type": "boolean",
            "description": "Also searches the UK government's official Find a Tender service (UK tenders are no longer published on TED since Brexit). Used when 'Buyer countries' is empty or contains UK/GB.",
            "default": true
          },
          "samGovApiKey": {
            "title": "SAM.gov API key (only for US tenders)",
            "type": "string",
            "description": "Free key from sam.gov (sign in > Account Details > Public API Key). Only needed when 'Buyer countries' contains US. Personal keys allow about 10 searches per day: one search per keyword. Stored encrypted."
          },
          "cpvCodes": {
            "title": "CPV codes (categories)",
            "type": "array",
            "description": "Optional CPV codes or prefixes, e.g. '72' (IT services), '45' (construction work), '33100000' (medical equipment). Sub-categories are included automatically.",
            "items": {
              "type": "string"
            }
          },
          "naicsCodes": {
            "title": "NAICS codes (US only)",
            "type": "array",
            "description": "Optional for US tenders: NAICS industry codes or prefixes, e.g. 541511 (custom software) or 5415. CPV codes do not exist in the US.",
            "items": {
              "type": "string"
            }
          },
          "publishedWithinDays": {
            "title": "Published within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only notices published in the last N days.",
            "default": 7
          },
          "onlyOpen": {
            "title": "Only open tenders",
            "type": "boolean",
            "description": "Skips calls whose submission deadline has already passed. Notices without a deadline (e.g. prior information) are kept.",
            "default": true
          },
          "minEstimatedValue": {
            "title": "Minimum estimated value",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Only tenders with an estimated contract value of at least this amount (in the notice currency, usually EUR). Tenders without a published value are skipped when this is set."
          },
          "includePriorInformation": {
            "title": "Include prior information notices",
            "type": "boolean",
            "description": "Also returns prior information notices: buyers announce upcoming purchases months before the actual call. Gives you a head start.",
            "default": false
          },
          "onlyNew": {
            "title": "Only new tenders since last run",
            "type": "boolean",
            "description": "Remembers tenders delivered by earlier runs with the same filters and returns only new ones (known ones are skipped and free). Ideal for a daily schedule.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional name of the storage that remembers delivered tenders (only with 'Only new tenders'). Use different names for different monitors; default 'eu-tenders-monitor'."
          },
          "linkLanguage": {
            "title": "Language of TED links",
            "enum": [
              "en",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "pl",
              "pt",
              "sv",
              "da",
              "fi",
              "cs"
            ],
            "type": "string",
            "description": "Language of the TED web page and PDF links in the results.",
            "default": "en"
          },
          "maxResults": {
            "title": "Maximum tenders",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Stops after this many tenders (all keywords together).",
            "default": 500
          },
          "selfTest": {
            "title": "Self-test",
            "type": "boolean",
            "description": "Runs one small fixed search (Germany, last 7 days, 5 tenders) to check that everything works. Ignores the other fields.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}