# UK Charity Commission Scraper: Trustees, Emails & Finances (`scrapers_lat/uk-charity-commission-scraper`) Actor

Scrape the UK register of charities: charity name and number, email, phone, website and address, every trustee with role and other trusteeships, five years of exact income, expenditure, assets and liabilities, staff and volunteer counts, salary bands and accounts. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/uk-charity-commission-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![UK Charity Commission Scraper: Trustees, Emails & Finances](https://scrapers.lat/banners/uk-charity-commission-scraper.png)](https://console.apify.com/actors/6qSi2edPeMJdLaV2D/input)

## UK Charity Commission Scraper: Trustees, Emails & Finances

Here is one real result, trimmed only where a list repeats:

```json
{
  "charityNumber": "1143528",
  "charityName": "NORWICH FOOD BANK",
  "otherNames": [{ "name": "NORWICH FOODBANK", "type": "Working name" }],
  "status": "Registered",
  "reportingStatus": "Charity reporting is up to date (on time)",
  "registeredOn": "24 August 2011",
  "registrationHistory": [
    { "date": "24 August 2011", "event": "Standard registration" },
    { "date": "23 September 2025", "event": "Funds received from 1200742 AUTHENTIC CHURCH" }
  ],
  "organisationType": "Charitable company",
  "companyNumber": "07051996",
  "companiesHouseUrl": "https://beta.companieshouse.gov.uk/company/07051996",
  "giftAid": "Recognised by HMRC for gift aid",
  "policies": ["Complaints handling", "Safeguarding policy and procedures", "Paying staff"],
  "landAndProperty": "This charity does not own and/or lease land or property",
  "address": "Norwich foodbank, Henderson Trust, 51 Ivy Road, NORWICH, NR5 8BF",
  "postcode": "NR5 8BF",
  "phone": "01603251733",
  "email": "admin@norwich.foodbank.org.uk",
  "website": "https://norwich.foodbank.org.uk/",
  "activities": "The principle activity will be the collection of non perishable food by public donation at supermarkets, from churches and elsewhere...",
  "whatCharityDoes": ["The Advancement Of Health Or Saving Of Lives", "The Prevention Or Relief Of Poverty"],
  "whoCharityHelps": ["The General Public/mankind"],
  "howCharityHelps": ["Other Charitable Activities"],
  "whereCharityOperates": ["Norfolk"],
  "grantMaker": false,
  "charitableObjects": "TO RELIEVE PERSONS IN THE UNITED KINGDOM AND ELSEWHERE IN THE WORLD WHO ARE IN CONDITIONS OF NEED, HARDSHIP OR DISTRESS...",
  "governingDocument": "MEMORANDUM AND ARTICLES INCORPORATED 21/10/2009",
  "trusteeCount": 7,
  "employeeCount": 5,
  "volunteerCount": 180,
  "trustees": [
    {
      "name": "KEIR ROBERT HOUNSOME",
      "role": "Chair",
      "appointedOn": "21 January 2015",
      "otherTrusteeships": [
        { "charityName": "ST PETER'S JESSOPP ROAD, (U.R.C./METHODIST) CHURCH", "reportingStatus": "Recently registered" }
      ]
    },
    { "name": "Rebecca Joyce Paraschivu", "role": "Trustee", "appointedOn": "21 September 2023", "otherTrusteeships": null }
  ],
  "employeeBenefitBands": null,
  "trusteePayments": "No trustees receive any remuneration, payments or benefits from the charity.",
  "trading": "This charity does not have any trading subsidiaries.",
  "fundraising": "No information available",
  "latestFinancialYearEnd": "31 October 2024",
  "totalIncome": 771638,
  "totalExpenditure": 669648,
  "incomeBreakdown": { "donationsAndLegacies": 747774, "charitableActivities": 0, "otherTradingActivities": 0, "investments": 23864, "other": 0 },
  "expenditureBreakdown": { "raisingFunds": 0, "charitableActivities": 669648, "other": 0 },
  "financialHistory": [
    { "periodEnd": "31/10/2022", "totalIncome": 600958, "totalExpenditure": 427264, "incomeGovernmentGrants": 26000, "incomeDonationsAndLegacies": 600694, "incomeInvestment": 264, "expenditureCharitableActivities": 427264, "expenditureGovernance": 6537 },
    { "periodEnd": "31/10/2024", "totalIncome": 771638, "totalExpenditure": 669648, "incomeDonationsAndLegacies": 747774, "incomeInvestment": 23864, "expenditureCharitableActivities": 669648 }
  ],
  "assetsAndLiabilities": [
    { "periodEnd": "31/10/2024", "ownUseAssets": 0, "longTermInvestments": 0, "otherAssets": 647846, "pensionSchemeAssetOrLiability": 0, "totalLiabilities": 51519 }
  ],
  "accounts": [
    { "documentType": "Annual return", "reportingYear": "31 October 2024", "dateReceived": "22 August 2025", "receivedStatus": "On time", "documentUrl": null },
    { "documentType": "Accounts and TAR", "reportingYear": "31 October 2024", "dateReceived": "22 August 2025", "receivedStatus": "On time", "documentUrl": "https://register-of-charities.charitycommission.gov.uk/..." }
  ],
  "linkedCharities": null,
  "observedAt": "2026-08-15T21:24:55.224Z",
  "error": null
}
```

The most complete scraper of the register of charities for England and Wales. Every charity comes back with its published email, phone, website and address, the full trustee board with roles, appointment dates and each trustee's other charities, five years of income, expenditure, assets and liabilities to the exact pound, staff, volunteer and salary-band counts, and the filing history with links to the filed accounts. You can filter on income, spending, purpose, beneficiary group, council area, country of operation, grant makers, overdue filings and registration or removal dates, then keep only the charities that publish an email.

**📥 [Input](https://apify.com/scrapers_lat/uk-charity-commission-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/uk-charity-commission-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/uk-charity-commission-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/uk-charity-commission-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-England%20%26%20Wales-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example recipes](#example-recipes)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor searches the public register of charities for England and Wales, applies your filters, and writes one normalized record per charity to the run's dataset. Around 172,000 charities are currently registered and a further 186,000 removed ones remain searchable.

Each record covers everything the register publishes about a charity in one row:

- **Contact block** for outreach: email, phone, website, full postal address and postcode.
- **People**: every trustee with role, appointment date and the other charities they are a trustee of, plus trustee, employee and volunteer counts and the number of staff in each salary band above £60k.
- **Money**: latest total income and expenditure, the income and expenditure split by source, income from government contracts and grants, and a five-year history of income, expenditure, assets, long-term investments, pension scheme position and total liabilities. Figures are exact pound values, not the rounded ones shown on screen.
- **Governance and identity**: registration and removal dates with reasons, organisation type, Companies House number and link, working and former names, gift aid recognition, other regulators, declared policies, land and property, governing document and charitable objects.
- **Filings**: annual returns and accounts for the last five periods with the date received, whether they were on time or late, and a download link to the filed accounts.
- **Classification**: what the charity does, who it helps, how it helps, where it operates, and whether it is primarily a grant maker.

Values the register does not publish for a charity are returned as `null`, and financial years the charity never reported are `null` rather than zero.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns 12 food bank charities with an income of £50k or more that publish an email address.

```json
{
  "searchTerm": "food bank",
  "searchIn": ["charityName"],
  "incomeMin": 50000,
  "withEmailOnly": true,
  "maxResults": 12
}
```

Leave `searchTerm` empty to sweep the whole register by filters alone. All filters combine with logical AND.

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `searchTerm` | string | no | (empty) | Free-text search across charity name, number, area of operation, classification and charitable objects. Several words match as "any word". |
| `searchIn` | enum\[] | no | (all) | Narrow where the search term is matched: `charityNumber`, `charityName`, `whereItOperates`, `classifications`, `objectsAndActivities`. Use `charityName` alone for a clean name search. |
| `charityNumbers` | string\[] | no | (empty) | Exact registered charity numbers to fetch, for example `1089464`. When given, the search filters are ignored. |
| `status` | enum | no | `registered` | `registered`, `removed`, or `all`. Removed charities carry the removal date and reason. |
| `incomeMin` / `incomeMax` | integer | no | (any) | Latest reported gross income range in £. |
| `expenditureMin` / `expenditureMax` | integer | no | (any) | Latest reported total expenditure range in £. |
| `localAuthorities` | string\[] | no | (any) | Council areas the charity works in, for example `Camden`, `Birmingham City`, `Cardiff`. London boroughs and Welsh councils are routed automatically. |
| `operatesNationally` | enum\[] | no | (any) | `Throughout England And Wales`, `Throughout England`, `Throughout London`, `Throughout Wales`. |
| `countriesOfOperation` | string\[] | no | (any) | Overseas countries the charity works in, for example `Kenya`, `Ukraine`, `India`. |
| `whatCharityDoes` | enum\[] | no | (any) | Purpose classification, for example `102:Education/training`, `111:Animals`, `105:The Prevention Or Relief Of Poverty`. |
| `whoCharityHelps` | enum\[] | no | (any) | Beneficiary group, for example `201:Children/young People`, `202:Elderly/old People`. |
| `howCharityHelps` | enum\[] | no | (any) | Delivery method, for example `302:Makes Grants To Organisations`, `308:Sponsors Or Undertakes Research`. |
| `grantMakersOnly` | boolean | no | `false` | Only charities whose main way of carrying out their purposes is grant making. |
| `employeeBenefitBands` | enum\[] | no | (any) | Only charities reporting at least one employee in the chosen total-benefits band, from `band_60001_70000` to `band_over_500000`. |
| `registeredFrom` / `registeredTo` | string | no | (any) | Registration date range, `DD/MM/YYYY` or `YYYY-MM-DD`. Newly registered charities are the freshest leads. |
| `removedFrom` / `removedTo` | string | no | (any) | Removal date range, `DD/MM/YYYY` or `YYYY-MM-DD`. |
| `documentsOverdueOnly` | boolean | no | `false` | Only charities whose annual return or accounts are overdue. |
| `includeLinkedCharities` | boolean | no | `false` | Include subsidiary charities linked to a main registration. |
| `withEmailOnly` | boolean | no | `false` | Skip charities that publish no email. Skipped records are never returned or charged for. |
| `withPhoneOnly` | boolean | no | `false` | Skip charities that publish no phone number. |
| `withWebsiteOnly` | boolean | no | `false` | Skip charities that publish no website. |
| `fullDetails` | boolean | no | `true` | On: every field. Off: only the summary row (name, number, status, headline income), which is much faster for very large sweeps. |
| `maxResults` | integer | no | `50` | Maximum number of charity records to return. |
| `proxyConfiguration` | object | no | (none) | Standard Apify proxy configuration. Not required. |

### Output reference

One dataset item per charity. Types: `string`, `integer`, `boolean`, `string[]`, `object[]`, or `null` when the register publishes no value.

| Field | Type | Description |
|---|---|---|
| `charityNumber` | string | Registered charity number. |
| `charityName` | string | Registered charity name. |
| `otherNames` | object\[] | Working and previous names: `name`, `type`. |
| `status` | string | `Registered` or `Removed`. |
| `reportingStatus` | string | Whether the charity's reporting is up to date, late or overdue. |
| `registeredOn` | string | Date of registration. |
| `removedOn` | string | Date removed from the register, else `null`. |
| `removalReason` | string | Why the charity was removed, for example `Removed (Ceased to exist)`. |
| `registrationHistory` | object\[] | Every registration event with `date` and `event`, including funds received from or transferred to other charities. |
| `organisationType` | string | For example `Charitable company`, `CIO`, `Trust`, `Other`. |
| `companyNumber` | string | Companies House number when the charity is incorporated, else `null`. |
| `companiesHouseUrl` | string | Link to the Companies House record. |
| `giftAid` | string | HMRC gift aid recognition status. |
| `otherRegulators` | string\[] | Other regulators the charity answers to, for example Ofsted or the Care Quality Commission. |
| `policies` | string\[] | Policies the charity declares, for example safeguarding, paying staff, conflicts of interest. |
| `landAndProperty` | string | Whether the charity owns or leases land or property. |
| `email` | string | Published contact email. |
| `phone` | string | Published contact phone. |
| `website` | string | Published website. |
| `websiteUrl` | string | Website as a full URL. |
| `address` | string | Full address on one line. |
| `addressLines` | string\[] | Address split into its lines. |
| `postcode` | string | Postcode. |
| `activities` | string | The charity's own description of how it spends its money. |
| `charitableObjects` | string | Charitable objects from the governing document. |
| `governingDocument` | string | Type and date of the governing document with amendments. |
| `areaOfBenefit` | string | Area the charity may operate in per its governing document. |
| `whatCharityDoes` | string\[] | Purpose classifications. |
| `whoCharityHelps` | string\[] | Beneficiary groups. |
| `howCharityHelps` | string\[] | Delivery methods. |
| `whereCharityOperates` | string\[] | Council areas, nations and overseas countries of operation. |
| `grantMaker` | boolean | `true` when grant making is the main way it carries out its purposes. |
| `trusteeCount` | integer | Number of trustees. |
| `employeeCount` | integer | Number of employees reported. |
| `volunteerCount` | integer | Number of volunteers reported. |
| `trustees` | object\[] | Per trustee: `name`, `role`, `appointedOn`, and `otherTrusteeships` with the other charity's name, register link and reporting status. |
| `employeeBenefitBands` | object\[] | Staff paid over £60k: `band`, `employees`. |
| `trusteePayments` | string | Whether trustees receive payments or benefits. |
| `trading` | string | Trading subsidiary position. |
| `fundraising` | string | Declared fundraising arrangements. |
| `latestFinancialYearEnd` | string | Financial year end of the latest reported figures. |
| `totalIncome` | integer | Latest total gross income in £. |
| `totalExpenditure` | integer | Latest total expenditure in £. |
| `investmentGains` | integer | Investment gains or losses in £. |
| `governmentContractsIncome` | integer | Income from government contracts in £. |
| `governmentContractsCount` | integer | Number of government contracts. |
| `governmentGrantsIncome` | integer | Income from government grants in £. |
| `governmentGrantsCount` | integer | Number of government grants. |
| `incomeBreakdown` | object | Latest income split: `donationsAndLegacies`, `charitableActivities`, `otherTradingActivities`, `investments`, `other`. |
| `expenditureBreakdown` | object | Latest expenditure split: `raisingFunds`, `charitableActivities`, `other`. |
| `financialHistory` | object\[] | Up to five financial periods, each with `periodEnd`, totals and the full income and expenditure line detail including legacies, endowments, governance costs and grants to institutions. |
| `assetsAndLiabilities` | object\[] | Per period: `ownUseAssets`, `longTermInvestments`, `otherAssets`, `pensionSchemeAssetOrLiability`, `totalLiabilities`. |
| `accounts` | object\[] | Filing record per document: `documentType`, `reportingYear`, `dateReceived`, `receivedStatus` (on time or days late), `documentUrl`. |
| `latestAccountsUrl` | string | Direct link to the most recent filed accounts. |
| `linkedCharities` | object\[] | Subsidiary charities linked to this registration. |
| `organisationNumber` | string | The register's own record id for the charity. |
| `registerUrl` | string | Link to the charity's page on the register. |
| `observedAt` | string | ISO 8601 timestamp of when the record was collected. |
| `error` | string | `null` on success. On a failed run, a single item with a populated `error` field is written instead. |

### Example recipes

**Fundraising prospect list: grant makers with real budgets**

```json
{ "grantMakersOnly": true, "incomeMin": 1000000, "withEmailOnly": true, "maxResults": 500 }
```

**Charities working in a country you operate in**

```json
{ "countriesOfOperation": ["Kenya"], "whatCharityDoes": ["102:Education/training"], "incomeMin": 250000, "maxResults": 300 }
```

**Local outreach in one council area**

```json
{ "localAuthorities": ["Camden"], "withEmailOnly": true, "incomeMin": 25000, "maxResults": 400 }
```

**Newly registered charities, the freshest leads**

```json
{ "registeredFrom": "01/01/2026", "withEmailOnly": true, "maxResults": 1000 }
```

**Compliance and risk: charities with overdue filings**

```json
{ "documentsOverdueOnly": true, "incomeMin": 500000, "maxResults": 500 }
```

**Employers: charities paying senior salaries**

```json
{ "employeeBenefitBands": ["band_100001_110000", "band_150001_200000"], "maxResults": 300 }
```

### Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace `<TOKEN>` with your Apify API token.

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~uk-charity-commission-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm":"hospice","searchIn":["charityName"],"incomeMin":500000,"maxResults":50}'
```

Start a run asynchronously:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~uk-charity-commission-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"grantMakersOnly":true,"incomeMin":1000000,"maxResults":500}'
```

Apify CLI:

```bash
apify call scrapers_lat/uk-charity-commission-scraper \
  --input '{"charityNumbers":["1089464","202918"]}'
```

### Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`:

```bash
## JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

## CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

## Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"
```

`<DATASET_ID>` is returned as `defaultDatasetId` in the run object. `clean=true` drops empty and internal fields.

### Billing and limits

- **Pay per result.** You are charged per charity record returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/uk-charity-commission-scraper/pricing) for the current per-result price.
- **No charge on failure.** If a run errors, the actor writes a single item with a populated `error` field and does not charge for it. Empty runs cost nothing.
- **Filtered-out charities are free.** Records dropped by `withEmailOnly`, `withPhoneOnly` or `withWebsiteOnly` are never returned or charged.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 records per run. Upgrade for higher `maxResults`.
- **Very large pulls** are handled automatically: a search that matches more than the register can page through is split into registration-date slices so the sweep stays complete.

### FAQ and troubleshooting

**A run returned 0 records. Why?**
The filter combination matched nothing. Loosen the filters, drop `searchIn`, or check the spelling of a council area or country. Zero-result runs are not charged.

**Why did a name search return unrelated charities?**
By default the search term is matched against the charity's objects and classifications as well as its name. Set `searchIn` to `["charityName"]` for a name-only search.

**Are the financial figures exact?**
Yes. Income, expenditure, assets and liabilities are returned as exact pound values rather than the rounded figures shown on screen. Financial years a charity never reported come back as `null`, not `0`.

**Does it cover Scotland and Northern Ireland?**
No. This is the register for England and Wales. Scottish and Northern Irish charities appear only when they are also registered in England and Wales.

**Can I get the filed accounts themselves?**
Each record carries `accounts` with a `documentUrl` per filed document and `latestAccountsUrl` for the most recent set, so you can download the PDFs separately.

**How do I build a clean outreach list?**
Combine `withEmailOnly` with an income floor and a purpose, council area or country filter. Every returned record then has a contact email plus the trustee board to address it to.

**Is this an official Charity Commission tool?**
No. This actor is independent and has no affiliation with the Charity Commission for England and Wales. It reads only information published on the public register, which is available under the Open Government Licence.

### Related scrapers

- [UK Companies House Scraper](https://apify.com/scrapers_lat/uk-companies-house-scraper): UK company records, officers and filings.
- [UK FCA Register Scraper](https://apify.com/scrapers_lat/uk-fca-register-scraper): FCA authorised firms and individuals.
- [UK Gazette Insolvency Scraper](https://apify.com/scrapers_lat/uk-gazette-insolvency-scraper): UK insolvency and liquidation notices.
- [UK Contracts Finder Scraper](https://apify.com/scrapers_lat/uk-contracts-finder-scraper): UK public sector contract awards and tenders.
- [Ireland CRO Companies Scraper](https://apify.com/scrapers_lat/ireland-cro-companies-scraper): Irish company registry records.
- [ProPublica Nonprofits Scraper](https://apify.com/scrapers_lat/propublica-nonprofits-scraper): US nonprofit filings and financials.

### More scrapers at scrapers.lat

Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US, UK and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> Independent tool, not affiliated with the Charity Commission for England and Wales. Reads only information published on the public register of charities, available under the Open Government Licence v3.0.

# Actor input Schema

## `searchTerm` (type: `string`):

Free-text search across the register — charity name, number, area of operation, classification and charitable objects. Leave empty to sweep every charity that matches the filters below. Several words are matched as 'any word', so 'cancer support' returns charities mentioning either.

## `searchIn` (type: `array`):

Narrow where the search term is matched. Leave empty to search everything (the register's default). Choosing 'Charity name' alone is the way to run a clean name search without objects and classifications dragging in unrelated charities.

## `charityNumbers` (type: `array`):

Optional. Look up exact registered charity numbers (for example '1089464'). When given, these are fetched directly and every search filter below is ignored.

## `status` (type: `string`):

Registered charities only, charities removed from the register (dissolved, merged or ceased), or both. Removed charities carry the removal date and reason.

## `incomeMin` (type: `integer`):

Only charities whose latest reported gross income is at least this. Use it to skip dormant micro-charities — for example 100000 for charities with real budgets.

## `incomeMax` (type: `integer`):

Only charities whose latest reported gross income is at most this.

## `expenditureMin` (type: `integer`):

Only charities whose latest reported total expenditure is at least this.

## `expenditureMax` (type: `integer`):

Only charities whose latest reported total expenditure is at most this.

## `localAuthorities` (type: `array`):

Council areas the charity works in, for example 'Camden', 'Birmingham City', 'Cardiff'. London boroughs and Welsh councils are routed automatically. Combine with an income filter to build a local funding or partnership list.

## `operatesNationally` (type: `array`):

Charities that declare they work across a whole nation rather than one council area.

## `countriesOfOperation` (type: `array`):

Overseas countries the charity works in, for example 'Kenya', 'Ukraine', 'India'. The register records these per charity, so this isolates charities operating in a given country.

## `whatCharityDoes` (type: `array`):

The register's own purpose classification.

## `whoCharityHelps` (type: `array`):

The beneficiary group the charity declares.

## `howCharityHelps` (type: `array`):

How the charity delivers its purposes — grant makers, service providers, research funders and so on.

## `grantMakersOnly` (type: `boolean`):

Only charities whose main way of carrying out their purposes is grant making — the funder list, straight from the register.

## `employeeBenefitBands` (type: `array`):

Only charities reporting at least one employee in the chosen total-benefits band. A quick filter for charities big enough to employ senior paid staff.

## `registeredFrom` (type: `string`):

Earliest registration date, DD/MM/YYYY or YYYY-MM-DD. Newly registered charities are the freshest leads on the register.

## `registeredTo` (type: `string`):

Latest registration date, DD/MM/YYYY or YYYY-MM-DD.

## `removedFrom` (type: `string`):

Earliest removal date, DD/MM/YYYY or YYYY-MM-DD. Only applies when removed charities are included.

## `removedTo` (type: `string`):

Latest removal date, DD/MM/YYYY or YYYY-MM-DD.

## `documentsOverdueOnly` (type: `boolean`):

Only charities whose annual return or accounts are overdue — the compliance-risk slice of the register.

## `includeLinkedCharities` (type: `boolean`):

Include subsidiary charities linked to a main registration (for example endowment funds run under a parent charity's number).

## `withEmailOnly` (type: `boolean`):

Skip charities that publish no email address. Records without an email are never returned or charged for.

## `withPhoneOnly` (type: `boolean`):

Skip charities that publish no phone number.

## `withWebsiteOnly` (type: `boolean`):

Skip charities that publish no website.

## `fullDetails` (type: `boolean`):

On (recommended): every field — contacts, trustees, finances, accounts, governance. Off: only the result-list summary (name, number, status, headline income), which is much faster for very large sweeps.

## `maxResults` (type: `integer`):

How many charity records to return. Searches returning more than 10,000 matches are split into registration-date windows automatically so large pulls stay complete.

## `proxyConfiguration` (type: `object`):

Optional. The register is reachable without a proxy; use one only if your account requires it.

## Actor input object example

```json
{
  "searchTerm": "cancer support",
  "status": "registered",
  "grantMakersOnly": false,
  "documentsOverdueOnly": false,
  "includeLinkedCharities": false,
  "withEmailOnly": false,
  "withPhoneOnly": false,
  "withWebsiteOnly": false,
  "fullDetails": true,
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerm": "cancer support"
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/uk-charity-commission-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchTerm": "cancer support" }

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/uk-charity-commission-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerm": "cancer support"
}' |
apify call scrapers_lat/uk-charity-commission-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/uk-charity-commission-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6qSi2edPeMJdLaV2D/builds/LjaQtf1f96lc5EAwu/openapi.json