{
  "openapi": "3.0.1",
  "info": {
    "title": "Tender Data API – EU European Tenders, TED Europa, CPV Codes",
    "description": "A procurement data API for EU's official TED journal: search government tenders by country, CPV code, date or open submission deadline. Returns clean, deduplicated JSON in 24 EU languages: buyer, value, deadlines, CPV codes and notice link. Includes tender notices, contract awards and corrigenda.",
    "version": "0.1",
    "x-build-id": "VZUgl7rhZ5xlR0W2r"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fetchsmith~eu-ted-tenders-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fetchsmith-eu-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/fetchsmith~eu-ted-tenders-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fetchsmith-eu-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/fetchsmith~eu-ted-tenders-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fetchsmith-eu-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": {
          "countries": {
            "title": "Buyer countries",
            "type": "array",
            "description": "ISO 3166-1 alpha-3 codes of the buyer's country (e.g. DEU, FRA, ITA, ESP, NLD). Leave empty for all EU/EEA countries.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "cpvCodes": {
            "title": "CPV codes",
            "type": "array",
            "description": "Common Procurement Vocabulary codes to filter by, 8 digits (e.g. 72000000 for IT services, 45000000 for construction). Leave empty for all. IMPORTANT -- TED matches the whole CPV SUBTREE under each code you give, at every level, not the code itself: 72000000 also returns notices tagged only 72313000 or 72220000, and even a narrow code like 72267000 also returns its children 72267100/72267200. First measured 2026-09-21 on a 10-notice sample (6 carried the literal 72267000); re-measured live 2026-11-02 on a 100-notice sample from the last 365 days: 67 of 100 notices matched by 72267000 carried that literal code (35 carried the child 72267100, 3 carried 72267200), and only 36 of 100 matched by 72000000 carried 72000000 itself (e.g. notice 723769-2025 is tagged 72200000 and 79400000 only). So expect a third or more of your rows not to carry the code you asked for, and more of them the broader the code. There is no exact-code mode -- post-filter the cpvCodes output field yourself if you need one.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "noticeTypes": {
            "title": "Notice types",
            "type": "array",
            "description": "TED notice-type codes to filter by. This is TED's COMPLETE filterable notice-type vocabulary (all 22 codes; first established cycle 836, re-verified live cycle 2609 by exhausting TED's expert-search index: excluding all 22 leaves 0 notices over TED's whole history). Leave empty for all types. The common ones are cn-standard (contract notice, ~2.96M notices), can-standard (contract award notice, ~2.86M) and pin-only/pin-buyer/pin-rtl (prior information). Note there is no \"pin-standard\" code — TED rejects it — the prior-information notices are split across the six pin-* codes below. Two of the 22 are HISTORICAL-ONLY: \"corr\" and \"subco\" are still accepted as filter values and still match older notices (81,317 and 5 since 2023-01-01) but had 0 notices published in the last 365 days (measured live cycle 2852, 2026-11-07, re-proved live and unchanged cycle 3188, 2026-11-14 and again cycle 3524, 2026-11-21) — eForms retired them. Selecting only those needs \"publicationDateFrom\" set to an older date, because publishedWithinDays maxes out at 365 and so cannot reach them.",
            "items": {
              "type": "string",
              "enum": [
                "pin-only",
                "pin-buyer",
                "pin-rtl",
                "pin-tran",
                "pin-cfc-standard",
                "pin-cfc-social",
                "cn-standard",
                "cn-social",
                "cn-desg",
                "can-standard",
                "can-social",
                "can-desg",
                "can-tran",
                "can-modif",
                "veat",
                "corr",
                "qu-sy",
                "subco",
                "compl",
                "pmc",
                "brin-ecs",
                "brin-eeig"
              ],
              "enumTitles": [
                "Prior information notice – information only (no call for competition)",
                "Prior information notice – buyer profile / shortened time limits",
                "Prior information notice – used to reduce time limits",
                "Prior information notice – public passenger transport services",
                "Prior information notice used as a call for competition – standard regime",
                "Prior information notice used as a call for competition – social and other specific services",
                "Contract notice – standard regime",
                "Contract notice – social and other specific services",
                "Design contest notice",
                "Contract award notice – standard regime",
                "Contract award notice – social and other specific services",
                "Design contest result notice",
                "Contract award notice – public passenger transport services",
                "Contract modification notice",
                "Voluntary ex-ante transparency notice (direct award)",
                "Corrigendum (correction to an earlier notice)",
                "Qualification system notice (utilities)",
                "Subcontract notice (defence and security)",
                "Contract completion notice",
                "Preliminary market consultation notice",
                "Business registration information – European Company / European Cooperative Society",
                "Business registration information – European Economic Interest Grouping"
              ]
            },
            "default": []
          },
          "procedureType": {
            "title": "Procedure types",
            "type": "array",
            "description": "TED procedure-type codes to filter by. This is TED's COMPLETE filterable procedure-type vocabulary (all 18 codes; first established cycle 836, updated cycle 1533, re-verified live cycle 2609: excluding all 18 codes from a search still returns 0 TED notices: the 8 modern eForms codes, 9 legacy pre-2023 single-character codes TED still accepts, plus comp-tend -- a real eForms code for public-passenger-transport competitive tendering under Regulation 1370/2007 that cycle 836's probe missed). Leave empty for all. Server-side filter, same OR-group as noticeTypes. Two upstream quirks: there is no \"exp-int-rest\" code (TED rejects it), and the value \"7\" DOES appear in the output 'procedureType' field on some older notices but TED's expert search refuses it as a filter value, so it cannot be selected here. Most notices older than ~2014 carry no procedure type at all. NINE of the 18 are HISTORICAL-ONLY: the legacy single-character codes 4, 9, V, E, Z, 6, A, F and 8 are still accepted and still match older notices (25,624 / 26,290 / 14,465 / 3,792 / 1,007 / 45 / 351 / 189 / 400 respectively since 2023-01-01) but every one had 0 notices published in the last 365 days (measured live cycle 2852, 2026-11-07, re-proved live and unchanged cycle 3188, 2026-11-14 and again cycle 3524, 2026-11-21) — the eForms cutover dried them up. Selecting only legacy codes needs \"publicationDateFrom\" set to an older date; publishedWithinDays maxes out at 365 and cannot reach them. The Actor warns about this at run start instead of just returning 0 rows. Every option count in this dropdown is an all-time TED total measured live on 2026-11-21 (cycle 3524); the live codes grow daily and the legacy ones drift slowly downward as TED prunes pre-2023 notices from its index, so treat them as of that date.",
            "items": {
              "type": "string",
              "enum": [
                "open",
                "restricted",
                "neg-w-call",
                "neg-wo-call",
                "comp-dial",
                "oth-single",
                "oth-mult",
                "innovation",
                "4",
                "9",
                "V",
                "E",
                "Z",
                "6",
                "A",
                "F",
                "8",
                "comp-tend"
              ],
              "enumTitles": [
                "Open procedure (5,565,282 notices)",
                "Restricted procedure (274,803)",
                "Negotiated with prior call for competition (355,066)",
                "Negotiated without prior call for competition (221,267)",
                "Competitive dialogue (16,922)",
                "Other, single stage (33,420)",
                "Other, multiple stages (9,007)",
                "Innovation partnership (1,326)",
                "Legacy pre-eForms code 4 (166,797) - TED publishes no label for it",
                "Legacy pre-eForms code 9 (152,806) - TED publishes no label for it",
                "Legacy pre-eForms code V (76,674) - TED publishes no label for it",
                "Legacy pre-eForms code E (23,592) - TED publishes no label for it",
                "Legacy pre-eForms code Z (9,458) - TED publishes no label for it",
                "Legacy pre-eForms code 6 (4,076) - TED publishes no label for it",
                "Legacy pre-eForms code A (2,558) - TED publishes no label for it",
                "Legacy pre-eForms code F (1,174) - TED publishes no label for it",
                "Legacy pre-eForms code 8 (854) - TED publishes no label for it",
                "Competitive tendering, public passenger transport (Reg. 1370/2007 art. 5(3)) (3,175)"
              ]
            },
            "default": []
          },
          "publishedWithinDays": {
            "title": "Published within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only return notices published in the last N days. Ignored if publicationDateFrom or publicationDateTo is set.",
            "default": 7
          },
          "publicationDateFrom": {
            "title": "Published from (absolute date)",
            "type": "string",
            "description": "YYYYMMDD or YYYY-MM-DD. Overrides 'Published within (days)' with an absolute historical window. Leave empty for no lower bound (with publicationDateTo set)."
          },
          "publicationDateTo": {
            "title": "Published to (absolute date)",
            "type": "string",
            "description": "YYYYMMDD or YYYY-MM-DD. Overrides 'Published within (days)'. Leave empty for no upper bound (with publicationDateFrom set). WATCH MODE WARNING: combined with watchLabel, a FIXED value here is a permanent dead end once the real date passes it -- publication-date is assigned once when TED publishes a notice and never revised afterward, so no notice can ever be dated on or before an already-passed cutoff again. Leave it unset in a watched query; publicationDateFrom alone is safe to keep. See README FAQ."
          },
          "keywords": {
            "title": "Keywords (full-text)",
            "type": "string",
            "description": "Free-text search using TED's FT~ full-text operator. Example: \"cloud hosting\". First verified cycle 919: this matches against the WHOLE notice text TED indexes, not just title/description/buyer name -- a search for \"software\" matched a notice whose only occurrence of the word was in technical-capacity/selection-criteria text, not one of this Actor's output fields. Re-verified live 2026-11-02: still holds -- notice 681576-2026 (a Greek advertising-campaign-services tender) matched the same \"software\" search though the word appears in none of this Actor's output fields (title, description, buyer name, or any other exposed field). A returned row may not visibly contain your keyword anywhere in its output. Leave empty to match everything in your other filters."
          },
          "expertQuery": {
            "title": "Expert query (advanced, overrides the filters above)",
            "type": "string",
            "description": "Raw TED expert-query string (same syntax as the TED website's expert search), e.g. \"buyer-country=DEU AND classification-cpv=72000000 AND publication-date>=today(-30)\". If set, this replaces countries/cpvCodes/noticeTypes/publishedWithinDays entirely."
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many notices.",
            "default": 100
          },
          "outputLanguage": {
            "title": "Output language",
            "enum": [
              "eng",
              "deu",
              "fra",
              "ita",
              "spa",
              "pol",
              "nld",
              "por",
              "swe",
              "dan",
              "fin",
              "ces",
              "ell",
              "hun",
              "ron",
              "slk",
              "slv",
              "bul",
              "hrv",
              "est",
              "lav",
              "lit",
              "gle",
              "mlt"
            ],
            "type": "string",
            "description": "Preferred language for localized fields (title, description, buyer name, notice link). Falls back to English, then to whichever language TED provided, if this notice has no translation into the chosen language.",
            "default": "eng"
          },
          "minValue": {
            "title": "Min contract value",
            "type": "integer",
            "description": "Only keep notices whose estimated/total contract value (the 'totalValue' output field) is at least this number. Compares the raw numeric value regardless of currency (TED reports EUR, CZK, RON, SEK etc. per notice — check 'totalValueCurrency' before comparing across countries). Roughly half of all TED notices carry no value at all; those are dropped whenever this filter is set. Leave empty for no minimum."
          },
          "maxValue": {
            "title": "Max contract value",
            "type": "integer",
            "description": "Only keep notices whose estimated/total contract value is at most this number. Same currency caveat as 'Min contract value'. Leave empty for no maximum."
          },
          "onlyOpenDeadlines": {
            "title": "Only tenders still open for bids",
            "type": "boolean",
            "description": "Keep only notices whose submission deadline ('deadlineDate') is today or later, i.e. ones you can still bid on. Notices where TED published no deadline at all are dropped while this is on — award/result notices and many prior-information notices carry none, and an absent deadline cannot be shown to be open. Off by default (every matching notice, open or closed). Filtered-out notices are not charged.",
            "default": false
          },
          "minDaysUntilDeadline": {
            "title": "Minimum days until deadline",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only notices with at least this many whole days left before the submission deadline, counted in Brussels local time — the zone every TED deadline is stamped in ('daysUntilDeadline' in the output). Use it to skip tenders you cannot realistically prepare a bid for: 14 drops anything closing inside two weeks. Implies the open-deadline filter (a passed deadline is negative), and drops notices with no published deadline. Leave empty for no deadline floor."
          },
          "flatten": {
            "title": "Flatten array fields for CSV/Excel",
            "type": "boolean",
            "description": "Join the 4 array fields (CPV codes, contract nature, place of performance country/city) into a single comma-separated string instead of a JSON array. Off by default (JSON arrays); turn on if you're exporting to CSV/Excel and want one clean column per field instead of numbered field/0, field/1 columns.",
            "default": false
          },
          "watchLabel": {
            "title": "Watch mode: label",
            "type": "string",
            "description": "Set a name (e.g. \"my-cpv-watch\") to turn this run into an alert: the FIRST run with a given label + filter combination records every currently-matching notice and returns nothing (you pay nothing). Every run after that returns and charges only for notices NOT already delivered under that label — ideal for a scheduled run that should only tell you what's new. Leave empty for a normal one-off search. Don't pair this with a FIXED publicationDateTo -- see that field's warning."
          },
          "webhookUrl": {
            "title": "Webhook URL (notify on completion)",
            "type": "string",
            "description": "Optional. An http(s) URL to POST a small JSON summary to when the run finishes — notices pushed, pages scanned, TED's own reported total, watch-label new count if Watch mode label is set, and the run's dataset ID so you can fetch the results. A convenience for callers who want a completion ping without setting up an Apify platform webhook (which needs separate Console/API configuration per Task, not per run). Best-effort: a failed or slow webhook is logged as a warning and never fails the run or affects charging — it fires after every notice has already been pushed and charged. Leave empty to skip."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}