{
  "openapi": "3.0.1",
  "info": {
    "title": "EU TED Tenders Scraper — New Tender & Award Alerts",
    "description": "Scrape EU public tenders from TED via the official TED API — buyer, title, CPV codes, submission deadline, estimated value, award winners. Monitoring mode delivers only new tenders, award notices and change notices. $0.005 per notice, no start fee.",
    "version": "0.0",
    "x-build-id": "alf5ui9BIJcQKBaYx"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magnova~eu-ted-tenders-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magnova-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/magnova~eu-ted-tenders-scraper/runs": {
      "post": {
        "operationId": "runs-sync-magnova-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/magnova~eu-ted-tenders-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-magnova-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": {
          "backfillDays": {
            "title": "Publication days back",
            "minimum": 1,
            "maximum": 92,
            "type": "integer",
            "description": "How many publication days back the run covers, counting back from yesterday (the last complete Official Journal day). TED publishes on working days; 7 days covers a full week. The window is ignored when Date from / Date to are set. Scheduled monitoring runs typically use 2-3 days of lookback plus a monitor store, so a missed day never loses notices."
          },
          "buyerCountries": {
            "title": "Buyer countries (optional — empty = all)",
            "type": "array",
            "description": "Optional filter: only notices whose BUYER (the contracting authority) is in one of these countries. ISO 3166 alpha-3 codes, e.g. DEU, FRA, POL, ESP. Leave empty for all countries. This is the buyer's country, not the place of performance.",
            "items": {
              "type": "string"
            }
          },
          "cpvPrefixes": {
            "title": "CPV prefixes (optional — empty = all)",
            "type": "array",
            "description": "Optional filter: only notices carrying at least one CPV code that starts with one of these prefixes. CPV is the EU's procurement vocabulary: \"45\" = construction work, \"72\" = IT services, \"79\" = business services, \"48\" = software packages. Give 2-8 digits; a full 8-digit code matches exactly. Leave empty for all CPV codes.",
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "Date from (optional, overrides days back)",
            "type": "string",
            "description": "Optional explicit window start (ISO date, e.g. \"2026-10-01\"). Must be given together with Date to, and overrides Publication days back. Useful for one-off corpus pulls (e.g. a quarter of award history)."
          },
          "dateTo": {
            "title": "Date to (optional)",
            "type": "string",
            "description": "Optional explicit window end (ISO date, e.g. \"2026-10-31\"). Must be given together with Date from. Maximum window: 366 days."
          },
          "eventTypes": {
            "title": "Event types (optional — empty = all)",
            "type": "array",
            "description": "Optional filter on the kind of event each notice represents. NEW = a newly published notice (new tender, prior information notice, qualification system, ...). AWARD = a contract award notice (who won, and for how much). CHANGE = a notice that changes an earlier one — a corrigendum, an update, a cancellation, or a contract modification notice (can-modif); a change record always carries the notice's CURRENT submission deadline. Leave empty for all event types.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords (optional — TED full-text search)",
            "type": "array",
            "description": "Optional keyword filter using TED's own full-text search: a notice is delivered when TED's index matches one of your keywords or phrases anywhere in the notice's full text (title, description, buyer, and the rest of the notice body — the full text lives in the notice XML; this Actor ships the main fields only). Up to 20 keywords, combined with OR. Note the difference from a title filter: a keyword can match text a delivered record does not itself contain, and the record's matchedKeywords field lists only the keywords that literally appear in its title, description or buyer name.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum notices per run",
            "minimum": 1,
            "maximum": 15000,
            "type": "integer",
            "description": "Hard cap on notices delivered (and charged) in one run. Notices are delivered newest first (highest publication number), so a capped run delivers the most recent matches; capped-out notices stay unseen in monitoring mode and are delivered by the next run if they still fall in its window. Leave at 1000 unless you are pulling a large corpus."
          },
          "maxTotalChargeUsd": {
            "title": "Maximum total charge per run (USD)",
            "minimum": 0.01,
            "type": "number",
            "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged notices reach this amount (checked conservatively at the highest per-notice price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Undelivered new notices stay unseen, so the next run delivers them. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly."
          },
          "minEstimatedValue": {
            "title": "Minimum estimated value (optional)",
            "minimum": 0,
            "type": "number",
            "description": "Optional: only deliver notices whose estimated value is at least this amount (compared in the notice's own currency — TED values are overwhelmingly in EUR; award notices are compared on their awarded value). Notices that publish no value at all are excluded while this is set."
          },
          "monitorOnlyNew": {
            "title": "Start monitoring silently (skip the first baseline)",
            "type": "boolean",
            "description": "Off (default): the first run delivers the window's current notices as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current notices without delivering or charging anything, and only notices published afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run."
          },
          "monitorStore": {
            "title": "Monitor state store (for only-new delivery)",
            "type": "string",
            "description": "A key-value store this Actor may read and write to remember which notices it has already seen — this is what makes only-new delivery work across runs. Pick any store you own; the Actor keeps one small state record in it. Without a store, every run delivers the window's notices as a baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes. The Actor remembers every notice it processed (including ones your filters excluded), so widening the filters later does not re-deliver old notices."
          },
          "publishedSince": {
            "title": "Published on/after (stateless cursor)",
            "type": "string",
            "description": "Optional stateless cursor for workflow tools (Make, Zapier, your own scheduler) that hold state themselves: only notices published on this ISO date or later are delivered — for example \"2026-11-01\" or \"2026-11-01T00:00:00Z\". TED publication dates are day-granular, so the cursor compares by day, boundary-inclusive. The cursor raises the window start; it does not extend the window end. Leave empty for the normal window behavior."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}