# ChurchFinder Scraper - Low-cost💲🔥🔎⛪🔴 (`delectable_incubator/churchfinder-scraper---low-cost`) Actor

Scrape ChurchFinder church listings ⛪🔎 with a powerful directory scraper.

Extract church names, addresses, cities, denominations, contact details, websites, service times, and profile URLs.

Ideal for directory building, outreach campaigns, and structured datasets for research and analysis 📊🚀

- **URL**: https://apify.com/delectable\_incubator/churchfinder-scraper---low-cost.md
- **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community)
- **Categories:** Automation, Lead generation, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

<p align="center"> <img src="https://i.ibb.co/jkNS73wX/readme.png" alt="ChurchFinder Scraper" width="100%"> </p>

---

### ChurchFinder Scraper ⛪🔎📊

The ChurchFinder Scraper is a powerful and scalable Apify Actor designed to extract structured church listings and directory data from ChurchFinder.com.

It enables you to collect church information by location (city/state URLs), making it ideal for directory building, outreach campaigns, community research, and data analysis at scale.

---

### 🎯 What This Scraper Does

Simply provide one or more ChurchFinder URLs and the scraper handles everything automatically.

✅ Extracts structured church listing data

✅ Handles pagination automatically

✅ Applies maxitems limit per URL

✅ Optionally visits detail pages for enriched data

✅ Collects contact info, service times, and websites

✅ Outputs clean, ready-to-use datasets

---

### 📊 Data Extracted

⛪ Church Listing Information

| Field           | Description              |
| --------------- | ------------------------ |
| 🆔 id           | Unique church identifier |
| ⛪ name          | Church name              |
| 📍 address      | Street address           |
| 🏙 city         | City                     |
| 🗺 state        | State                    |
| 📮 zipCode      | ZIP / postal code        |
| ✝️ denomination | Church denomination      |
| 🔗 detailUrl    | Church profile URL       |

🔍 Extended Fields (Optional — fetchDetails = true)

| Field          | Description                 |
| -------------- | --------------------------- |
| 📍 fullAddress | Full formatted address      |
| 📞 phone       | Contact phone number        |
| ⏰ serviceTimes | Worship/service schedule    |
| 🌐 website     | Official church website     |
| 🖼 logoUrl     | Church logo/image           |
| 📝 about       | Description / about section |


---

### 🛠 How to Use

1️⃣ Configure Input  

Provide ChurchFinder URLs and limits:

````

{
"urls": \[
"https://www.churchfinder.com/churches/ny/new-york",
"https://www.churchfinder.com/churches/tx/texas-city"
],
"maxitems": 100,
"fetchDetails": true
}

```

2️⃣ Run the Actor

• Loads church listings from each URL

• Extracts structured data

• Automatically paginates results

• Optionally visits each church profile for more details

• Structures data for export


3️⃣ Export the Dataset

Download your results in multiple formats:

✅ JSON

✅ CSV

✅ Excel

✅ XML

✅ HTML


---

### ⚙️ Input Configuration

#### 📥 Input Example

```

{
"urls": \[
"https://www.churchfinder.com/churches/ny/new-york"
],
"maxitems": 50,
"fetchDetails": true
}

```



#### Input Fields

| Field        | Type    | Description                            |
| ------------ | ------- | -------------------------------------- |
| urls         | array   | ChurchFinder listing URLs (city/state) |
| maxitems     | integer | Maximum churches collected per URL     |
| fetchDetails | boolean | Enable detailed profile scraping       |

---


### 📤 Output Example

```

{
"id": "cf\_987654",
"name": "First Baptist Church",
"address": "123 Main St",
"city": "New York",
"state": "NY",
"zipCode": "10001",
"denomination": "Baptist",
"fullAddress": "123 Main St, New York, NY 10001",
"phone": "(123) 456-7890",
"serviceTimes": "Sunday 9:00 AM, 11:00 AM",
"website": "https://www.examplechurch.org",
"logoUrl": "https://www.example.com/logo.jpg",
"about": "A welcoming community church in the heart of the city.",
"detailUrl": "https://www.churchfinder.com/churches/ny/new-york/first-baptist-church"
}

````

---

### 📊 Use cases

⛪ Religious Directory Building

📍 Local Community Research

📞 Outreach & Engagement

📈 Data & Analytics Projects

🌍 Nationwide Church Data Collection

---

### 🌍 Why Use This Scraper? 

🚀 Fast & scalable extraction

📊 Clean structured datasets

🔎 Supports multiple URLs

🤖 Fully automated workflow

📦 Easy integration with BI tools & APIs

---

### ⚠️ Disclaimer

This tool is an independent solution and is not affiliated with, endorsed by, or sponsored by ChurchFinder.com.

---

### 💸 Pricing

This scraper runs on a **pay per events subscription model**.

You only pay for **successful runs**.

💳 **Price:** $1.49 / 1000 results

---

### Related Actors 

If you're interested in other Chrome scraping solutions, explore more tools:

(Coming soon)

---

### 📬 Support

⭐⭐⭐⭐⭐ Leave a 5-star rating if you like this tool

---

### 🌍 PrimeScrape

Built for scalable web data extraction & automation

Contact for custom scraping solutions or enterprise requests via Apify or by email.

# Actor input Schema

## `urls` (type: `array`):

List of churchfinder.com city/state listing URLs to scrape.

Examples:

🗽 New York, NY:
https://www.churchfinder.com/churches/ny/new-york

🤠 Texas City, TX:
https://www.churchfinder.com/churches/tx/texas-city

🌴 Los Angeles, CA:
https://www.churchfinder.com/churches/ca/los-angeles

🎸 Nashville, TN:
https://www.churchfinder.com/churches/tn/nashville

The scraper follows the 'Next ›' pager link on each page until maxitems is reached or no next link is found.

⚠️ URLs must be from churchfinder.com.
## `maxitems` (type: `integer`):

Maximum number of church listings to collect per URL.
## `fetchDetails` (type: `boolean`):

If enabled, the scraper will visit each church's profile page to collect additional data:

• Full structured address
• Phone number
• Service times
• Website URL
• Logo / image URL
• About / description

⚠️ Enabling this will significantly increase run time as it requires one extra page load per church.

## Actor input object example

```json
{
  "urls": [
    "https://www.churchfinder.com/churches/ny/new-york"
  ],
  "maxitems": 100,
  "fetchDetails": 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 = {
    "urls": [
        "https://www.churchfinder.com/churches/ny/new-york"
    ],
    "maxitems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("delectable_incubator/churchfinder-scraper---low-cost").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 = {
    "urls": ["https://www.churchfinder.com/churches/ny/new-york"],
    "maxitems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("delectable_incubator/churchfinder-scraper---low-cost").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 '{
  "urls": [
    "https://www.churchfinder.com/churches/ny/new-york"
  ],
  "maxitems": 100
}' |
apify call delectable_incubator/churchfinder-scraper---low-cost --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "ChurchFinder Scraper - Low-cost💲🔥🔎⛪🔴",
        "description": "Scrape ChurchFinder church listings ⛪🔎 with a powerful directory scraper. \n\nExtract church names, addresses, cities, denominations, contact details, websites, service times, and profile URLs. \n\nIdeal for directory building, outreach campaigns, and structured datasets for research and analysis 📊🚀",
        "version": "0.0",
        "x-build-id": "LIshyp8yN5nCpIoN1"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/delectable_incubator~churchfinder-scraper---low-cost/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-delectable_incubator-churchfinder-scraper---low-cost",
                "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/delectable_incubator~churchfinder-scraper---low-cost/runs": {
            "post": {
                "operationId": "runs-sync-delectable_incubator-churchfinder-scraper---low-cost",
                "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/delectable_incubator~churchfinder-scraper---low-cost/run-sync": {
            "post": {
                "operationId": "run-sync-delectable_incubator-churchfinder-scraper---low-cost",
                "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",
                "required": [
                    "urls",
                    "maxitems"
                ],
                "properties": {
                    "urls": {
                        "title": "ChurchFinder Search URLs ⛪",
                        "type": "array",
                        "description": "List of churchfinder.com city/state listing URLs to scrape.\n\nExamples:\n\n🗽 New York, NY:\nhttps://www.churchfinder.com/churches/ny/new-york\n\n🤠 Texas City, TX:\nhttps://www.churchfinder.com/churches/tx/texas-city\n\n🌴 Los Angeles, CA:\nhttps://www.churchfinder.com/churches/ca/los-angeles\n\n🎸 Nashville, TN:\nhttps://www.churchfinder.com/churches/tn/nashville\n\nThe scraper follows the 'Next ›' pager link on each page until maxitems is reached or no next link is found.\n\n⚠️ URLs must be from churchfinder.com.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxitems": {
                        "title": "Maximum churches per URL 📄",
                        "type": "integer",
                        "description": "Maximum number of church listings to collect per URL.",
                        "default": 100
                    },
                    "fetchDetails": {
                        "title": "Fetch church detail pages 🔍",
                        "type": "boolean",
                        "description": "If enabled, the scraper will visit each church's profile page to collect additional data:\n\n• Full structured address\n• Phone number\n• Service times\n• Website URL\n• Logo / image URL\n• About / description\n\n⚠️ Enabling this will significantly increase run time as it requires one extra page load per church.",
                        "default": false
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
