# Church Finder Scraper \[💰Free] (`confidential_gnat/churchfinder-scraper`) Actor

Scrape church listings and profiles from Church Finder. Extracts church name, denomination, address, phone number, service times, ratings and reviews from city search pages or individual church URLs.

- **URL**: https://apify.com/confidential\_gnat/churchfinder-scraper.md
- **Developed by:** [ActorFlow](https://apify.com/confidential_gnat) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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

## Church Finder Scraper

Scrapes church listings and full church profiles from [Church Finder](https://www.churchfinder.com/). Give it a city page such as `https://www.churchfinder.com/churches/ny/new-york` or a single church profile URL, and it returns structured records containing the church name, denomination, address, phone number, service times, ratings and reviews. Results are available as JSON, CSV or Excel.

### ✨ Features

- **Church profile extraction** — church name, denomination / affiliation, full address, phone number, service times, average rating, review count, individual reviews and the church description
- **Pagination support** — automatically walks through city listing pages until the requested number of churches is collected
- **Proxy support** — optional Apify Proxy, disabled by default because the site works reliably without it
- **Per-URL result limit** — `dataCount` caps results separately for each start URL, so one busy city cannot consume another's quota

### 🔧 Input Configuration

| Field                | Type    | Required | Default                                             | Description                                                                                                                                                  |
| -------------------- | ------- | -------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `startUrls`          | array   | ✅       | `https://www.churchfinder.com/churches/ny/new-york` | Church Finder URLs to scrape. Accepts city search pages and individual church profile pages. Any URL outside churchfinder.com is skipped with a log message. |
| `dataCount`          | integer | —        | `5`                                                 | Maximum number of churches to scrape for each start URL. Applied per start URL, not across the whole run.                                                    |
| `proxyConfiguration` | object  | —        | `{ "useApifyProxy": false }`                        | Proxy settings for the run.                                                                                                                                  |

**Supported URL types:**

- **City search page** — `https://www.churchfinder.com/churches/ny/new-york`
  Collects churches from the listing and follows the pager until `dataCount` is reached.
- **Church profile page** — `https://www.churchfinder.com/churches/ny/new-york/abyssinian-baptist-church`
  Scrapes that single church directly.

### 📦 Output

The dataset provides one view, **Overview**, a compact table of the scraped churches showing name, denomination, address, phone, rating, review count and profile URL. The full records additionally include the structured service times, the individual reviews and the church description.

**Sample output:**

```json
{
    "title": "Abyssinian Baptist Church",
    "denominationAffiliation": "American Baptist",
    "averageReview": 4,
    "reviewCount": 1,
    "address": "132 Odell Clark Pl, New York, NY 10030, United States",
    "serviceTypes": [
        {
            "day": "Sunday",
            "time": "7:00AM",
            "serviceType": "Worship service"
        },
        {
            "day": "Sunday",
            "time": "9:00AM",
            "serviceType": "Worship service"
        },
        {
            "day": "Sunday",
            "time": "11:00AM",
            "serviceType": "Worship service"
        }
    ],
    "phoneNumber": "(212) 862-7474",
    "latestReviews": [
        {
            "author": "r.",
            "title": "feww",
            "rating": 4,
            "review": "A nem teljes körű"
        }
    ],
    "aboutChurch": "Abyssinian Baptist Church is a Baptist church in New York New York. This American Baptist church serves New York County NY",
    "churchUrl": "https://www.churchfinder.com/churches/ny/new-york/abyssinian-baptist-church"
}
```

```json
{
    "title": "All Souls' Church",
    "denominationAffiliation": "Episcopal",
    "averageReview": null,
    "reviewCount": null,
    "address": "88 Saint Nicholas Ave, New York, NY 10026, United States",
    "serviceTypes": [],
    "phoneNumber": "(212) 663-2351",
    "latestReviews": [],
    "aboutChurch": "All Souls' Church is a Episcopal church in New York New York. This Episcopal church serves New York County NY",
    "churchUrl": "https://www.churchfinder.com/churches/ny/new-york/all-souls-church"
}
```

### 💡 Uses of This Data

- Building local directories of places of worship by city, state or denomination
- Market and outreach research for faith-based organizations and suppliers
- Demographic and sociological studies of denominational distribution across regions
- Enriching CRM or mailing lists with verified church contact details
- Monitoring service times and contact information for aggregator or listing sites

### 🚀 How to Use

1. [Sign up](https://apify.com/sign-up) for a free Apify account — includes **$5 monthly credit**.
2. Open the actor page and click **Try for free**.
3. Fill in the **Input** fields (at least one start URL is required).
4. Click **Start** and wait for the run to complete.
5. Download results from the **Output** tab in JSON, CSV, or Excel format.

You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or integrate it directly into your workflows using [Zapier](https://zapier.com/apps/apify), [Make](https://www.make.com/), or [n8n](https://n8n.io/).

### 📝 Notes

- **Proxy recommended for large-scale scraping** — For high-volume runs, enable the Apify Residential or Datacenter proxy to avoid blocks.
- **API integration** — This actor can be called as an API from any automation platform (Zapier, Make, n8n, custom scripts).

### Other Existing Actors

| Scraper | Description |
|----------|-------------|
| [🚗 Cheapest Cars & Bids Scraper](https://apify.com/confidential_gnat/cheapest-carsandbids-scraper) | Scrapes the cheapest vehicle listings from Cars & Bids, making it easy to discover the best-value auction deals. |
| [🔍 Incidecoder Scraper](https://apify.com/confidential_gnat/whois-com) | Extracts cosmetic ingredient and product information from Incidecoder for research and analysis. |
| [🎟️ Gametime Events Website Scraper](https://apify.com/confidential_gnat/gametime-events-scraper) | Collects event listings, ticket availability, and pricing data from Gametime. |
| [🏠 Rightmove Scraper](https://apify.com/confidential_gnat/riccycaunce-rightmove-scrapy) | Extracts property listings, prices, locations, and other real estate details from Rightmove. |

### 💬 Support & Contact

If you encounter any issues or have questions, please [open an issue](https://apify.com/confidential_gnat/churchfinder-scraper/issues/open)

You can also find more of our actors on the [Actor Flow ](https://apify.com/confidential_gnat).

# Actor input Schema

## `startUrls` (type: `array`):

Church Finder URLs to scrape. Accepts city search pages (e.g. https://www.churchfinder.com/churches/ny/new-york) and individual church profile pages (e.g. https://www.churchfinder.com/churches/ny/new-york/abyssinian-baptist-church). Any URL outside churchfinder.com is skipped.

## `scrapeWholeWebsite` (type: `boolean`):

Scrape churches from across the entire Church Finder site instead of the start URLs above. When enabled, the start URLs are ignored and 'Number of churches' becomes the total for the whole run.

## `dataCount` (type: `integer`):

Maximum number of churches to scrape for each start URL. When 'Scrape the whole website' is enabled, this is the total number of churches for the whole run.

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

Proxy settings for the run. Church Finder works reliably without a proxy, so proxies are disabled by default to keep runs cheap.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.churchfinder.com/churches/ny/new-york"
    }
  ],
  "scrapeWholeWebsite": false,
  "dataCount": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://www.churchfinder.com/churches/ny/new-york"
        }
    ],
    "scrapeWholeWebsite": false,
    "dataCount": 5,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("confidential_gnat/churchfinder-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 = {
    "startUrls": [{ "url": "https://www.churchfinder.com/churches/ny/new-york" }],
    "scrapeWholeWebsite": False,
    "dataCount": 5,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("confidential_gnat/churchfinder-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 '{
  "startUrls": [
    {
      "url": "https://www.churchfinder.com/churches/ny/new-york"
    }
  ],
  "scrapeWholeWebsite": false,
  "dataCount": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call confidential_gnat/churchfinder-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=confidential_gnat/churchfinder-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nBd0o6GrlBphAevdo/builds/VgExwzBJ7M6y4dSov/openapi.json