# UK Parliament Members Scraper (MPs & Lords) (`parseforge/members-uk-parliament-scraper`) Actor Scrape UK House of Commons MPs and House of Lords peers from the official UK Parliament Members directory. Filter by House, party, gender, constituency or current/former status. Returns names, parties, constituencies, contact details, biographies, government posts and committee memberships. - **URL**: https://apify.com/parseforge/members-uk-parliament-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Business, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $23.25 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/main/banners/banner-default.jpg?raw=true) ## ๐Ÿ›๏ธ UK Parliament Members Scraper (MPs & Lords) > ๐Ÿš€ **Export the UK Parliament directory in seconds.** Pull every **MP in the House of Commons and every peer in the House of Lords**, with biographies, parties, constituencies, contact details, government posts, and committee memberships. No sign-up, no manual stitching, no parser to maintain. > ๐Ÿ•’ **Last updated:** 2026-05-15 ยท **๐Ÿ“Š 31 fields** per record ยท **๐Ÿ›๏ธ 1,450+ current members** ยท **๐Ÿ‡ฌ๐Ÿ‡ง Both Houses** ยท **๐Ÿ“œ Historic + current** The **UK Parliament Members Scraper** queries the official UK Parliament Members directory and returns up to **31 structured fields per record**, including the canonical display name and full title, party affiliation with party colour, House of Commons constituency, House of Lords seat type, government and opposition posts, committee memberships, parliamentary contact address, phone, email, websites, and social-media handles. The directory covers **every currently sitting MP and peer plus every former member** going back through the modern era, across all parties from Labour, Conservative, Liberal Democrat, SNP, Reform UK, Sinn Fรฉin, the Lords Spiritual, Crossbench, and beyond. This Actor makes that data downloadable as CSV, Excel, JSON, or XML in under five minutes. Filters run server-side, so you skip the parser engineering entirely. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Public-affairs and government-relations teams, journalists and political researchers, lobbyists, NGOs, civic-tech projects, academic political scientists, CRM enrichment platforms | Stakeholder mapping, MP and peer outreach lists, constituency contact, committee tracking, voting-record context, party-composition analysis, lobbyist registers | --- ### ๐Ÿ“‹ What the UK Parliament Members Scraper does Six filtering workflows in a single run: - ๐Ÿ›๏ธ **House filter.** Restrict to Commons (MPs), Lords (peers), or both chambers. - ๐ŸŽ—๏ธ **Party filter.** Pick a single party from a curated list of every active and historic UK political party. - ๐Ÿ‘ค **Gender filter.** Male, female, or all. - ๐Ÿ“ **Constituency substring.** Match Commons members whose constituency name contains a substring (e.g. "London", "Glasgow"). - ๐Ÿšฆ **Current vs former.** Currently sitting members, former members only, or all (current + former). - ๐Ÿ”Ž **Name substring.** Match the display name on a case-insensitive substring. Each record includes the member ID, official photo URL, public profile URL, four name variants (display, full title, list-as, address-as), gender, House, party (name, abbreviation, ID, official party colour), constituency and constituency ID, membership start and end dates, current-member flag, full constituency history, every government post and opposition post with dates and department, committee memberships, parliamentary contact phone numbers, emails, websites, X / Facebook / Instagram links, and the canonical House of Commons / House of Lords address with postcode. > ๐Ÿ’ก **Why it matters:** structured Parliament member data drives stakeholder mapping, public-affairs CRM enrichment, and political-research dashboards. Building your own pipeline means writing a paginated client, fetching three sub-resources per member, normalising contact channels, and refreshing daily. This Actor skips all of that and gives you a clean refreshed snapshot on every run. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded MP and Lords dataset._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
namestring""Substring match on the member's display name.
housestring""One of: empty (both), Commons, Lords.
partystring""One of 20+ parties (Labour, Conservative, Liberal Democrat, SNP, Reform UK, Crossbench, Bishops, and more).
genderstring""Empty (all), M, or F.
membershipStatusstring"current"Currently sitting, former, or all (current + former).
constituencystring""Substring match on the Commons constituency name (ignored for Lords).
fetchDetailsbooleantrueWhen enabled, pulls biography (committees, posts, representations) and contact details per member.
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
**Example: every currently sitting Labour MP with full biography and contact.** ```json { "maxItems": 500, "house": "Commons", "party": "Labour", "membershipStatus": "current", "fetchDetails": true } ```` **Example: female peers in the House of Lords.** ```json { "maxItems": 200, "house": "Lords", "gender": "F", "membershipStatus": "current" } ``` > โš ๏ธ **Good to Know:** with `fetchDetails: true` (default) the Actor makes additional lookups per member to gather biography and contact records. That's the canonical experience but it's slower than a names-only pull. Set `fetchDetails: false` for a quick directory listing. *** ### ๐Ÿ“Š Output Each member record carries up to **31 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ†” `id` | number | `172` | | ๐Ÿ–ผ๏ธ `imageUrl` | string | `"https://members-api.parliament.uk/api/Members/172/Thumbnail"` | | ๐Ÿ”— `profileUrl` | string | `"https://members.parliament.uk/member/172"` | | ๐Ÿ“Œ `nameDisplayAs` | string | `"Ms Diane Abbott"` | | ๐Ÿ“Œ `nameFullTitle` | string | `"Rt Hon Diane Abbott MP"` | | ๐Ÿ“Œ `nameListAs` | string | `"Abbott, Ms Diane"` | | ๐Ÿ“Œ `nameAddressAs` | string | `"Ms Abbott"` | | ๐Ÿ‘ค `gender` | string | `"F"` | | ๐Ÿ›๏ธ `house` | string | `"Commons"` | | ๐Ÿ“ `constituency` | string | null | `"Hackney North and Stoke Newington"` | | ๐Ÿ†” `constituencyId` | number | null | `4074` | | ๐Ÿ“… `membershipStartDate` | ISO 8601 | `"1987-06-11T00:00:00"` | | ๐Ÿ“… `membershipEndDate` | ISO 8601 | null | `null` | | ๐Ÿ“ `membershipEndReason` | string | null | `null` | | ๐Ÿšฆ `isCurrentMember` | boolean | `true` | | ๐Ÿ“ `membershipStatusDescription` | string | `"Current Member"` | | ๐Ÿ›๏ธ `partyName` | string | `"Independent"` | | ๐Ÿท๏ธ `partyAbbreviation` | string | `"Ind"` | | ๐Ÿ†” `partyId` | number | `8` | | ๐ŸŽจ `partyColor` | string | `"#909090"` | | ๐Ÿ“œ `constituencyHistory` | array | `[{house, constituency, startDate, endDate, note}]` | | ๐Ÿ’ผ `governmentPosts` | array | `[{name, startDate, endDate, department}]` | | ๐Ÿ’ผ `oppositionPosts` | array | `[{name, startDate, endDate, department}]` | | ๐Ÿ’ผ `committeeMemberships` | array | `[{name, startDate, endDate}]` | | ๐Ÿ“ž `phoneNumbers` | array | `["020 7219 4426"]` | | ๐Ÿ“ง `emails` | array | `["diane.abbott.office@parliament.uk"]` | | ๐Ÿ”— `websites` | array | `["http://www.dianeabbott.org.uk"]` | | ๐Ÿ”— `socialLinks` | array | `[{type: "X", url: "https://twitter.com/HackneyAbbott"}]` | | ๐Ÿ  `parliamentaryAddress` | string | `"House of Commons, London"` | | ๐Ÿ“ฎ `parliamentaryPostcode` | string | `"SW1A 0AA"` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-05-15T18:33:41.998Z"` | #### ๐Ÿ“ฆ Sample record
๐Ÿ›๏ธ Sitting MP: Diane Abbott (Hackney North & Stoke Newington) ```json { "id": 172, "imageUrl": "https://members-api.parliament.uk/api/Members/172/Thumbnail", "profileUrl": "https://members.parliament.uk/member/172", "nameDisplayAs": "Ms Diane Abbott", "nameFullTitle": "Rt Hon Diane Abbott MP", "nameListAs": "Abbott, Ms Diane", "nameAddressAs": "Ms Abbott", "gender": "F", "house": "Commons", "constituency": "Hackney North and Stoke Newington", "constituencyId": 4074, "membershipStartDate": "1987-06-11T00:00:00", "isCurrentMember": true, "membershipStatusDescription": "Current Member", "partyName": "Independent", "partyAbbreviation": "Ind", "partyId": 8, "partyColor": "#909090", "constituencyHistory": [ {"house": "Commons", "constituency": "Hackney North and Stoke Newington", "startDate": "2024-07-04T00:00:00", "note": "Elected 1 time"}, {"house": "Commons", "constituency": "Hackney North and Stoke Newington", "startDate": "2010-05-06T00:00:00", "endDate": "2024-05-30T00:00:00", "note": "Elected 4 times"} ], "oppositionPosts": [ {"name": "Shadow Home Secretary", "startDate": "2016-10-06T00:00:00", "endDate": "2020-04-05T00:00:00", "department": "Home Office"} ], "committeeMemberships": [ {"name": "Home Affairs Committee", "startDate": "2020-05-11T00:00:00", "endDate": "2024-05-30T00:01:00"} ], "phoneNumbers": ["020 7219 4426"], "emails": ["diane.abbott.office@parliament.uk"], "websites": ["http://www.dianeabbott.org.uk"], "socialLinks": [{"type": "X", "url": "https://twitter.com/HackneyAbbott"}], "parliamentaryAddress": "House of Commons, London", "parliamentaryPostcode": "SW1A 0AA", "scrapedAt": "2026-05-15T18:33:41.998Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿ›๏ธ | **Both Houses.** 1,450+ current MPs and Lords plus historic former members in a single run. | | ๐ŸŽฏ | **Multi-dimensional filters.** House, party, gender, constituency, current / former, and name combine freely. | | ๐Ÿ’ผ | **Career history included.** Government posts, opposition posts, committee memberships, and constituency history per member. | | ๐Ÿ“ž | **Contact-ready.** Parliamentary address, phone, email, websites, and X / Facebook / Instagram per record. | | โšก | **Fast.** 100 members in seconds, full directory in a few minutes. | | ๐Ÿ” | **Always fresh.** Every run hits the official directory, so the dataset reflects current members. | | ๐Ÿšซ | **No authentication.** Public open-government data. No login needed. | > ๐Ÿ“Š Structured Parliament member data sits at the heart of every public-affairs CRM, lobbyist register, and political-research dashboard in the UK. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ UK Parliament Members Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **1,450+ current + historic** | **Live per run** | house, party, gender, constituency, status, name | โšก 2 min | | Commercial public-affairs platforms | $15k - $80k/year | Comparable + voting records | Daily | Many | ๐Ÿข Weeks (procurement) | | TheyWorkForYou scraping | Free | Limited fields | Daily | Few | ๐Ÿ•’ Days | | Manual copy-paste from members.parliament.uk | Free | Whole directory | Live | Site-side | โณ Forever | Pick this Actor when you want a structured, contact-ready directory of every UK parliamentarian without writing a parser. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the UK Parliament Members Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set input.** Pick a House, a party, a gender, a constituency substring, and set `maxItems`. Toggle `fetchDetails` for full biography + contact. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your dataset. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to a downloaded MPs / Lords dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ›๏ธ Public Affairs & Lobbying - Stakeholder mapping for policy campaigns - Outreach lists by party, House, or committee - Refresh CRM contact records each session - Track Cabinet and Shadow Cabinet posts in real time #### ๐Ÿ“ฐ Political Journalism & Research - Build party-composition snapshots after elections - Track committee membership changes by session - Cross-join with Hansard transcripts for speech analysis - Power explainer dashboards on cabinet reshuffles
#### ๐ŸŽฏ Constituency Targeting - Map MPs to constituencies for civic-tech tools - Build "Find your MP" widgets with structured contact info - Surface party-coloured visuals in dashboards - Power email-your-MP workflows for campaign sites #### ๐Ÿ“Š Civic Analytics & NGOs - Diversity reporting by gender, party, and House - Tenure analysis across constituency histories - Committee participation patterns over decades - Open-data dashboards for civic-tech communities
*** ### ๐Ÿ”Œ Automating UK Parliament Members Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Daily refreshes keep your stakeholder map and CRM in sync automatically. *** ### ๐ŸŒŸ Beyond business use cases Open Parliament data powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Quantitative studies of parliamentary careers and turnover - Politics coursework on party composition over time - Reproducible datasets for representation and diversity research - Historical archives of constituency boundary changes #### ๐ŸŽจ Personal and creative - Side projects mapping MPs to constituencies on a UK map - Personal newsletters that profile newly elected members - Visualisations of party colours in the Commons chamber - Data-art pieces on the demographics of Parliament
#### ๐Ÿค Non-profit and civic - Civic-tech tools that connect citizens with their MP - Watchdog dashboards tracking ministerial appointments - Investigative journalism on committee compositions - Accessibility projects that present member data clearly #### ๐Ÿงช Experimentation - Train named-entity models with UK political figures - Build agent pipelines that summarise career histories - Prototype recommender systems for civic engagement - Stress-test contact-form workflows with real member data
*** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20UK%20Parliament%20Members%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20UK%20Parliament%20Members%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20UK%20Parliament%20Members%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20UK%20Parliament%20Members%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Pick a House, party, gender, or constituency substring, click Start, and the Actor pages through the official Parliament directory, optionally fetches biography and contact records per member, and emits a clean structured row. No browser automation, no captchas, no setup. #### ๐Ÿ“ How accurate is the data? Every record comes from the official UK Parliament Members directory used by members.parliament.uk itself, so names, parties, constituencies, posts, and contact channels match what you see on the page. #### ๐Ÿ” How often is the dataset refreshed? The directory is updated continuously as elections, by-elections, peerage creations, ministerial reshuffles, and resignations take place. Every run hits the live directory. #### ๐Ÿ›๏ธ Does it include both MPs and Lords? Yes. Leave the `house` filter empty to return both Houses, or set it to `Commons` for MPs only and `Lords` for peers only. #### ๐Ÿ’ผ Are committees and government posts included? Yes. Set `fetchDetails: true` (default) and each record will include constituency history, government posts, opposition posts, and committee memberships with dates and departments. #### ๐Ÿ“ž Are contact details included? Yes. Parliamentary address, postcode, phone numbers, emails, websites, and X / Facebook / Instagram links are emitted when present. Some members opt out of publishing certain channels, in which case those fields are omitted. #### ๐Ÿ•ฐ๏ธ Can I get former members? Yes. Set `membershipStatus` to `former` for former members only or `all` for current + former. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor on any cron interval (daily, weekly) and keep your CRM stakeholder map in sync. #### โš–๏ธ Is this data legal to use? UK Parliament publishes member directory data under the Open Parliament Licence, which permits commercial reuse with attribution. Review the licence terms for your specific application. #### ๐Ÿ’ผ Can I use this data commercially? Yes. The Open Parliament Licence explicitly allows commercial reuse with attribution. You remain responsible for following the licence in your product. #### ๐Ÿ’ณ Do I need a paid Apify plan to use this Actor? No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you scheduling, higher concurrency, and larger datasets. #### ๐Ÿ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### ๐Ÿ”Œ Integrate with any app UK Parliament Members Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step stakeholder workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get reshuffle alerts in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe member data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh member records into your CRM, or alert your public-affairs team in Slack. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ—ฃ๏ธ Hansard UK Parliament Debates Scraper**](https://apify.com/parseforge/hansard-uk-debates-scraper) - Full transcripts of Commons and Lords debates - [**๐Ÿ‡ฌ๐Ÿ‡ง GOV.UK Content Search Scraper**](https://apify.com/parseforge/govuk-content-search-scraper) - Search the entire UK government publications catalogue - [**๐Ÿ›ก๏ธ OpenSanctions Sanctions & PEP Scraper**](https://apify.com/parseforge/opensanctions-entities-scraper) - Sanctioned entities and politically exposed persons - [**โšก Carbon Intensity UK Scraper**](https://apify.com/parseforge/carbon-intensity-uk-scraper) - National Grid carbon intensity feed - [**๐Ÿ›๏ธ Florida Sunbiz Business Registry Scraper**](https://apify.com/parseforge/sunbiz-florida-business-scraper) - Florida corporate registry records > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the UK Parliament, the House of Commons, or the House of Lords. All trademarks mentioned are the property of their respective owners. Only publicly available open Parliament data is collected, under the Open Parliament Licence. # Actor input Schema ## `name` (type: `string`): Substring match on the member's display name. Leave empty to browse all members. ## `house` (type: `string`): Restrict to one chamber. Default returns both. ## `party` (type: `string`): Restrict to a single party. ## `gender` (type: `string`): Filter by recorded gender. ## `membershipStatus` (type: `string`): Filter to currently sitting members, former members, or include both. Defaults to 'all' so historical members are included. ## `constituency` (type: `string`): Substring match on the Commons constituency name (ignored for Lords). ## `fetchDetails` (type: `boolean`): When enabled, makes an extra request per member to retrieve biography (committees, posts, representations) and contact details. Slower but much richer output. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "name": "", "house": "", "party": "", "gender": "", "membershipStatus": "all", "constituency": "", "fetchDetails": true, "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): Overview of scraped data ## `fullData` (type: `string`): Complete dataset # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "name": "", "constituency": "", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/members-uk-parliament-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "name": "", "constituency": "", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/members-uk-parliament-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "name": "", "constituency": "", "maxItems": 10 }' | apify call parseforge/members-uk-parliament-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/members-uk-parliament-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Parliament Members Scraper (MPs & Lords)", "description": "Scrape UK House of Commons MPs and House of Lords peers from the official UK Parliament Members directory. Filter by House, party, gender, constituency or current/former status. Returns names, parties, constituencies, contact details, biographies, government posts and committee memberships.", "version": "0.0", "x-build-id": "GTCqbuFycBDbjGa0F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~members-uk-parliament-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-members-uk-parliament-scraper", "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/parseforge~members-uk-parliament-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-members-uk-parliament-scraper", "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/parseforge~members-uk-parliament-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-members-uk-parliament-scraper", "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": { "name": { "title": "Name Filter", "type": "string", "description": "Substring match on the member's display name. Leave empty to browse all members.", "default": "" }, "house": { "title": "House", "enum": [ "", "Commons", "Lords" ], "type": "string", "description": "Restrict to one chamber. Default returns both.", "default": "" }, "party": { "title": "Party", "enum": [ "", "Alliance", "Conservative", "Democratic Unionist Party", "Green Party", "Independent", "Labour", "Labour (Co-op)", "Liberal Democrat", "Plaid Cymru", "Reform UK", "Scottish National Party", "Sinn Fein", "Social Democratic & Labour Party", "Speaker", "Traditional Unionist Voice", "UK Independence Party", "Bishops", "Crossbench", "Lord Speaker", "Non-affiliated" ], "type": "string", "description": "Restrict to a single party.", "default": "" }, "gender": { "title": "Gender", "enum": [ "", "M", "F" ], "type": "string", "description": "Filter by recorded gender.", "default": "" }, "membershipStatus": { "title": "Current or Former", "enum": [ "all", "current", "former" ], "type": "string", "description": "Filter to currently sitting members, former members, or include both. Defaults to 'all' so historical members are included.", "default": "all" }, "constituency": { "title": "Constituency Substring (Commons only)", "type": "string", "description": "Substring match on the Commons constituency name (ignored for Lords).", "default": "" }, "fetchDetails": { "title": "Fetch Detailed Profile", "type": "boolean", "description": "When enabled, makes an extra request per member to retrieve biography (committees, posts, representations) and contact details. Slower but much richer output.", "default": true }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } }, "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 } } } } } } } } } } ```