{
  "openapi": "3.0.1",
  "info": {
    "title": "UK & EU Contract Awards: Tender Winners as Leads",
    "description": "UK contracts and EU tenders won: contract awards from Find a Tender and TED, as B2B sales leads. Past awards, not open tenders. One row per winner with business email when published, website, value, end date and the official notice. $0.015 per row.",
    "version": "1.0",
    "x-build-id": "AS6Iq5oPVgZ3pwScC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aurelmark~contract-winners/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aurelmark-contract-winners",
        "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/aurelmark~contract-winners/runs": {
      "post": {
        "operationId": "runs-sync-aurelmark-contract-winners",
        "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/aurelmark~contract-winners/run-sync": {
      "post": {
        "operationId": "run-sync-aurelmark-contract-winners",
        "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": {
          "mode": {
            "title": "What to find",
            "enum": [
              "new_awards",
              "ending_soon",
              "fresh_winners"
            ],
            "type": "string",
            "description": "new_awards: winners in a date window. fresh_winners: winners since your last full run, no repeats. ending_soon: EU contracts that end in the next months (not the UK). ending_soon returns EU contracts held by one winner: a notice with one winner and one lot gives one row, and a notice whose lots all went to the same winner gives one row per lot. Notices with several winners, or whose lots cannot be matched to the winner for certain, are left out and counted in SUMMARY.",
            "default": "new_awards"
          },
          "countries": {
            "title": "Buyer countries",
            "type": "array",
            "description": "Countries of the public buyers, as two-letter codes: GB for the United Kingdom (read from Find a Tender) and the EU and EEA countries (read from TED). Leave empty for all of them. Example: [\"GB\", \"DE\", \"FR\"].",
            "items": {
              "type": "string",
              "enum": [
                "GB",
                "AT",
                "BE",
                "BG",
                "HR",
                "CY",
                "CZ",
                "DK",
                "EE",
                "FI",
                "FR",
                "DE",
                "GR",
                "HU",
                "IE",
                "IT",
                "LV",
                "LT",
                "LU",
                "MT",
                "NL",
                "PL",
                "PT",
                "RO",
                "SK",
                "SI",
                "ES",
                "SE",
                "IS",
                "LI",
                "NO"
              ],
              "enumTitles": [
                "United Kingdom (GB)",
                "Austria (AT)",
                "Belgium (BE)",
                "Bulgaria (BG)",
                "Croatia (HR)",
                "Cyprus (CY)",
                "Czechia (CZ)",
                "Denmark (DK)",
                "Estonia (EE)",
                "Finland (FI)",
                "France (FR)",
                "Germany (DE)",
                "Greece (GR)",
                "Hungary (HU)",
                "Ireland (IE)",
                "Italy (IT)",
                "Latvia (LV)",
                "Lithuania (LT)",
                "Luxembourg (LU)",
                "Malta (MT)",
                "Netherlands (NL)",
                "Poland (PL)",
                "Portugal (PT)",
                "Romania (RO)",
                "Slovakia (SK)",
                "Slovenia (SI)",
                "Spain (ES)",
                "Sweden (SE)",
                "Iceland (IS)",
                "Liechtenstein (LI)",
                "Norway (NO)"
              ]
            },
            "default": []
          },
          "daysBack": {
            "title": "How many days back",
            "minimum": 1,
            "maximum": 31,
            "type": "integer",
            "description": "For mode new_awards: how many days back to read award notices, counted from today, 1 to 31. 7 means today and the 7 days before it. Ignored when publishedFrom is set. Few notices are published at weekends. For mode fresh_winners: the window of the first run only; later runs read from the last full run.",
            "default": 7
          },
          "publishedFrom": {
            "title": "Published from",
            "type": "string",
            "description": "For mode new_awards: the first publication day to read, as YYYY-MM-DD, instead of daysBack. Not with fresh_winners. The window from publishedFrom to publishedTo can be at most 32 days, the same as daysBack 31. Example: 2026-11-02."
          },
          "publishedTo": {
            "title": "Published to",
            "type": "string",
            "description": "For mode new_awards: the last publication day to read, as YYYY-MM-DD. Needs publishedFrom. Leave empty for today. Example: 2026-11-08."
          },
          "endingWithinMonths": {
            "title": "Contracts ending within (months)",
            "minimum": 1,
            "maximum": 24,
            "type": "integer",
            "description": "For mode ending_soon (EU and EEA buyers only): return contracts whose published end date falls within this many months from today, 1 to 24. Ignored in mode new_awards.",
            "default": 6
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Keep only awards whose title, description or lot title contains at least one of these words or phrases. Upper and lower case do not matter. Notices are in their own language, so add the words in each language you need. Example: [\"software\", \"logiciel\", \"oprogramowanie\"]. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "cpvCodes": {
            "title": "What was bought (CPV codes)",
            "type": "array",
            "description": "Keep only awards with one of these CPV codes, the EU's numbered list of products and services, 2 to 8 digits. Presets: 909 cleaning, 507 building maintenance, 72 IT. A short code matches everything under it: 72 or 72000000 matches all IT services, 45 all construction work. Example: [\"72\", \"48\"]. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minValueEur": {
            "title": "Minimum value in euros",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only awards worth at least this many euros. Values in other currencies are converted at the European Central Bank's monthly rate. Rows without a published value are left out when this is set. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits)."
          },
          "maxValueEur": {
            "title": "Maximum value in euros",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only awards worth at most this many euros. Rows without a published value are left out when this is set. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits)."
          },
          "winnerSize": {
            "title": "Winner size",
            "enum": [
              "any",
              "sme",
              "large"
            ],
            "type": "string",
            "description": "Keep only winners of this size as the notice states it: sme (small and medium-sized firms) or large. any keeps all, including winners whose size is not published. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": "any"
          },
          "winnerCountry": {
            "title": "Winner countries",
            "type": "array",
            "description": "Keep only winners based in these countries, as two-letter codes in capitals. Leave empty for winners from anywhere. Example: [\"DE\", \"AT\"]. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyWithEmail": {
            "title": "Only rows with a contact email",
            "type": "boolean",
            "description": "Keep only rows that show a contact email. Rows whose email is withheld (one person's or possibly one person's mailbox, a free-mail address or a certified legal mailbox) or not published are left out and not charged. With this off, an email shows on 44.1% of UK rows and 16.9% of EU rows (measured 13 November 2026). On in the form; off by default for API runs. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": false
          },
          "onlyWithWebsite": {
            "title": "Only rows with a website",
            "type": "boolean",
            "description": "Keep only rows that have the winner's website, from the notice or from the domain of its published email. Other rows are left out and not charged. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": false
          },
          "excludeFrameworks": {
            "title": "Leave out framework agreements (many winners, no guaranteed order)",
            "type": "boolean",
            "description": "Leave out awards that are framework agreements, which often name many winners without a guaranteed order for any of them. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": false
          },
          "includeNamedContacts": {
            "title": "Also show named-person, possibly personal and free-mail contacts",
            "type": "boolean",
            "description": "Off: only role or function addresses (info@, sales@) are shown; addresses that are, or may be, one person's mailbox and free-mail addresses are withheld, with the reason in contactEmailWithheld. On: these are shown too; they can be personal data, so you need your own lawful reason to use them. Email shown, measured 13 November 2026: 44.1% of UK rows and 16.9% of EU rows when off, 100.0% of UK rows and 35.2% of EU rows when on. Certified legal mailboxes (Italian PEC) are always withheld.",
            "default": false
          },
          "onlyNew": {
            "title": "Only new rows",
            "type": "boolean",
            "description": "Leave out rows that an earlier run with this switch on already delivered, so a weekly schedule returns and charges only what is new. The memory is a key-value store named contract-winners-seen in your own account; it holds row ids and dates, nothing else. With this filter a run reads at most 3 EU daily packages plus one per row found (see Limits).",
            "default": false
          },
          "maxRows": {
            "title": "Maximum rows",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most winner rows this run returns and charges, 1 to 10,000. At $0.015 a row the run costs at most maxRows x $0.015: 100 rows cost at most $1.50. The run stops at this number, or earlier at your own spending limit. The only other charge is Apify's standard start fee of $0.00005 per run.",
            "default": 100
          },
          "companyEmailFromNoticeDomain": {
            "title": "Find the company's role address when the notice gives only a person's",
            "type": "boolean",
            "description": "On: when the notice gives only a withheld address (a person's, or one that may be) and its domain is the winner's own name, the company website on that domain is read for a role address such as info@ or sales@. The person's address stays hidden; contactEmailSource says \"company website via notice domain\" and contactEmailSourceUrl gives the page. Free-mail domains and domains that are not the winner's name are never tried. Adds a few seconds per such row.",
            "default": true
          },
          "resetSeen": {
            "title": "Forget delivered rows",
            "type": "boolean",
            "description": "Clears the memory used by onlyNew and fresh_winners (the key-value store contract-winners-seen in your account) before this run, so every row counts as new again and fresh_winners starts as a first run.",
            "default": false
          },
          "maxComputeUsd": {
            "title": "Stop when compute reaches (USD)",
            "minimum": 0.001,
            "maximum": 100,
            "type": "number",
            "description": "Optional. The run stops cleanly, keeping the rows it has saved, once its own compute passes this many US dollars; rows not saved are not charged. Leave empty for the default: $0.021 per 1,000 rows of maxRows x 3 ($0.0084 with companyEmailFromNoticeDomain off), at least $0.02, more with more memory (see Limits)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}