Councils - robbrad/UKBinCollectionData GitHub Wiki

This Markdown document provides a list of commands and parameters for use with this script.

As a reminder, most scripts only need a module name and a URL to run, but others need more parameters depending on how the data is scraped.

For scripts that need postcodes, these should be provided in double quotes and with a space, e.g. "AA1 2BB" rather than AA12BB.

This document is still a work in progress, don't worry if your council isn't listed - it will be soon!

Contents

Adur and Worthing Councils

python collect_data.py AdurAndWorthingCouncils https://www.adur-worthing.gov.uk/bin-day/?brlu-selected-address=XXXXXXXX

Note: Replace XXXXXXXX with UPRN. You will need to use FindMyAddress to find the UPRN.

Arun Council

python collect_data.py ArunCouncil https://www1.arun.gov.uk/when-are-my-bins-collected -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Aylesbury Vale Council (Buckinghamshire)

python collect_data.py AylesburyValeCouncil http://avdcbins.web-labs.co.uk/RefuseApi.asmx -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: To get the UPRN, please use FindMyAddress. Returns all published collections in the past, present, future.

BCP Council

python collect_data.py BCPCouncil https://online.bcpcouncil.gov.uk/bindaylookup/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Barnet Council

python collect_data.py BarnetCouncil https://www.barnet.gov.uk/recycling-and-waste/bin-collections/find-your-bin-collection-day -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Barnsley Metropolitan Borough Council

python collect_data.py BarnsleyMBCouncil https://waste.barnsley.gov.uk/ViewCollection/Collections -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Note: To get the UPRN, you will need to use FindMyAddress.

Basingstoke Council

python collect_data.py BasingstokeCouncil https://www.basingstoke.gov.uk/bincollection -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Bath and North East Somerset Council

python collect_data.py BathAndNorthEastSomersetCouncil https://www.bathnes.gov.uk/webforms/waste/collectionday/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Bedford Borough Council

python collect_data.py BedfordBoroughCouncil https://www.bedford.gov.uk/bins-and-recycling/household-bins-and-recycling/check-your-bin-day -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Bedfordshire Council

python collect_data.py BedfordshireCouncil https://www.centralbedfordshire.gov.uk/info/163/bins_and_waste_collections_-_check_bin_collection_day -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Note: In order to use this parser, you must provide a valid postcode and a uprn retrieved from the councils website for your specific address

Bexley Council

python collect_data.py BexleyCouncil https://mybexley.bexley.gov.uk/service/When_is_my_collection_day -s -u XXXXXXXX -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: In order to use this parser, you will need to sign up to Bexley's @Home app (available for iOS and Android). Complete the setup by entering your email and setting your address with postcode and address line. Once you can see the calendar, you should be good to run the parser. Just pass the email you used in quotes in the UPRN parameter.

Blackburn Council

python collect_data.py BlackburnCouncil https://www.blackburn.gov.uk -s -u XXXXXXXX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -w - remote Selenium web driver URL (required for Home Assistant)

Bolton Council

python collect_data.py BoltonCouncil https://carehomes.bolton.gov.uk/bins.aspx -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: To get the UPRN, you will need to use FindMyAddress. Previously required single field that was UPRN and full address, now requires UPRN and postcode as separate fields.

Brighton and Hove City Council

python collect_data.py BrightonandHoveCityCouncil https://cityclean.brighton-hove.gov.uk/link/collections -s -u XXXXXXXX -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Use the full address as it appears on the drop down on the site when you search by postcode

Bristol City Council

python collect_data.py BristolCityCouncil https://bristolcouncil.powerappsportals.com/completedynamicformunauth/?servicetypeid=7dce896c-b3ba-ea11-a812-000d3a7f1cdc -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Bromley Borough Council

python collect_data.py BromleyBoroughCouncil https://recyclingservices.bromley.gov.uk/waste/XXXXXXX -w http://HOST:PORT/

Additional parameters:

  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Follow the instructions here until the "Your bin days" page then copy the URL and replace the URL in the command.

Broxtowe Borough Council

python collect_data.py BroxtoweBoroughCouncil https://www.broxtowe.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Buckinghamshire Council (Chiltern, South Bucks, Wycombe)

python collect_data.py BuckinghamshireCouncil https://chiltern.gov.uk/collection-dates -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the name of the street with the house number parameter, wrapped in double quotes

Bury Council

python collect_data.py BuryCouncil https://www.bury.gov.uk/waste-and-recycling/bin-collection-days-and-alerts -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Note: Pass the postcode and house number in their respective arguments, both wrapped in quotes.

Calderdale Council

python collect_data.py CalderdaleCouncil https://www.calderdale.gov.uk/environment/waste/household-collections/collectiondayfinder.jsp -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Cannock Chase District Council

python collect_data.py CannockChaseDistrictCouncil https://www.cannockchasedc.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Note: To get the UPRN, you can use FindMyAddress

Cardiff Council

python collect_data.py CardiffCouncil https://www.cardiff.gov.uk/ENG/resident/Rubbish-and-recycling/When-are-my-bins-collected/Pages/default.aspx -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Castlepoint District Council

python collect_data.py CastlepointDistrictCouncil https://apps.castlepoint.gov.uk/cpapps/index.cfm?fa=wastecalendar -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: For this council 'uprn' is actually a 4 digit code for your street, go here and inspect the source of the dropdown box to find the 4 digit number for your street.

Charnwood Borough Council

python collect_data.py CharnwoodBoroughCouncil https://my.charnwood.gov.uk/location?put=cbcXXXXXXXX&rememberme=0&redirect=%2F

Note: Replace XXXXXXXX with UPRN keeping "cbc" before it.

Chelmsford City Council

python collect_data.py ChelmsfordCityCouncil https://www.chelmsford.gov.uk/myhome/ -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Follow the instructions here until you get the page listing your "Address" then copy the entire address text and use that in the house number field.

Cheshire East Council

python collect_data.py CheshireEastCouncil https://online.cheshireeast.gov.uk/MyCollectionDay/SearchByAjax/GetBartecJobList?uprn=XXXXXXXX&onelineaddress=XXXXXXXX&_=1689413260149

Note: Both the UPRN and a one-line address are passed in the URL, which needs to be wrapped in double quotes. The one-line address is made up of the house number, street name and postcode. Use the form here to find them, then take the first line and post code and replace all spaces with %20.

Chorley Council

python collect_data.py ChorleyCouncil https://myaccount.chorley.gov.uk/wastecollections.aspx -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Chorley needs to be passed both a Postcode & UPRN to work. Find this on FindMyAddress

Conwy County Borough Council

python collect_data.py ConwyCountyBorough https://www.conwy.gov.uk/Contensis-Forms/erf/collection-result-soap-xmas.asp?ilangid=1&uprn=100100429249 -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -u - UPRN
  • -p - postcode

Note: Conwy County Borough Council is a straight up uprn in the url eg &uprn=XXXXXXXXXXXXX .

Crawley Borough Council

python collect_data.py CrawleyBoroughCouncil https://my.crawley.gov.uk/ -s -u XXXXXXXX -n XX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -n - house number

Note: Crawley needs to be passed both a UPRN and a USRN to work. Find these on FindMyAddress or FindMyStreet.

Croydon Council

python collect_data.py CroydonCouncil https://service.croydon.gov.uk/wasteservices/w/webpage/bin-day-enter-address -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Derbyshire Dales District Council

python collect_data.py DerbyshireDalesDistrictCouncil https://www.derbyshiredales.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Doncaster Council

python collect_data.py DoncasterCouncil https://www.doncaster.gov.uk/Compass/Entity/Launch/D3/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Dorset Council

python collect_data.py DorsetCouncil https://gi.dorsetcouncil.gov.uk/mapping/mylocal/viewresults/XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Dover District Council

python collect_data.py DoverDistrictCouncil https://collections.dover.gov.uk/property/XXXXXXXXXXX

Note: Replace XXXXXXXXXXXX with your UPRN. To get the UPRN, you can use FindMyAddress.

Durham Council

python collect_data.py DurhamCouncil https://www.durham.gov.uk/bincollections?uprn= -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

East Cambridgeshire Council

python collect_data.py EastCambridgeshireCouncil https://www.eastcambs.gov.uk/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

East Devon District Council

python collect_data.py EastDevonDC https://eastdevon.gov.uk/recycling-and-waste/recycling-and-waste-information/when-is-my-bin-collected/future-collections-calendar/?UPRN=XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

East Lindsey District Council

python collect_data.py EastLindseyDistrictCouncil https://www.e-lindsey.gov.uk/ -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number in the house number parameter, wrapped in double quotes

East Riding Council

python collect_data.py EastRidingCouncil https://wasterecyclingapi.eastriding.gov.uk -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Put the full address as it displays on the council website dropdown when you do the check manually

East Suffolk Council

python collect_data.py EastSuffolkCouncil https://my.eastsuffolk.gov.uk/service/Bin_collection_dates_finder -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: To get the UPRN, you can use FindMyAddress

Eastleigh Borough Council

python collect_data.py EastleighBoroughCouncil https://www.eastleigh.gov.uk/waste-bins-and-recycling/collection-dates/your-waste-bin-and-recycling-collections?uprn= -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Environment First

python collect_data.py EnvironmentFirst https://environmentfirst.co.uk/house.php?uprn=XXXXXXXXXX

Note: For properties with collections managed by Environment First, such as Lewes and Eastbourne. Replace the XXXXXXXXXXX with the UPRN of your property - you can use FindMyAddress to find this.

Erewash Borough Council

python collect_data.py ErewashBoroughCouncil https://map.erewash.gov.uk/isharelive.web/myerewash.aspx -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Fenland District Council

python collect_data.py FenlandDistrictCouncil https://www.fenland.gov.uk/article/13114/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Forest of Dean District Council

python collect_data.py ForestOfDeanDistrictCouncil https://community.fdean.gov.uk/s/waste-collection-enquiry -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the full address in the house number and postcode in

Gateshead Council

python collect_data.py GatesheadCouncil https://www.gateshead.gov.uk/ -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number in the house number parameter, wrapped in double quotes

Gedling Borough Council

python collect_data.py GedlingBoroughCouncil https://www.gedling.gov.uk/ -s -n XX

Additional parameters:

  • -s - skip get URL
  • -n - house number

Note: Pass the street name into the -n parameter. Use this to help work out a street search that is unique. Known issues: 1) If multiple streets returned, it will pick the first and these may have different bin schedules. 2) This data is hand entered as council only provide non-parseable non-accessible PDFs - Please double check for any issues. 2b) Data is only included until end of Nov 2024 (refuse) and March 2024 (Garden). Data will need to be updated by hand after these dates.

Glasgow City Council

python collect_data.py GlasgowCityCouncil https://www.glasgow.gov.uk/forms/refuseandrecyclingcalendar/PrintCalendar.aspx?UPRN=XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Guildford Council

python collect_data.py GuildfordCouncil https://my.guildford.gov.uk/customers/s/view-bin-collections -s -u XXXXXXXX -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: If the bin day is 'today' then the collectionDate will only show today's date if before 7AM, else the date will be in 'previousCollectionDate'. To get the UPRN, you will need to use FindMyAddress to find the UPRN.

Halton Borough Council

python collect_data.py HaltonBoroughCouncil https://webapp.halton.gov.uk/PublicWebForms/WasteServiceSearchv1.aspx#collections -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the House number and post code

Haringey Council

python collect_data.py HaringeyCouncil  https://wastecollections.haringey.gov.uk/property -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: Pass the UPRN which can be found at https://wastecollections.haringey.gov.uk/property/{uprn}.

Harrogate Borough Council

python collect_data.py HarrogateBoroughCouncil https://secure.harrogate.gov.uk/inmyarea -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: Pass the UPRN which can be found at https://secure.harrogate.gov.uk/inmyarea URL doesn't need to be passed.

High Peak Council

python collect_data.py HighPeakCouncil https://www.highpeak.gov.uk/findyourbinday -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the name of the street with the house number parameter, wrapped in double quotes

Hull City Council

python collect_data.py HullCityCouncil https://www.hull.gov.uk/bins-and-recycling/bin-collections/bin-collection-day-checker -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Huntingdon District Council

python collect_data.py HuntingdonDistrictCouncil https://www.huntingdonshire.gov.uk/refuse-calendar/XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Kingston Upon Thames Council

python collect_data.py KingstonUponThamesCouncil https://waste-services.kingston.gov.uk/waste/XXXXXXX

Note: Follow the instructions here until the "Your bin days" page then copy the URL and replace the URL in the command.

Kirklees Council

python collect_data.py KirkleesCouncil https://www.kirklees.gov.uk/beta/your-property-bins-recycling/your-bins -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Lancaster City Council

python collect_data.py LancasterCityCouncil https://lcc-wrp.whitespacews.com -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Leeds City Council

python collect_data.py LeedsCityCouncil https://www.leeds.gov.uk/residents/bins-and-recycling/check-your-bin-day -s -u XXXXXXXX -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Lisburn and Castlereagh City Council

python collect_data.py LisburnCastlereaghCityCouncil https://lisburn.isl-fusion.com -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Liverpool City Council

python collect_data.py LiverpoolCityCouncil https://liverpool.gov.uk/Bins/BinDatesTable?UPRN=XXXXXXXX

Note: Replace XXXXXXXX with your property's UPRN.

London Borough Hounslow

python collect_data.py LondonBoroughHounslow https://www.hounslow.gov.uk/homepage/86/recycling_and_waste_collection_day_finder -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

London Borough Redbridge

python collect_data.py LondonBoroughRedbridge https://my.redbridge.gov.uk/RecycleRefuse -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Follow the instructions here until you get the page listing your "Address" then copy the entire address text and use that in the house number field.

Maldon District Council

python collect_data.py MaldonDistrictCouncil https://maldon.suez.co.uk/maldon/ServiceSummary -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Malvern Hills District Council

python collect_data.py MalvernHillsDC https://swict.malvernhills.gov.uk/mhdcroundlookup/HandleSearchScreen -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Manchester City Council

python collect_data.py ManchesterCityCouncil https://www.manchester.gov.uk/bincollections -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Mansfield District Council

python collect_data.py MansfieldDistrictCouncil https://www.mansfield.gov.uk/xfp/form/1327 -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Merton Council

python collect_data.py MertonCouncil https://myneighbourhood.merton.gov.uk/Wasteservices/WasteServices.aspx?ID=XXXXXXXX

Note: Follow the instructions here until you get the "Your recycling and rubbish collection days" page then copy the URL and replace the URL in the command (the Address parameter is optional).

Mid and East Antrim Borough Council

python collect_data.py MidAndEastAntrimBoroughCouncil https://www.midandeastantrim.gov.uk/resident/waste-recycling/collection-dates/ -s -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number plus the name of the street with the postcode parameter, wrapped in double quotes. Check the address in the web site first. This version will only pick the first SHOW button returned by the search or if it is fully unique. The search is not very predictable (e.g. house number 4 returns 14,24,4,44 etc.).

Mid Sussex District Council

python collect_data.py MidSussexDistrictCouncil https://www.midsussex.gov.uk/waste-recycling/bin-collection/ -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Note: Pass the name of the street with the house number parameter, wrapped in double quotes

Milton Keynes City Council

python collect_data.py MiltonKeynesCityCouncil https://www.milton-keynes.gov.uk/waste-and-recycling/collection-days -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: Pass the name of the estate with the UPRN parameter, wrapped in double quotes

Mole Valley District Council

python collect_data.py MoleValleyDistrictCouncil https://molevalley.cloudmappin.com/mmv/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Note: UPRN can only be parsed with a valid postcode.

Neath Port Talbot Council

python collect_data.py NeathPortTalbotCouncil https://www.npt.gov.uk -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Newark and Sherwood District Council

python collect_data.py NewarkAndSherwoodDC http://app.newark-sherwooddc.gov.uk/bincollection/calendar?pid=XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Newcastle City Council

python collect_data.py NewcastleCityCouncil https://community.newcastle.gov.uk/my-neighbourhood/ajax/getBinsNew.php?uprn=XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Newham Council

python collect_data.py NewhamCouncil https://bincollection.newham.gov.uk/Details/Index/XXXXXXXXXXX -s

Additional parameters:

  • -s - skip get URL

Note: Follow the instructions here until you get the "Rubbish and Recycling Collections" page then copy the URL and replace the URL in the command.

Newport City Council

python collect_data.py NewportCityCouncil https://www.newport.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

North East Derbyshire District Council

python collect_data.py NorthEastDerbyshireDistrictCouncil https://myselfservice.ne-derbyshire.gov.uk/service/Check_your_Bin_Day -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

North East Lincolnshire Council

python collect_data.py NorthEastLincs https://www.nelincs.gov.uk/refuse-collection-schedule/?view=timeline&uprn=XXXXXXXX -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: Replace XXXXXXXX with UPRN.

North Kesteven District Council

python collect_data.py NorthKestevenDistrictCouncil https://www.n-kesteven.org.uk/bins/display?uprn=XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

North Lanarkshire Council

python collect_data.py NorthLanarkshireCouncil https://www.northlanarkshire.gov.uk/bin-collection-dates/XXXXXXXXXXX/XXXXXXXXXXX

Note: Follow the instructions here until you get the "Next collections" page then copy the URL and replace the URL in the command.

North Lincolnshire Council

python collect_data.py NorthLincolnshireCouncil https://www.northlincs.gov.uk/bins-waste-and-recycling/bin-and-box-collection-dates/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

North Norfolk District Council

python collect_data.py NorthNorfolkDistrictCouncil https://www.north-norfolk.gov.uk/ -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the name of the street with the house number parameter, wrapped in double quotes

North Northamptonshire Council

python collect_data.py NorthNorthamptonshireCouncil https://cms.northnorthants.gov.uk/bin-collection-search/calendarevents/100031021318/2023-10-17/2023-10-01 -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

North Somerset Council

python collect_data.py NorthSomersetCouncil https://forms.n-somerset.gov.uk/Waste/CollectionSchedule -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

North Tyneside Council

python collect_data.py NorthTynesideCouncil https://my.northtyneside.gov.uk/category/81/bin-collection-dates -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

North West Leicestershire Council

python collect_data.py NorthWestLeicestershire https://www.nwleics.gov.uk/pages/collection_information -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

North Yorkshire Council

python collect_data.py NorthYorkshire https://www.northyorks.gov.uk/bin-calendar/lookup -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Northumberland Council

python collect_data.py NorthumberlandCouncil https://www.northumberland.gov.uk/Waste/Bins/Bin-Calendars.aspx -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Nottingham City Council

python collect_data.py NottinghamCityCouncil https://geoserver.nottinghamcity.gov.uk/myproperty/handler/proxy.ashx?https://geoserver.nottinghamcity.gov.uk/bincollections2/api/collection/100031540180 -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Oldham Council

python collect_data.py OldhamCouncil https://portal.oldham.gov.uk/bincollectiondates/details?uprn=422000033556

Note: Replace UPRN in URL with your own UPRN.

Portsmouth City Council

python collect_data.py PortsmouthCityCouncil https://my.portsmouth.gov.uk/en/AchieveForms/?form_uri=sandbox-publish://AF-Process-26e27e70-f771-47b1-a34d-af276075cede/AF-Stage-cd7cc291-2e59-42cc-8c3f-1f93e132a2c9/definition.json&redirectlink=%2F&cancelRedirectLink=%2F -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Preston City Council

python collect_data.py PrestonCityCouncil https://selfservice.preston.gov.uk/service/Forms/FindMyNearest.aspx?Service=bins -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Reading Borough Council

python collect_data.py ReadingBoroughCouncil https://api.reading.gov.uk/api/collections/XXXXXXXX

Note: Replace XXXXXXXX with your property's UPRN.

Reigate and Banstead Borough Council

python collect_data.py ReigateAndBansteadBoroughCouncil https://www.reigate-banstead.gov.uk/ -s -u XXXXXXXX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: To get the UPRN, you can use FindMyAddress

Rhondda Cynon Taff Council

python collect_data.py RhonddaCynonTaffCouncil https://www.rctcbc.gov.uk/EN/Resident/RecyclingandWaste/RecyclingandWasteCollectionDays.aspx -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Note: To get the UPRN, you can use FindMyAddress

Rochdale Council

python collect_data.py RochdaleCouncil https://webforms.rochdale.gov.uk/BinCalendar -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Rochford Council

python collect_data.py RochfordCouncil https://www.rochford.gov.uk/online-bin-collections-calendar

Note: No extra parameters are required. Dates presented should be read as 'week commencing'.

Rugby Borough Council

python collect_data.py RugbyBoroughCouncil https://www.rugby.gov.uk/check-your-next-bin-day -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Rushcliffe Borough Council

python collect_data.py RushcliffeBoroughCouncil https://www.rushcliffe.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Rushmoor Council

python collect_data.py RushmoorCouncil https://www.rushmoor.gov.uk/Umbraco/Api/BinLookUpWorkAround/Get?selectedAddress=XXXXXXXX

Note: Replace XXXXXXXXXX with your UPRN, which you can find using FindMyAddress.

Salford City Council

python collect_data.py SalfordCityCouncil https://www.salford.gov.uk/bins-and-recycling/bin-collection-days/your-bin-collections -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Sevenoaks District Council

python collect_data.py SevenoaksDistrictCouncil https://sevenoaks-dc-host01.oncreate.app/w/webpage/waste-collection-day -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number in the house number parameter, wrapped in double quotes and the postcode in the postcode parameter

Sheffield City Council

python collect_data.py SheffieldCityCouncil https://wasteservices.sheffield.gov.uk/property/XXXXXXXXXXX

Note: Follow the instructions here until you get the "Your bin collection dates and services" page then copy the URL and replace the URL in the command.

Shropshire Council

python collect_data.py ShropshireCouncil https://bins.shropshire.gov.uk/property/XXXXXXXXXXX

Note: Follow the instructions here until you get the page showing your bin collection dates then copy the URL and replace the URL in the command.

Solihull Council

python collect_data.py SolihullCouncil https://digital.solihull.gov.uk/BinCollectionCalendar/Calendar.aspx?UPRN=XXXXXXXX

Note: Replace XXXXXXXX with UPRN. You will need to use FindMyAddress to find the UPRN.

Somerset Council

python collect_data.py SomersetCouncil https://www.somerset.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

South Ayrshire Council

python collect_data.py SouthAyrshireCouncil https://www.south-ayrshire.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

South Cambridgeshire Council

python collect_data.py SouthCambridgeshireCouncil https://www.scambs.gov.uk/recycling-and-bins/find-your-household-bin-collection-day/ -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

South Gloucestershire Council

python collect_data.py SouthGloucestershireCouncil https://beta.southglos.gov.uk/waste-and-recycling-collection-date -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

South Lanarkshire Council

python collect_data.py SouthLanarkshireCouncil https://www.southlanarkshire.gov.uk/directory_record/XXXXX/XXXXX

Note: Follow the instructions here until you get the page that shows the weekly collections for your street then copy the URL and replace the URL in the command.

South Norfolk Council

python collect_data.py SouthNorfolkCouncil https://www.southnorfolkandbroadland.gov.uk/rubbish-recycling/south-norfolk-bin-collection-day-finder -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

South Oxfordshire Council

python collect_data.py SouthOxfordshireCouncil https://www.southoxon.gov.uk/south-oxfordshire-district-council/recycling-rubbish-and-waste/when-is-your-collection-day/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

South Tyneside Council

python collect_data.py SouthTynesideCouncil https://www.southtyneside.gov.uk/article/33352/Bin-collection-dates -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

St Helens Borough Council

python collect_data.py StHelensBC https://www.sthelens.gov.uk/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Staffordshire Moorlands District Council

python collect_data.py StaffordshireMoorlandsDistrictCouncil https://www.staffsmoorlands.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX" -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: To get the UPRN, you can use FindMyAddress

St Albans City and District Council

python collect_data.py StAlbansCityAndDistrictCouncil https://gis.stalbans.gov.uk/NoticeBoard9/VeoliaProxy.NoticeBoard.asmx/GetServicesByUprnAndNoticeBoard -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Stockport Borough Council

python collect_data.py StockportBoroughCouncil https://myaccount.stockport.gov.uk/bin-collections/show/XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Stoke-on-Trent City Council

python collect_data.py StokeOnTrentCityCouncil https://www.stoke.gov.uk/jadu/custom/webserviceLookUps/BarTecWebServices_missed_bin_calendar.php?UPRN=XXXXXXXXXX

Note: Replace XXXXXXXX with your property's UPRN.

Stratford Upon Avon Council

python collect_data.py StratfordUponAvonCouncil https://www.stratford.gov.uk/waste-recycling/when-we-collect.cfm/part/calendar -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Sunderland City Council

python collect_data.py SunderlandCityCouncil https://webapps.sunderland.gov.uk/WEBAPPS/WSS/Sunderland_Portal/Forms/bindaychecker.aspx -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: The postcode should be wrapped in double quotes and with a space in the middle. The house number doesn't need quotes.

Swale Borough Council

python collect_data.py SwaleBoroughCouncil https://swale.gov.uk/bins-littering-and-the-environment/bins/collection-days -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Tameside Metropolitan Borough Council

python collect_data.py TamesideMBCouncil http://lite.tameside.gov.uk/BinCollections/CollectionService.svc/GetBinCollection -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Tandridge District Council

python collect_data.py TandridgeDistrictCouncil https://tdcws01.tandridge.gov.uk/TDCWebAppsPublic/tfaBranded/408?utm_source=pressrelease&utm_medium=smposts&utm_campaign=check_my_bin_day -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Telford and Wrekin Co-operative Council

python collect_data.py TelfordAndWrekinCouncil https://dac.telford.gov.uk/bindayfinder/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Test Valley Borough Council

python collect_data.py TestValleyBoroughCouncil https://testvalley.gov.uk/wasteandrecycling/when-are-my-bins-collected -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Tonbridge and Malling Borough Council

python collect_data.py TonbridgeAndMallingBC https://www.tmbc.gov.uk/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Torbay Council

python collect_data.py TorbayCouncil https://www.torbay.gov.uk/recycling/bin-collections/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Torridge District Council

python collect_data.py TorridgeDistrictCouncil https://collections-torridge.azurewebsites.net/WebService2.asmx -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Vale of Glamorgan Council

python collect_data.py ValeofGlamorganCouncil https://www.valeofglamorgan.gov.uk/en/living/Recycling-and-Waste/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Vale of White Horse Council

python collect_data.py ValeofWhiteHorseCouncil https://eform.whitehorsedc.gov.uk/ebase/BINZONE_DESKTOP.eb -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Wakefield City Council

python collect_data.py WakefieldCityCouncil https://www.wakefield.gov.uk/where-i-live/?uprn=XXXXXXXXXXX&a=XXXXXXXXXXX&usrn=XXXXXXXXXXX&e=XXXXXXXXXXX&n=XXXXXXXXXXX&p=XXXXXXXXXXX -s -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Follow the instructions here until you get the page that includes a "Bin Collections" section then copy the URL and replace the URL in the command.

Warwick District Council

python collect_data.py WarwickDistrictCouncil https://estates7.warwickdc.gov.uk/PropertyPortal/Property/Recycling/XXXXXXXX

Note: Replace XXXXXXXX with UPRN.

Waverley Borough Council

python collect_data.py WaverleyBoroughCouncil https://wav-wrp.whitespacews.com/ -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Note: Follow the instructions here until you get the page that shows your next scheduled collections. Then take the number from pIndex=NUMBER in the URL and pass it as the -n parameter along with your postcode in -p.

Wealden District Council

python collect_data.py WealdenDistrictCouncil https://www.wealden.gov.uk/recycling-and-waste/bin-search/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN

Welhat Council

python collect_data.py WelhatCouncil https://www.welhat.gov.uk/xfp/form/214 -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

West Lindsey District Council

python collect_data.py WestLindseyDistrictCouncil https://www.west-lindsey.gov.uk/ -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Note: Pass the house name/number in the house number parameter, and postcode in the postcode parameter, both wrapped in double quotes. If a named house or flat, enter this in the number field. If multiple results return, we'll pick the first. You can test it here

West Lothian Council

python collect_data.py WestLothianCouncil https://www.westlothian.gov.uk/ -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number in the house number parameter, wrapped in double quotes

West Northamptonshire Council

python collect_data.py WestNorthamptonshireCouncil https://www.northampton.gov.uk/info/200084/bins-waste-and-recycling/1602/check-your-collection-day -s -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -p - postcode

West Suffolk Council

python collect_data.py WestSuffolkCouncil https://westsuffolk-self.achieveservice.com/service/WSS_EX_Inf_Bin_Collection_Postcode_Lookup -s -p "XXXX XXX" -n XX -w http://HOST:PORT/

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number
  • -w - remote Selenium web driver URL (required for Home Assistant)

Note: Pass the house name/number in the house number parameter, wrapped in double quotes and the postcode in the postcode parameter

Wigan Borough Council

python collect_data.py WiganBoroughCouncil https://apps.wigan.gov.uk/MyNeighbourhood/ -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Wiltshire Council

python collect_data.py WiltshireCouncil https://ilambassadorformsprod.azurewebsites.net/wastecollectiondays/index -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Windsor and Maidenhead Council

python collect_data.py WindsorAndMaidenheadCouncil https://my.rbwm.gov.uk/special/find-your-collection-dates -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Woking Borough Council/Joint Waste Solutions

python collect_data.py WokingBoroughCouncil https://asjwsw-wrpwokingmunicipal-live.whitespacews.com/ -s -p "XXXX XXX" -n XX

Additional parameters:

  • -s - skip get URL
  • -p - postcode
  • -n - house number

Note: Works with all collection areas that use Joint Waste Solutions. Just use the correct URL.

Wyre Council

python collect_data.py WyreCouncil https://www.wyre.gov.uk/bins-rubbish-recycling -s -u XXXXXXXX -p "XXXX XXX"

Additional parameters:

  • -s - skip get URL
  • -u - UPRN
  • -p - postcode

Note: To get the UPRN, you will need to use FindMyAddress.

Postcode should be put in double quotes with a space in the middle.

York Council

python collect_data.py YorkCouncil https://waste-api.york.gov.uk/api/Collections/GetBinCollectionDataForUprn/ -s -u XXXXXXXX

Additional parameters:

  • -s - skip get URL
  • -u - UPRN