{
  "openapi": "3.0.1",
  "info": {
    "title": "Public Tenders & Government Contracts Scraper: TED, UK, US, SA",
    "description": "Scrape government tenders, RFPs and contract awards from EU TED, UK Find a Tender, Contracts Finder, US SAM.gov federal contract opportunities and South Africa eTenders in one schema. Filter by keyword, CPV, country, value. Daily alerts. $6 per 1,000 notices.",
    "version": "1.0",
    "x-build-id": "eDY7K3vbmy8u1uDi2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aria-data~public-tenders-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aria-data-public-tenders-monitor",
        "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/aria-data~public-tenders-monitor/runs": {
      "post": {
        "operationId": "runs-sync-aria-data-public-tenders-monitor",
        "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/aria-data~public-tenders-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-aria-data-public-tenders-monitor",
        "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": {
          "sources": {
            "title": "Sources",
            "type": "array",
            "description": "Official procurement portals to search. All selected sources are queried in parallel; if one portal is down, the others still return results.",
            "items": {
              "type": "string",
              "enum": [
                "ted",
                "uk_find_a_tender",
                "uk_contracts_finder",
                "za_etenders",
                "sam_gov"
              ],
              "enumTitles": [
                "EU – TED (Tenders Electronic Daily, all EU/EEA countries)",
                "UK – Find a Tender (above-threshold UK notices)",
                "UK – Contracts Finder (below-threshold UK notices, England)",
                "South Africa – eTenders (National Treasury)",
                "USA – SAM.gov (federal contract opportunities, no API key needed)"
              ]
            },
            "default": [
              "ted",
              "uk_find_a_tender",
              "uk_contracts_finder",
              "za_etenders",
              "sam_gov"
            ]
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Notices matching ANY keyword are returned (whole-word, case-insensitive; multi-word phrases allowed, e.g. \"cyber security\"). TED notices are often in the local language. Add translations (e.g. \"Software\", \"logiciel\") for better EU coverage. Leave empty to get everything.",
            "items": {
              "type": "string"
            }
          },
          "keywordScope": {
            "title": "Keyword match scope",
            "enum": [
              "title_description",
              "full_text"
            ],
            "type": "string",
            "description": "Where keywords are searched. 'Title & description' is precise. 'Full text' also searches buyer names, CPV labels and document titles (on TED, the full notice text).",
            "default": "title_description"
          },
          "cpvCodes": {
            "title": "CPV codes",
            "type": "array",
            "description": "Common Procurement Vocabulary codes. Matching is hierarchical: 72000000 matches every IT service under 72xxxxxx, 45233120 matches only that code. South Africa eTenders does not publish CPV codes, so it is skipped when a CPV filter is set (use keywords for SA). SAM.gov uses NAICS/PSC codes instead of CPV and is skipped the same way.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Buyer countries",
            "type": "array",
            "description": "ISO 3166 alpha-2 codes, e.g. DE, FR, NL, GB, US, ZA (UK is accepted for GB). Sources that cannot match the list are skipped automatically. Leave empty for all countries.",
            "items": {
              "type": "string"
            }
          },
          "noticeStage": {
            "title": "Notice stage",
            "enum": [
              "tender",
              "planning",
              "award",
              "all"
            ],
            "type": "string",
            "description": "'Open opportunities' = contract notices you can still bid on (including updates and cancellations). 'Planned' = prior information / pipeline notices. 'Awards' = contract award notices with winners and awarded values (great for competitor intelligence). eTenders only supports open opportunities.",
            "default": "tender"
          },
          "publishedSince": {
            "title": "Published since (date)",
            "type": "string",
            "description": "Only notices published on or after this date (YYYY-MM-DD). Overrides 'Days back'."
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Used when 'Published since' is empty: look back this many days from today (0 = today only). For a daily schedule with onlyNew, 2–3 days gives a safe overlap.",
            "default": 3
          },
          "minValue": {
            "title": "Minimum value",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum estimated (or awarded) contract value, compared in the notice's own currency (EUR, GBP, SEK, ZAR…). No currency conversion is applied."
          },
          "maxValue": {
            "title": "Maximum value",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum contract value, in the notice's own currency."
          },
          "includeUnknownValue": {
            "title": "Keep notices without a published value",
            "type": "boolean",
            "description": "Many notices do not state a value (almost all SA eTenders notices). When a min/max value is set, keep these notices (on) or drop them (off).",
            "default": true
          },
          "onlyOpen": {
            "title": "Only notices with a future deadline",
            "type": "boolean",
            "description": "Drop notices whose submission deadline has already passed, or that have no deadline.",
            "default": false
          },
          "maxResults": {
            "title": "Max results per source",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of notices returned from EACH selected source. You are charged per notice returned.",
            "default": 100
          },
          "onlyNew": {
            "title": "Only new notices (monitor mode)",
            "type": "boolean",
            "description": "Remember every notice returned and, on later runs, return only notices not seen before. Use with a daily Schedule to get alerts without duplicates (you are never charged twice for the same notice). State is kept in a named key-value store for 180 days.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID",
            "type": "string",
            "description": "Name of this alert, used to keep separate 'already seen' lists for different searches (e.g. 'it-services-dach', 'construction-uk'). Only used with onlyNew.",
            "default": "default"
          },
          "stateStoreName": {
            "title": "State key-value store name",
            "type": "string",
            "description": "Named key-value store where onlyNew remembers seen notice ids. Named stores persist between runs in your Apify account.",
            "default": "tenders-monitor-state"
          },
          "includeDocuments": {
            "title": "Include document links",
            "type": "boolean",
            "description": "Add links to notice PDFs, procurement documents and tender packs (where the portal publishes them) in the 'documents' field.",
            "default": true
          },
          "maxPagesPerSource": {
            "title": "Max API pages per source (safety cap)",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Upper bound on API pages fetched per source. UK and SA portals have no server-side keyword search, so very long windows with narrow keywords can scan many pages.",
            "default": 200
          },
          "sourceTimeBudgetSecs": {
            "title": "Time budget per source (seconds)",
            "minimum": 30,
            "maximum": 3600,
            "type": "integer",
            "description": "Each portal gets at most this long per run. When it runs out, that source stops and returns what it found so far (noted in RUN_SUMMARY / OUTPUT under skippedSources), so a slow or rate-limited portal can never stall the whole run.",
            "default": 120
          },
          "samGovApiKey": {
            "title": "SAM.gov API key (optional)",
            "type": "string",
            "description": "Not needed: SAM.gov is read keylessly through the public endpoints the sam.gov website uses. Only if that route is ever blocked, a free api.data.gov key you request at https://sam.gov (Account Details > Public API Key) lets the Actor fall back to the official Opportunities API."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}