# Church Finder Scraper (`solidcode/churchfinder-scraper`) Actor \[💰 $3.5 / 1K] Extract US church listings from Church Finder — name, denomination, address, phone, website, service times, pastor, member count, ministries, beliefs, ratings and reviews. Search any city or state and filter by 13 denominations. - **URL**: https://apify.com/solidcode/churchfinder-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Church Finder Scraper Pull US church listings from Church Finder at scale — names, split addresses, phone numbers, church websites, service times, pastors, membership size, ministries, statements of belief, ratings, and visitor reviews. Search any city or whole state, filter to any of 13 denominations, and get one clean row per church with as many as 47 fields. Built for faith-based marketers, denominational researchers, church-supply and AV vendors, and nonprofit outreach teams who need a structured national church dataset without opening thousands of profile pages by hand. ### Why This Scraper? - **As many as 47 fields per church** — the closest alternative on the store stops at 14. Everything that makes a church profile worth having (pastor, website, membership band, ministries, doctrine, ratings) is in every row. - **13 denomination filters applied at the source** — Baptist, Catholic, Methodist, Lutheran, Presbyterian, Episcopal / Anglican, Orthodox, Pentecostal, Spirit-Filled / Charismatic, Evangelical, Reformed, Christian, and Non-Denominational. The directory itself does the filtering, so you are never charged for churches you filtered out. - **Nationwide coverage — 56 state and territory directories** — all 50 states plus DC, Puerto Rico, Guam, the US Virgin Islands, American Samoa, and the Northern Mariana Islands. Type a bare state and it works through every city in it: Texas alone lists 1,093 city directories. - **Split, mailing-ready addresses** — `street`, `city`, `state`, `zipCode`, and `country` as separate fields, plus a printed one-line `fullAddress`. No parsing a single address blob yourself, and ZIP codes arrive on every enriched row. - **Congregation profile, not just contact data** — membership band ("Over 5000 Members"), average attendee age, dress style, primary language, and service and sermon style, alongside the weekly `serviceTimes` string exactly as the church wrote it. - **Doctrinal depth no other church dataset carries** — statement-of-belief sentences, primary Bible version, baptism practice, communion frequency, eternal-security position, charismatic-gifts position, regularly practiced elements, and the named doctrinal statements each church endorses. - **Ministries and public services as clean arrays** — kids, youth, college, men's and women's ministries on one side; counseling, weddings, funerals, and summer camps on the other, ready to filter on. - **Opt-in visitor reviews with full text** — author name, their relationship to the church, star rating, title, and body. Roughly 2% of churches have any review at all, so it stays off by default and never inflates a run. - **Exact result caps** — ask for 50 churches and you are billed for exactly 50, never a rounded-up block of 100. Set `maxResults` to 0 and a single run collects up to 50,000 churches. ### Use Cases **Faith-Based Marketing & Vendor Sales** - Build target lists of churches by denomination and metro area - Prioritize outreach by membership band — reach only congregations above a size threshold - Reach AV, seating, curriculum, and software buyers with verified phone and website contacts - Segment by service style (contemporary vs. traditional) to match your product fit **Denominational & Religious Research** - Map denominational density city by city across all 50 states - Compare doctrinal positions — baptism, communion frequency, eternal security — at scale - Track which Bible versions dominate which regions - Study primary service language to measure multilingual ministry coverage **Nonprofit & Community Outreach** - Find congregations running counseling, food, or youth programs in your service area - Identify churches with community-project involvement for partnership campaigns - Build volunteer-recruitment lists by ministry type - Locate churches offering summer camps or family services near a target ZIP **Directory, App & Dataset Building** - Power a church-finder app with names, coordinates, service times, and logos - Enrich an existing congregation CRM with websites, social links, and pastor names - Feed denominational dashboards with fresh city-level counts - Keep a national church database current with scheduled refreshes **Reputation & Review Analysis** - Collect visitor review text and star ratings for the churches that have them - Compare average ratings across denominations in a metro - Monitor which congregations have claimed and actively manage their listing - Track review growth over time for a set of watched churches ### Getting Started #### One City The simplest possible run — a city, a limit, full detail on by default: ```json { "locations": ["Austin, TX"], "maxResults": 50 } ```` #### Filter to Specific Denominations ```json { "locations": ["Houston, TX", "San Antonio, Texas"], "denominations": ["baptist", "methodist"], "maxResults": 500 } ``` #### Fast Roster Without Profile Detail Turn detail off when you only need a name-and-address list: ```json { "locations": ["Texas"], "includeChurchDetails": false, "maxResults": 5000 } ``` #### Full Depth, Including Reviews ```json { "locations": ["Nashville, TN"], "startUrls": [ "https://www.churchfinder.com/churches/tx/austin/hill-country-bible-church" ], "denominations": ["non-denominational", "evangelical"], "includeChurchDetails": true, "includeReviews": true, "maxResults": 1000 } ``` ### Input Reference #### Search | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `locations` | array of strings | `["Austin, TX"]` | Cities or states to search. Type them the way you'd say them — 'Austin, TX' or 'San Antonio, Texas'. Enter just a state ('Texas' or 'TX') to work through every city in that state, in the directory's own order (roughly alphabetical), until your result limit is reached. To target the big metros, name those cities yourself. | | `startUrls` | array of strings | `[]` | Paste Church Finder web addresses directly. Works with state pages, city listings, denomination listings and individual church pages. Review pages on their own aren't supported — paste the church's profile address instead. Leave empty if you're using Locations. | You can use both together in one run. #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `denominations` | array of strings | `[]` (all) | Only return churches of these denominations. Leave empty to include every denomination. Choosing several searches each one in turn. This applies to city and state searches; an individual church address you paste under Church Finder URLs is always returned. | Accepted denomination values: | Value | Shown as | |-------|----------| | `baptist` | Baptist | | `catholic` | Catholic | | `methodist` | Methodist | | `lutheran` | Lutheran | | `presbyterian` | Presbyterian | | `episcopal` | Episcopal / Anglican | | `orthodox` | Orthodox | | `pentecostal` | Pentecostal | | `spirit-filled` | Spirit-Filled / Charismatic | | `evangelical` | Evangelical | | `reformed` | Reformed | | `christian` | Christian | | `non-denominational` | Non-Denominational | #### What to Collect | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `includeChurchDetails` | boolean | `true` | Visit each church's profile page to collect ZIP code, phone number, website, service times, pastor, ministries, beliefs and ratings. Turn this off for a much faster run that returns at least church name, street, city, state, denomination and profile link — around 30 other fields come from the profile page. If a profile can't be opened, the church is still returned with those basic details. Churches are enriched in batches of up to 100, and each batch has a time budget of a few minutes; if Church Finder answers too slowly, the rest of that batch is returned with the basic details and the run finishes with a partial-results message telling you how many. | | `includeReviews` | boolean | `false` | Also collect visitor reviews for churches that have them. Only about 2% of churches have any review at all, so this rarely slows your run, and every review a church has is returned at once. Reviews come from the church's profile page, so switching this on also switches on 'Include full church profiles'. | #### Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `50` | Maximum number of churches to return across all your searches. This is an exact limit — you're never charged for more than this. Set to 0 for no limit, which collects up to 50,000 churches per run. | ### Output One flat row per church. Empty fields are omitted, so sparse listings stay compact. ```json { "churchName": "Hill Country Bible Church", "denomination": "Non-Denominational Christian Churches", "denominationCategory": "Non-Denominational", "pastorName": "Tim Hawks", "memberCount": "Over 5000 Members", "isClaimed": true, "street": "12124 RR 620 N", "city": "Austin", "state": "TX", "zipCode": "78750", "country": "United States", "fullAddress": "12124 RR 620 N, Austin, TX 78750, United States", "latitude": 30.4534, "longitude": -97.8321, "phone": "(512) 331-5050", "website": "https://www.hcbc.com", "socialLinks": ["https://www.facebook.com/hillcountrybible"], "logoUrl": "https://www.churchfinder.com/sites/default/files/hcbc-logo.png", "photoUrls": ["https://www.churchfinder.com/sites/default/files/hcbc-1.jpg"], "photoCaptions": ["Sunday morning worship"], "description": "Hill Country Bible Church is a multi-site church in northwest Austin...", "mission": "To lead people to become fully devoted followers of Christ.", "serviceTimes": "Sunday 9:00 AM, 10:45 AM, 5:00 PM", "serviceStyle": "Contemporary Teaching", "dressStyle": "Casual", "averageAge": "30 to 50", "primaryLanguage": "English", "communityProjects": "Very Involved", "ministries": ["Children's Ministry", "Youth Ministry", "College Ministry", "Women's Ministry"], "groupsAndServices": ["Counseling", "Weddings", "Funerals", "Summer Camp"], "beliefs": ["We believe the Bible is the inspired Word of God.", "We believe in one God, eternally existing in three persons."], "bibleVersion": "New International Version", "baptism": "Believers Baptism by Immersion", "communionFrequency": "Monthly", "eternalSecurity": "Once Saved Always Saved", "charismaticGifts": "Not Practiced", "regularPractices": ["Altar Call or Invitation", "Small Groups"], "doctrinalStatements": ["Apostles Creed", "Nicene Creed"], "rating": 4.8, "reviewCount": 12, "reviewsUrl": "https://www.churchfinder.com/reviews/hill-country-bible-church/394700", "reviews": [ { "author": "Sarah Mitchell", "memberType": "Member", "title": "A welcoming church family", "rating": 5.0, "text": "We have attended for six years and the children's ministry is outstanding.", "url": "https://www.churchfinder.com/reviews/hill-country-bible-church/394700", "avatarUrl": "https://www.churchfinder.com/sites/default/files/avatar-sm.jpg" } ], "profileManager": "Hill Country Bible Church", "nodeId": "394700", "profileUrl": "https://www.churchfinder.com/churches/tx/austin/hill-country-bible-church", "searchLocation": "Austin, TX", "scrapedAt": "2026-07-25T14:02:11.480291+00:00" } ``` #### Identity & Congregation | Field | Type | Description | |-------|------|-------------| | `churchName` | string | Church name | | `denomination` | string | Specific denomination or affiliation, e.g. "Evangelical Lutheran in America" | | `denominationCategory` | string | Broad category, e.g. "Baptist", "Non-Denominational" | | `pastorName` | string | Senior or lead pastor, with the title stripped | | `memberCount` | string | Membership band as published, e.g. "Over 5000 Members" | | `averageAge` | string | Average age of attendees | | `primaryLanguage` | string | Primary service language | | `isClaimed` | boolean | Whether the church manages its own listing | | `profileManager` | string | Name of the listing manager, when published | #### Location | Field | Type | Description | |-------|------|-------------| | `street` | string | Street address | | `city` | string | City | | `state` | string | Two-letter state code | | `zipCode` | string | ZIP code (profile detail only) | | `country` | string | Always "United States" | | `fullAddress` | string | Single-line address as printed on the profile | | `latitude` | number | Latitude, when the church has published a map location | | `longitude` | number | Longitude, when the church has published a map location | #### Contact & Web | Field | Type | Description | |-------|------|-------------| | `phone` | string | Church phone number | | `website` | string | The church's own website | | `socialLinks` | array of strings | Facebook and other social profile links | | `logoUrl` | string | Church logo image (blank when the church uses the directory placeholder) | | `photoUrls` | array of strings | Photo gallery image links | | `photoCaptions` | array of strings | Captions matching the photo gallery | | `profileUrl` | string | Church Finder profile address | #### Services & Style | Field | Type | Description | |-------|------|-------------| | `serviceTimes` | string | Weekly service schedule exactly as written | | `serviceStyle` | string | Service and sermon style, e.g. "Contemporary Teaching" | | `dressStyle` | string | Typical dress, e.g. "Casual" | | `description` | string | The "About this Church" text | | `mission` | string | Mission statement | | `communityProjects` | string | Community-project involvement level | #### Ministries & Beliefs | Field | Type | Description | |-------|------|-------------| | `ministries` | array of strings | Ministry groups — children's, youth, college, men's, women's | | `groupsAndServices` | array of strings | Public services — counseling, weddings, funerals, summer camp | | `beliefs` | array of strings | Statement-of-belief sentences | | `bibleVersion` | string | Primary Bible version used | | `baptism` | string | Baptism practice | | `communionFrequency` | string | How often communion is served | | `eternalSecurity` | string | Eternal-security position | | `charismaticGifts` | string | Healing and charismatic-gifts position | | `regularPractices` | array of strings | Regularly practiced elements, e.g. "Altar Call or Invitation" | | `doctrinalStatements` | array of strings | Named doctrinal statements the church endorses | #### Ratings, Reviews & Run Metadata | Field | Type | Description | |-------|------|-------------| | `rating` | number | Average visitor rating out of 5 | | `reviewCount` | integer | Number of visitor reviews on record | | `reviewsUrl` | string | Address of the church's reviews page | | `reviews` | array of objects | Full reviews — only when Include visitor reviews is on | | `nodeId` | string | Church Finder's own listing identifier | | `searchLocation` | string | The location or address this row came from | | `scrapedAt` | string | ISO 8601 timestamp of collection | Each entry inside `reviews` carries `author`, `memberType` (the reviewer's relationship to the church), `title`, `rating`, `text`, `url`, and `avatarUrl`. The example above shows a fully filled-in listing. Map coordinates and star ratings appear only for the minority of churches that publish them, and every empty field is left out of the row. ### Tips for Best Results - **Start with 10–50 results** to confirm the fields match what you need, then raise `maxResults`. The cap is exact, so a small test run costs exactly what it says. - **A bare state name enumerates every city in it** — "Texas" walks all 1,093 Texas city directories in the directory's own order, which runs roughly alphabetically rather than largest city first. Pair it with a generous `maxResults` for a statewide sweep; to target the big metros, name them yourself: "Houston, TX", "Dallas, TX", "San Antonio, TX". - **Always include the state in a city entry** — "Austin, TX" and "San Antonio, Texas" both resolve, but "austin tx" without the comma does not, and dozens of city names repeat across states. - **Punctuated city names work as typed** — "St. Louis, MO" and "Coeur d'Alene, ID" both resolve correctly; you never need to guess how the directory spells them. - **Denomination filtering happens per city**, so combining a whole state with two denominations runs one focused pass per city per denomination — precise, but plan `maxResults` accordingly. - **Leave visitor reviews off unless you need the text.** Only about 2% of churches have a single review, so for most target lists the star `rating` and `reviewCount` already tell you everything. - **Turn off full church profiles for a fast roster.** You keep at least name, street, city, state, denomination, and the profile link — ideal for building a coverage map first and enriching only the cities that matter. - **Mix Locations and Church Finder URLs in one run** — sweep two metros while also pulling a hand-picked list of flagship congregations you already know. ### Pricing **From $3.50 per 1,000 results** — roughly 20% below the closest alternative on the store, with more than three times the fields per church. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.42 | $0.40 | $0.37 | $0.35 | | 1,000 | $4.20 | $3.95 | $3.70 | $3.50 | | 10,000 | $42.00 | $39.50 | $37.00 | $35.00 | | 100,000 | $420.00 | $395.00 | $370.00 | $350.00 | A "result" is one church row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor collects publicly listed church directory information for legitimate research, outreach, and directory-building purposes. You are responsible for complying with applicable laws and Church Finder's Terms of Service. Church contact details are published so congregations can be reached — do not use them for spam, harassment, or any unlawful purpose, and respect any opt-out request you receive. Visitor reviews are user-written content: handle them, and any personal details they contain, in line with applicable data-protection rules. # Actor input Schema ## `locations` (type: `array`): Cities or states to search. Type them the way you'd say them — 'Austin, TX' or 'San Antonio, Texas'. Enter just a state ('Texas' or 'TX') to work through every city in that state, in the directory's own order (roughly alphabetical), until your result limit is reached. To target the big metros, name those cities yourself. ## `startUrls` (type: `array`): Paste Church Finder web addresses directly. Works with state pages, city listings, denomination listings and individual church pages. Review pages on their own aren't supported — paste the church's profile address instead. Leave empty if you're using Locations. ## `denominations` (type: `array`): Only return churches of these denominations. Leave empty to include every denomination. Choosing several searches each one in turn. This applies to city and state searches; an individual church address you paste under Church Finder URLs is always returned. ## `includeChurchDetails` (type: `boolean`): Visit each church's profile page to collect ZIP code, phone number, website, service times, pastor, ministries, beliefs and ratings. Turn this off for a much faster run that returns at least church name, street, city, state, denomination and profile link — around 30 other fields come from the profile page. If a profile can't be opened, the church is still returned with those basic details. Churches are enriched in batches of up to 100, and each batch has a time budget of a few minutes; if Church Finder answers too slowly, the rest of that batch is returned with the basic details and the run finishes with a partial-results message telling you how many. ## `includeReviews` (type: `boolean`): Also collect visitor reviews for churches that have them. Only about 2% of churches have any review at all, so this rarely slows your run, and every review a church has is returned at once. Reviews come from the church's profile page, so switching this on also switches on 'Include full church profiles'. ## `maxResults` (type: `integer`): Maximum number of churches to return across all your searches. This is an exact limit — you're never charged for more than this. Set to 0 for no limit, which collects up to 50,000 churches per run. ## Actor input object example ```json { "locations": [ "Austin, TX" ], "startUrls": [], "denominations": [], "includeChurchDetails": true, "maxResults": 50 } ``` # Actor output Schema ## `overview` (type: `string`): Table of churches with name, denomination, address, phone and website. ## `contacts` (type: `string`): Contact-focused view with phone, website, social links, pastor and full address. ## `details` (type: `string`): Complete per-church rows including service style, ministries, beliefs, ratings and reviews. # 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 = { "locations": [ "Austin, TX" ], "startUrls": [], "denominations": [], "includeChurchDetails": true, "includeReviews": false, "maxResults": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["Austin, TX"], "startUrls": [], "denominations": [], "includeChurchDetails": True, "includeReviews": False, "maxResults": 50, } # Run the Actor and wait for it to finish run = client.actor("solidcode/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 '{ "locations": [ "Austin, TX" ], "startUrls": [], "denominations": [], "includeChurchDetails": true, "includeReviews": false, "maxResults": 50 }' | apify call solidcode/churchfinder-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/churchfinder-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Church Finder Scraper", "description": "[💰 $3.5 / 1K] Extract US church listings from Church Finder — name, denomination, address, phone, website, service times, pastor, member count, ministries, beliefs, ratings and reviews. Search any city or state and filter by 13 denominations.", "version": "1.0", "x-build-id": "QHr0vzxWO9CqnawBe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~churchfinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-churchfinder-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/solidcode~churchfinder-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-churchfinder-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/solidcode~churchfinder-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-churchfinder-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": { "locations": { "title": "Locations", "type": "array", "description": "Cities or states to search. Type them the way you'd say them — 'Austin, TX' or 'San Antonio, Texas'. Enter just a state ('Texas' or 'TX') to work through every city in that state, in the directory's own order (roughly alphabetical), until your result limit is reached. To target the big metros, name those cities yourself.", "items": { "type": "string" } }, "startUrls": { "title": "Church Finder URLs", "type": "array", "description": "Paste Church Finder web addresses directly. Works with state pages, city listings, denomination listings and individual church pages. Review pages on their own aren't supported — paste the church's profile address instead. Leave empty if you're using Locations.", "items": { "type": "string" } }, "denominations": { "title": "Denominations", "uniqueItems": true, "type": "array", "description": "Only return churches of these denominations. Leave empty to include every denomination. Choosing several searches each one in turn. This applies to city and state searches; an individual church address you paste under Church Finder URLs is always returned.", "items": { "type": "string", "enum": [ "baptist", "catholic", "methodist", "lutheran", "presbyterian", "episcopal", "orthodox", "pentecostal", "spirit-filled", "evangelical", "reformed", "christian", "non-denominational" ], "enumTitles": [ "Baptist", "Catholic", "Methodist", "Lutheran", "Presbyterian", "Episcopal / Anglican", "Orthodox", "Pentecostal", "Spirit-Filled / Charismatic", "Evangelical", "Reformed", "Christian", "Non-Denominational" ] } }, "includeChurchDetails": { "title": "Include full church profiles", "type": "boolean", "description": "Visit each church's profile page to collect ZIP code, phone number, website, service times, pastor, ministries, beliefs and ratings. Turn this off for a much faster run that returns at least church name, street, city, state, denomination and profile link — around 30 other fields come from the profile page. If a profile can't be opened, the church is still returned with those basic details. Churches are enriched in batches of up to 100, and each batch has a time budget of a few minutes; if Church Finder answers too slowly, the rest of that batch is returned with the basic details and the run finishes with a partial-results message telling you how many." }, "includeReviews": { "title": "Include visitor reviews", "type": "boolean", "description": "Also collect visitor reviews for churches that have them. Only about 2% of churches have any review at all, so this rarely slows your run, and every review a church has is returned at once. Reviews come from the church's profile page, so switching this on also switches on 'Include full church profiles'." }, "maxResults": { "title": "Maximum churches", "minimum": 0, "type": "integer", "description": "Maximum number of churches to return across all your searches. This is an exact limit — you're never charged for more than this. Set to 0 for no limit, which collects up to 50,000 churches per run." } } }, "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 } } } } } } } } } } ```