UK Parliament Members Directory Scraper

Easily extract and export comprehensive directory listings of UK Members of Parliament (MPs) and Lords. This tool gathers names, political parties, constituencies, official roles, status details, and contact numbers smoothly and efficiently. You can export your clean datasets anytime into CSV, JSON, or Excel formats.

---

What It Does

• Directory Extraction: Pulls comprehensive member records with customizable filters for house, name, and membership status.
• Contact Inclusion: Automatically fetches and attaches available contact numbers, postcodes, and office details when requested.
• Flexible Runs: Run quick searches or schedule regular updates to keep your records fresh and accurate.

---

Use Cases

• Constituency Lists: Search by surname or filter to quickly export current House of Commons members.
• Lords Offices: Focus specifically on the House of Lords to gather parliamentary office details, phone numbers, and postal codes.
• CRM Maintenance: Set up scheduled runs to ensure your internal directories and contact lists stay current.
• Historical Research: Easily switch off the active filter to include former members who are no longer in office.

---

Input Configuration

Parameter	Type	Default	Description
mode	string	members	Choose between standard member extraction (members) or dedicated contact gathering (contacts).
name	string		Filter records by entering a specific name or keyword.
house	integer	1	Select the parliamentary house (1 for Commons, 2 for Lords).
isCurrentMember	boolean	true	Restrict results to active, current members only.
includeContacts	boolean	true	Attach available phone and address details to member records.
maxItems	integer	100	Set a limit on the total number of successful rows saved (hard cap of 1000).
timeoutSecs	integer	300	Stop the run after this many seconds.
requestTimeoutSecs	integer	30	Timeout limit per individual request.
proxyConfiguration	object	{"useApifyProxy": false}	Optional proxy settings.

Example Input

{
  "mode": "members",
  "name": "smith",
  "house": 1,
  "isCurrentMember": true,
  "includeContacts": true,
  "maxItems": 100,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": { "useApifyProxy": false }
}

---

Output Structure & Fields

Every record saved in the dataset provides a structured object containing the following key details:

Field	Type	Description
memberId	integer	Unique identifier for each individual record.
nameDisplayAs	string	The official display name of the member.
partyName	string	The political party affiliation.
constituency	string	The represented constituency or membership classification.
statusText	string	Current operational status description.
houseNumber	integer	Indicates whether the member belongs to the Commons (1) or Lords (2).
phone	string	Primary contact telephone number retrieved.
postcode	string	Primary postal code associated with the office.
scrapedAt	string	Timestamp of when the record was processed.

---

Performance & Reliability

• Smart Retries: Temporary connection interruptions or rate limits are handled automatically with built-in retry logic and intelligent backoff intervals.
• Duplicate Prevention: Automatically filters and drops duplicate member IDs to keep your dataset clean.
• Error Handling: If an individual record encounters an issue, it logs a clean error row while allowing the rest of the run to proceed smoothly.

---

Frequently Asked Questions

• How many records can I export in one run? The default limit is 100 items, with a maximum cap of 1,000 successful rows per execution.
• Can I export my data to Excel or CSV? Yes, you can easily download your final dataset in CSV, JSON, or Excel format directly from the platform.
• What do house numbers represent? House 1 corresponds to the House of Commons, and House 2 corresponds to the House of Lords.

---

Is Web Scraping Legal?

Collecting publicly accessible information is generally permissible, but how you utilize the data matters:

• Personal Data: Depending on your jurisdiction (such as GDPR in Europe or CCPA in California), regulations may govern how you store and process personal information like names and contact details. Ensure you have a valid purpose and legal basis for collection.
• Copyright & Content: Respect intellectual property rights and avoid republishing protected materials without proper authorization.
• Terms & Guidelines: Always follow best practices, respect rate guidelines, and adhere to appropriate attribution requirements.
• Legal Guidance: This overview is for informational purposes and does not constitute legal counsel. Consult a qualified professional if you have specific legal questions.