# Changelog of UK & EU Contract Awards: Tender Winners as Leads (`aurelmark/contract-winners`) Actor

- **URL**: https://apify.com/aurelmark/contract-winners/changelog.md
- **Full Actor documentation**: https://apify.com/aurelmark/contract-winners.md

## Changelog: UK and EU Contract Winners

Every change gets one line here the same day (blueprint step 98, S39). A breaking change gets two weeks' notice.
Field names never change inside a major version; fields are only added.

### Unreleased (merges after the 1.0.0 listing)

- 12 November 2026: new mode `fresh_winners`: the winners published since the last full run with the same filters, never a row twice. The run day is kept per set of filters (a hash and a date) in the existing `contract-winners-seen` store. Same rows, privacy rules and price.

### 1.0.0, \[launch date]

First public version. One row per winner and award from the UK Find a Tender feed and the EU's TED: the winner, the business contact, the value in euros, the contract dates and the official notice link.
Price: $0.015 for each winner row ($15 per 1,000); nothing for a run that finds nothing.

#### Before launch

- 12 November 2026: a Polish winner whose name reads as a private person (a sole trader or a civil partnership, s.c.) gives no row even when the notice does not mark it, and `includeNamedContacts` does not bring it back; the SUMMARY counts these in `euWinnersLeftOutPersonByName`. A Polish winner is typed `company` only when its name carries a company form. Other countries rely on the notice's own mark. Contact person names left in three saved test notices were removed.
- 11 November 2026: a charge that gets no answer within 60 seconds stops the run cleanly, like a failed charge. That one result is listed in the SUMMARY under `chargeNotConfirmed` and the final message says its charge is not confirmed; the charge is never tried again, so it is charged once at most.
- 11 November 2026: the README says that after a run killed without warning and started again, `chargedResults` in the SUMMARY can be one higher than what the platform charged (a row saved just before its charge is delivered free).
- 11 November 2026: the shares were measured once more on 1,000 rows each after the code review: an email is shown by default on 53.8% of UK rows and 22.8% of EU rows, and with `includeNamedContacts` on 100.0% and 54.3%, all as before; a website is on 87.8% of UK rows (was 87.3%) and 44.4% of EU rows (was 44.1%).
- 11 November 2026: a run that is stopped hard and started again gives no row twice and charges for none twice: what the run's own dataset already holds is the truth, and reading goes on from there.
- 11 November 2026: a role word of two letters (ap, hr, it, pr) can also be a pair of initials, so with only the organisation's own name beside it the address is no longer read as a role and is withheld by default. Alone (hr@) or with a listed word beside it, it stays a role.
- 11 November 2026: a winner the notice marks as a private person gives no row and no charge by default; the SUMMARY counts them in `euWinnersLeftOutPrivatePerson` and the run's message says it. With `includeNamedContacts` on the full row comes.
- 11 November 2026: the shares of rows with an email, a website and the rest were measured again on the same 1,000 rows each after the review fixes: an email is shown by default on 53.8% of UK rows (was 55.3%) and 22.8% of EU rows (was 23.3%); with `includeNamedContacts` on, 100.0% and 54.3% as before.
- 11 November 2026: a UK next-page link of an unknown form, or one that leads back to a page already read, stops the UK reading with a note, a log line and `ukPagingStoppedEarly` in the SUMMARY, instead of ending silently or never ending. Two more kinds of EU lot that give no row are counted (`euLotsLeftOutWinnerNotSettled`, `euLotsLeftOutWinnerNotNamed`) and said in the run's message.
- 11 November 2026: an EU lot whose result lists no tender is read through its settled contract. When the contract names the winner only through a tender of another lot, the row carries no value. A lot that still names no winner gives no row, is counted in the `SUMMARY` record as `euLotsLeftOutWinnerNotListed` and is named in the run's message and log. Found by the independent golden-set review (notice 768859-2026).
- 11 November 2026: mailboxes on one more internet provider's customer domain are typed `free_mail` (notice 767544-2026). They were withheld before as well.
- 11 November 2026: the reason on a withheld `named` address now reads "Withheld: the published address looks like a person's name (for example first.last). Set includeNamedContacts to true to see it." The old text said the address belongs to a named person, which the tool cannot know. The type and what is shown did not change.
- 11 November 2026: a mailbox named after one office-holder's title (ceo@, managing.director@ and the like) is withheld by default, with the new `contactEmailType` value `office_holder` and the reason "Withheld: the published address may be one office-holder's own mailbox (for example a chief executive's). Set includeNamedContacts to true to see it." Team mailboxes (info@, sales@, directors@) stay shown.
- 11 November 2026: the README says that a placeholder amount other than 0 and -1 (such as 1.00 on every lot) is passed on as published, and the email shares were measured again (UK 55.3% shown by default).
- 11 November 2026: a winner the notice marks as a natural person keeps the type `named` and gets its own reason: "Withheld: the notice marks this winner as a private person. Set includeNamedContacts to true to see it."
