{
  "openapi": "3.0.1",
  "info": {
    "title": "TED Tenders Scraper: EU Tender Monitoring and Alerts",
    "description": "EU tender monitoring for bid teams and public-sector sales: search TED by keyword, CPV code, country and date; a named watch (one run at a time) skips notices it returned before and alerts Slack, Discord or a webhook into your CRM. $1.00 per 1,000 notices on Free, $0.70 on Business.",
    "version": "0.1",
    "x-build-id": "HuXvJ70j3D24KlhkX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fetchwright~ted-tenders-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fetchwright-ted-tenders-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/fetchwright~ted-tenders-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fetchwright-ted-tenders-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/fetchwright~ted-tenders-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fetchwright-ted-tenders-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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words or phrases to find anywhere in the notice text, one per line, for example **software** or **cloud services**. Several lines match notices that contain any of them. Write them in the notice's language to match more notices (Software, logiciel). Leave empty to search by the filters below only; with no filter at all, the run returns the newest notices up to Maximum notices.",
            "items": {
              "type": "string"
            }
          },
          "maxNotices": {
            "title": "Maximum notices",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "A hard cap: the run never saves more than this many notices, for example **100**. You pay per notice saved, so this caps the cost of a run. Newest notices come first. Default: 100.",
            "default": 100
          },
          "cpvCodes": {
            "title": "CPV codes (sector)",
            "type": "array",
            "description": "Optional. Common Procurement Vocabulary codes, one per line, for example **72000000** (IT services) or **45000000** (construction work). A code also matches every code below it, and matches a notice's additional CPV codes as well as its main one. The check digit is optional (72000000-5 works). A short code such as **72** is read as 72000000.",
            "items": {
              "type": "string"
            }
          },
          "buyerCountries": {
            "title": "Buyer countries",
            "type": "array",
            "description": "Optional. The countries of the buying public bodies, one per line, as a two- or three-letter code or an English name, for example **DE**, **FRA** or **Poland**. Leave empty for every country.",
            "items": {
              "type": "string"
            }
          },
          "noticeTypes": {
            "title": "Notice types",
            "type": "array",
            "description": "Optional. Keep only these kinds of notice, for example **Calls for tenders** for tenders you can bid on, or **Contract award notices** to see who won and for how much. Calls for tenders also includes what TED groups with contract notices: design contests, prior information notices used as a call for competition, qualification systems and subcontracting notices; each row's noticeTypeLabel says which. Leave empty for every kind.",
            "items": {
              "type": "string",
              "enum": [
                "competition",
                "result",
                "planning",
                "modification",
                "veat",
                "correction"
              ],
              "enumTitles": [
                "Calls for tenders (contract notices and similar)",
                "Contract award notices (winners and values)",
                "Prior information notices (planned purchases)",
                "Contract modifications",
                "Voluntary ex-ante transparency notices",
                "Corrigenda (notices before 2023)"
              ]
            }
          },
          "publishedFrom": {
            "title": "Published on or after",
            "type": "string",
            "description": "Optional start date of publication, for example **2026-11-01**. Leave empty for no lower bound."
          },
          "publishedTo": {
            "title": "Published on or before",
            "type": "string",
            "description": "Optional end date of publication, for example **2026-11-30**. Leave empty for no upper bound."
          },
          "publishedInLastDays": {
            "title": "Published in the last days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional, for scheduled runs: only notices published on or after the date this many days before the run, for example **7**. When a start date is also set, the later of the two applies."
          },
          "onlyOpenDeadlines": {
            "title": "Only notices with an open deadline",
            "type": "boolean",
            "description": "Keep only notices whose tender deadline is still ahead (deadlineStatus open), for example to list **tenders you can still bid on**. Notices left out are not saved and not charged. TED's count in the run summary is before this filter. Default: off.",
            "default": false
          },
          "excludeChangeNotices": {
            "title": "Leave out change notices",
            "type": "boolean",
            "description": "Leave out notices that change an earlier notice (a moved deadline, a new value, a correction): TED publishes each change as a new notice, and on some days these are a third or more of all calls for tenders. Notices left out are not saved, not charged and counted in the run summary. With this on, you do not learn that a tender's deadline moved. Default: off (change notices are saved and say what changed).",
            "default": false
          },
          "closingWithinDays": {
            "title": "Deadline within the next days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional. Keep only notices whose tender deadline falls within this many days from the run, for example **14** for tenders closing in the next two weeks. Applied in TED's search and then exactly before saving: a notice is kept only when its deadline is certainly inside the window (a deadline given as a date without a time counts as any moment of that day), and notices left out are not saved and not charged."
          },
          "minDaysLeft": {
            "title": "At least this many days left",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional. Keep only notices whose tender deadline is at least this many days after the run, for example **10** to drop tenders too close to prepare a bid. Applied in TED's search and then exactly before saving, as for the field above; notices left out are not saved and not charged."
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Optional. Leave out notices whose text contains any of these words or phrases, one per line, for example **maintenance** or **cleaning**. Applied in TED's own search, so excluded notices are never fetched or charged.",
            "items": {
              "type": "string"
            }
          },
          "placeOfPerformance": {
            "title": "Place of performance (NUTS or country)",
            "type": "array",
            "description": "Optional. Where the work is done, one per line: a country by name or code, such as **Italy**, **DE** or **POL**, or a NUTS region code such as **DEA** (North Rhine-Westphalia, with every region below it) or **FR101**. A country name or code is always read as the country. Any other value shaped like a NUTS code (two letters, then one to three letters or digits) is passed to TED as written, and a code TED does not know stops the run with TED's message; anything else stops the run before any request. No notice is charged either way. Applied in TED's search.",
            "items": {
              "type": "string"
            }
          },
          "buyerName": {
            "title": "Buyer name contains",
            "type": "string",
            "description": "Optional. A word or phrase in the buying authority's name, for example **Stadt München** or **Ministry of Defence**; put several on separate lines to match any of them. Matched by TED's search in the language the buyer wrote its name in."
          },
          "procedureTypes": {
            "title": "Procedure types",
            "type": "array",
            "description": "Optional. Keep only these procurement procedures, one per line, for example **open** for tenders anyone can answer. Accepted: open, restricted, negotiated (with or without prior publication: neg-w-call, neg-wo-call), competitive dialogue (comp-dial), innovation partnership (innovation), comp-tend, oth-single, oth-mult. Applied in TED's search. Leave empty for every procedure.",
            "items": {
              "type": "string"
            }
          },
          "contractNatures": {
            "title": "Contract nature",
            "type": "array",
            "description": "Optional. Keep only these kinds of contract, one per line: **works**, **services** or **supplies** (goods), for example services for consulting and IT contracts. Applied in TED's search to the main nature of the procedure. Leave empty for all.",
            "items": {
              "type": "string"
            }
          },
          "minValue": {
            "title": "Minimum value",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Keep only notices whose total value is at least this amount, for example **1000000**. Compared with TED's total-value field (totalValue in each row: the estimated value on calls for tenders, the total awarded on award notices) in the notice's own currency, with no conversion: 1000000 matches 1,000,000 EUR and also 1,000,000 CZK. Notices without a stated value are left out. Applied in TED's search; notices left out are not charged."
          },
          "maxValue": {
            "title": "Maximum value",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Keep only notices whose total value is at most this amount, for example **5000000**, compared the same way as the minimum: TED's total-value, in the notice's own currency, without conversion. Notices without a stated value are left out. Applied in TED's search; notices left out are not charged."
          },
          "onlyNew": {
            "title": "Only notices not returned in earlier runs",
            "type": "boolean",
            "description": "For scheduled monitoring, for example a daily run on your sector. The first run returns the newest matching notices up to your maximum, or only remembers them (see On a watch's first run); each later run returns only notices published since then and not returned before, oldest first. Older matches are not back-filled. Run a watch one at a time: a second run that finds it in use stops, but two started in the same seconds can both return and charge the same notice. Default: off.",
            "default": false
          },
          "firstRunBehaviour": {
            "title": "On a watch's first run",
            "enum": [
              "return_current",
              "remember_only"
            ],
            "type": "string",
            "description": "Applies with **Only notices not returned in earlier runs**. **Return the newest notices** returns the newest matching notices up to your maximum on the first run. **Only remember them** returns and charges nothing on the first run: it remembers the newest matching notices, so the next run returns only notices published after them. Later runs are the same either way. Default: return the newest notices.",
            "default": "return_current"
          },
          "watchName": {
            "title": "Watch name",
            "type": "string",
            "description": "Optional. Give a watch its own memory, for example **it-tenders-germany**. A named watch keeps its memory when you change its filters. For a schedule, turn on Apify's setting not to start a new run while the previous one is running. Without a name, each saved task keeps one memory per set of filters, and API runs share one per set of filters."
          },
          "notifyWebhookUrl": {
            "title": "Send an alert to Slack, Discord or a webhook",
            "type": "string",
            "description": "Optional. Paste a Slack or Discord incoming-webhook address, or any https:// address that accepts JSON, for example **https://hooks.slack.com/services/...**. When the run saves notices, a short message is posted there: the count, the first three titles with buyer and deadline, and a link to all rows. No extra charge."
          },
          "notifyWhenNothingFound": {
            "title": "Alert even when nothing was saved",
            "type": "boolean",
            "description": "Also post the alert when the run saved no notices, for example to confirm that a scheduled check ran. Off by default, so a quiet run sends nothing.",
            "default": false
          },
          "expertQuery": {
            "title": "TED expert query",
            "type": "string",
            "description": "Optional, for TED power users: a query in TED's own expert-search syntax, for example **classification-cpv IN (72000000) AND buyer-country IN (DEU) AND total-value>=1000000**. It replaces Keywords, CPV codes, Buyer countries, Notice types, the dates and the filters under More filters. A query TED accepts is sent as typed. What TED would reject is repaired where the meaning is certain, and the run log and run summary show what you typed and what was sent: two-letter countries (DE becomes DEU), CPV check digits (72000000-5 becomes 72000000), plain words (software cloud is searched as words in the notice text), and TED's old syntax CY=[..], PC=[..], PD=[..] and FT=[..]. Other old-syntax fields stop the run before any notice is charged, with the rest of your query rewritten. Newest first unless it has its own SORT BY."
          },
          "language": {
            "title": "Language",
            "enum": [
              "ENG",
              "BUL",
              "CES",
              "DAN",
              "DEU",
              "ELL",
              "EST",
              "FIN",
              "FRA",
              "GLE",
              "HRV",
              "HUN",
              "ITA",
              "LAV",
              "LIT",
              "MLT",
              "NLD",
              "POL",
              "POR",
              "RON",
              "SLK",
              "SLV",
              "SPA",
              "SWE"
            ],
            "type": "string",
            "description": "Language of title, buyer name, description and links, for example **ENG** (English) or **DEU** (German). When a notice is not available in it, English is used, then the notice's own language. Default: ENG.",
            "default": "ENG"
          },
          "includeContactPersons": {
            "title": "Include contact persons",
            "type": "boolean",
            "description": "Off by default: the buyer's contact point, e-mail and phone and the winners' e-mail are not requested from TED. On: they are added as published, for example **a named contact with a direct e-mail**. They can identify people: turn it on only if you have a lawful basis to process them. No extra charge.",
            "default": false
          },
          "includeNaturalPersonWinners": {
            "title": "Include winners marked as natural persons",
            "type": "boolean",
            "description": "Winner names are returned as TED publishes them. When TED marks a winner of a notice as a natural person (a sole trader, for example), every winner name of that notice is withheld unless this is on. A winner TED does not mark is returned as published. No extra charge. Default: off.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Usually not needed: TED's search is open and the Actor paces its requests at about one per second. Set a proxy only if you have a specific reason, for example **a network rule of your own**. A run uses one address throughout."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}