# Echovita Obituary & Funeral Home Scraper (`crawlerbros/echovita-scraper`) Actor

Scrape Echovita.com obituaries and funeral homes across the US, Canada, Australia, and New Zealand - search by name, browse by state/province/city/date or by funeral home, and pull full obituary detail (dates, location, biography, service info) or funeral home directory records.

- **URL**: https://apify.com/crawlerbros/echovita-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Agents, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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

## Echovita Obituary & Funeral Home Scraper

Scrape **Echovita.com** — an obituary and funeral home directory covering the **United States, Canada, Australia, and New Zealand**. Search obituaries by name, browse by state/province/region, city, or date of death, browse the obituaries published by a specific funeral home, look up specific obituaries by URL, or browse the funeral home directory. Get full name, birth/death dates, age, location, biography, funeral home, and service details. HTTP-only, no auth, no login wall.

### What this actor does

- **Seven modes:** `search` (by name), `byState` (state/province/region), `byCity`, `byDate` (date of death), `byUrls` (direct lookup), `funeralHomes` (directory), `byFuneralHome` (obituaries from one funeral home)
- **Four countries:** United States (all 50 states + DC), Canada (all 13 provinces/territories), Australia (all 8 states/territories), New Zealand (North Island / South Island)
- **Recency filter:** narrow any browse/search mode to obituaries published in the last 7 days, month, 6 months, or year
- **Filters:** birth-year and death-year ranges
- **Full obituary detail:** biography text, exact birth/death dates, age at death, geo-coordinates, funeral service info, funeral home
- **Empty fields are omitted** — a record never contains `null`, `""`, or `[]`

### Output per obituary

- `obituaryId`
- `fullName`, `givenName`, `familyName`
- `birthDate`, `deathDate` — ISO dates, when disclosed
- `birthYear`, `deathYear`, `ageAtDeath`
- `city`, `state`, `stateCode` — state, province, or region (e.g. `Ontario` / `on`, `New South Wales` / `nsw`, `North Island` / `ni`)
- `country`, `countryCode` — `United States`/`us`, `Canada`/`ca`, `Australia`/`au`, or `New Zealand`/`nz`
- `latitude`, `longitude`
- `biography` — full obituary text
- `headline` — page headline (e.g. `Jane Doe Obituary (1942-2026) | City, ST`)
- `datePublished`, `dateModified`
- `funeralHomeName`, `funeralHomeUrl` — when the obituary lists a funeral home
- `serviceName`, `serviceStartDate`, `serviceLocationName`, `serviceAddress`, `serviceOrganizer` — when a funeral/memorial service is scheduled
- `socialImageUrl` — the page's social-share image (usually an auto-generated card with the name/dates overlaid, not necessarily a real photo of the deceased)
- `sourceUrl`
- `recordType: "obituary"`, `scrapedAt`

### Output per funeral home (mode=`funeralHomes` / obituaries browsed via mode=`byFuneralHome`)

- `name`, `phone`, `address`, `website`
- `city`, `state`, `stateCode`
- `country`, `countryCode`
- `logoUrl` — the funeral home's uploaded logo, when set; otherwise Echovita's generic placeholder icon
- `servicesOffered[]` — e.g. traditional service, cremation, pre-arrangements
- `latitude`, `longitude`
- `sourceUrl`
- `recordType: "funeralHome"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` / `byState` / `byCity` / `byDate` / `byUrls` / `funeralHomes` / `byFuneralHome` |
| `nameQuery` | string | `Smith` | Full or partial name (mode=search) |
| `country` | string | `us` | `us` / `ca` / `au` / `nz` — which Echovita market to browse |
| `state` | string | – | US state, 2-letter code (used when `country=us`; required for `byState`/`byCity`, optional filter for `funeralHomes`) |
| `caProvince` | string | – | Canadian province/territory code (used when `country=ca`) |
| `auState` | string | – | Australian state/territory code (used when `country=au`) |
| `nzRegion` | string | – | `ni` (North Island) or `si` (South Island) (used when `country=nz`) |
| `city` | string | – | City name (required for `byCity`; optional filter for `funeralHomes`) |
| `deathDate` | string | – | `YYYY-MM-DD` (mode=byDate) |
| `obituaryUrls` | array | – | Direct obituary URLs, any supported country (mode=byUrls) |
| `funeralHomeUrl` | string | – | Direct funeral home URL (mode=byFuneralHome) |
| `rangeTime` | string | `4` (all time) | Recency filter: `0` last 7 days, `1` last month, `2` last 6 months, `3` last year, `4` all time |
| `minBirthYear` / `maxBirthYear` | int | – | Birth year range |
| `minDeathYear` / `maxDeathYear` | int | – | Death year range |
| `maxItems` | int | `50` | Hard cap on emitted records (1-2000) |
| `proxyConfiguration` | object | Apify proxy | Not required for this target; left available for resilience |

### Example: search obituaries by surname

```json
{
  "mode": "search",
  "nameQuery": "Johnson",
  "maxItems": 25
}
````

#### Example: browse obituaries in a US state, recent decades only

```json
{
  "mode": "byState",
  "state": "tx",
  "minDeathYear": 2020,
  "maxItems": 40
}
```

#### Example: browse obituaries in a specific city

```json
{
  "mode": "byCity",
  "state": "mi",
  "city": "olivet",
  "maxItems": 20
}
```

#### Example: obituaries of people who died on a specific date

```json
{
  "mode": "byDate",
  "deathDate": "2026-07-10",
  "maxItems": 30
}
```

#### Example: browse obituaries in a Canadian province, last 7 days only

```json
{
  "mode": "byState",
  "country": "ca",
  "caProvince": "on",
  "rangeTime": "0",
  "maxItems": 25
}
```

#### Example: browse obituaries in an Australian state

```json
{
  "mode": "byState",
  "country": "au",
  "auState": "nsw",
  "maxItems": 25
}
```

#### Example: browse obituaries in New Zealand's South Island

```json
{
  "mode": "byState",
  "country": "nz",
  "nzRegion": "si",
  "maxItems": 25
}
```

#### Example: obituaries published by a specific funeral home

```json
{
  "mode": "byFuneralHome",
  "funeralHomeUrl": "https://www.echovita.com/us/funeral-homes/mi/charlotte/pray-funeral-home-inc-2383",
  "maxItems": 25
}
```

#### Example: funeral home directory in a state

```json
{
  "mode": "funeralHomes",
  "state": "ny",
  "maxItems": 25
}
```

### Use cases

- **Genealogy research** — bulk-collect obituary records for family history projects
- **Local news / media monitoring** — track recent obituaries for a city, region, or country
- **Funeral industry market research** — build a directory of funeral homes by state/province or city, or pull the full publication history of one funeral home
- **Historical/demographic analysis** — analyze age-at-death and location trends over time
- **Estate & probate research** — locate recent death records with dates and location

### FAQ

**What is the data source?**
Echovita.com, an obituary and funeral home directory covering the United States, Canada, Australia, and New Zealand. This actor is an independent, third-party scraper and is not affiliated with or endorsed by Echovita.

**Is `socialImageUrl` a real photo of the deceased?**
Usually not. Echovita auto-generates a social-share card image (name and dates overlaid on a template) for most obituaries, and the list/detail thumbnail is typically a generic numbered stock avatar rather than a genuine photo. The field is included because the URL is real and resolves, but treat it as a share-card image, not a verified photograph.

**Why do some obituaries have no funeral home or service info?**
Not every obituary lists a funeral home or a scheduled service — these fields are simply omitted when the source page doesn't include them, never filled with a placeholder.

**How does `byCity` know the right city URL slug?**
City names are normalized to lowercase, hyphen-separated slugs (e.g. `Los Angeles` -> `los-angeles`) to match Echovita's URL pattern. If a city slug doesn't match any listings, the run returns 0 records with a status message rather than failing.

**Does Echovita cover other countries?**
Yes. Set `country` to `ca` (Canada), `au` (Australia), or `nz` (New Zealand) and use the matching region field (`caProvince`, `auState`, or `nzRegion`) instead of `state`. `mode=search`, `byDate`, `byUrls`, `funeralHomes`, and `byFuneralHome` all work the same way across every supported country — only the region taxonomy changes.

**What does `rangeTime` do, and when should I use it?**
It's Echovita's own recency filter, applied server-side. Leave it at the default (`4`, all time) for the broadest results, or narrow it to `0` (last 7 days) for a daily-monitoring style feed of the newest obituaries in a state, province, city, or funeral home.

**How does `byFuneralHome` work?**
Point it at any funeral home's Echovita page URL (get one from `mode=funeralHomes`, or from an obituary's `funeralHomeUrl` field) and it returns every obituary that funeral home has published on the site, newest first.

**How fresh is the data?**
Each run fetches the live site directly — obituaries are typically published within a day of the source funeral home submitting them.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `nameQuery` (type: `string`):

Full or partial name to search obituaries for.

## `country` (type: `string`):

Which Echovita market to browse. Determines which of `state` / `caProvince` / `auState` / `nzRegion` applies to `byState`/`byCity`/`funeralHomes`.

## `state` (type: `string`):

Required for `byState` / `byCity` when `country=us`. Optional location filter for `funeralHomes`.

## `caProvince` (type: `string`):

Required for `byState` / `byCity` when `country=ca`. Optional location filter for `funeralHomes`.

## `auState` (type: `string`):

Required for `byState` / `byCity` when `country=au`. Optional location filter for `funeralHomes`.

## `nzRegion` (type: `string`):

Required for `byState` / `byCity` when `country=nz`. Optional location filter for `funeralHomes`. Echovita groups New Zealand obituaries by island rather than by region/district.

## `city` (type: `string`):

City name, required for `byCity` (used together with the state/province/region field for the selected `country`). Optional location filter for `funeralHomes`.

## `deathDate` (type: `string`):

Date in `YYYY-MM-DD` format. Returns obituaries of people who died on this date, in the selected `country`.

## `obituaryUrls` (type: `array`):

Direct echovita.com obituary detail URLs to fetch (any supported country).

## `funeralHomeUrl` (type: `string`):

Direct echovita.com funeral home detail URL. Returns the obituaries that funeral home has published.

## `rangeTime` (type: `string`):

Limit `search` / `byState` / `byCity` / `funeralHomes` / `byFuneralHome` to obituaries published within this window (Echovita's own recency filter). Not used by `byDate`, `byUrls`.

## `minBirthYear` (type: `integer`):

Drop obituaries where the person was born before this year.

## `maxBirthYear` (type: `integer`):

Drop obituaries where the person was born after this year.

## `minDeathYear` (type: `integer`):

Drop obituaries where death occurred before this year.

## `maxDeathYear` (type: `integer`):

Drop obituaries where death occurred after this year.

## `maxItems` (type: `integer`):

Hard cap on emitted records.

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

Not required — Echovita.com serves pages without anti-bot protection. Left available for resilience.

## Actor input object example

```json
{
  "mode": "search",
  "nameQuery": "Smith",
  "country": "us",
  "state": "ca",
  "caProvince": "on",
  "auState": "nsw",
  "nzRegion": "ni",
  "city": "los-angeles",
  "deathDate": "2026-07-10",
  "obituaryUrls": [],
  "funeralHomeUrl": "https://www.echovita.com/us/funeral-homes/mi/charlotte/pray-funeral-home-inc-2383",
  "rangeTime": "4",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped Echovita obituary and funeral home records.

# 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 = {
    "mode": "search",
    "nameQuery": "Smith",
    "country": "us",
    "state": "ca",
    "caProvince": "on",
    "auState": "nsw",
    "nzRegion": "ni",
    "city": "los-angeles",
    "deathDate": "2026-07-10",
    "obituaryUrls": [],
    "funeralHomeUrl": "https://www.echovita.com/us/funeral-homes/mi/charlotte/pray-funeral-home-inc-2383",
    "rangeTime": "4",
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/echovita-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 = {
    "mode": "search",
    "nameQuery": "Smith",
    "country": "us",
    "state": "ca",
    "caProvince": "on",
    "auState": "nsw",
    "nzRegion": "ni",
    "city": "los-angeles",
    "deathDate": "2026-07-10",
    "obituaryUrls": [],
    "funeralHomeUrl": "https://www.echovita.com/us/funeral-homes/mi/charlotte/pray-funeral-home-inc-2383",
    "rangeTime": "4",
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/echovita-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 '{
  "mode": "search",
  "nameQuery": "Smith",
  "country": "us",
  "state": "ca",
  "caProvince": "on",
  "auState": "nsw",
  "nzRegion": "ni",
  "city": "los-angeles",
  "deathDate": "2026-07-10",
  "obituaryUrls": [],
  "funeralHomeUrl": "https://www.echovita.com/us/funeral-homes/mi/charlotte/pray-funeral-home-inc-2383",
  "rangeTime": "4",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call crawlerbros/echovita-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Echovita Obituary & Funeral Home Scraper",
        "description": "Scrape Echovita.com obituaries and funeral homes across the US, Canada, Australia, and New Zealand - search by name, browse by state/province/city/date or by funeral home, and pull full obituary detail (dates, location, biography, service info) or funeral home directory records.",
        "version": "1.0",
        "x-build-id": "dcWsFu3Xcfl4u4jBj"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~echovita-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-echovita-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/crawlerbros~echovita-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-echovita-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/crawlerbros~echovita-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-echovita-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "byState",
                            "byCity",
                            "byDate",
                            "byUrls",
                            "funeralHomes",
                            "byFuneralHome"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "search"
                    },
                    "nameQuery": {
                        "title": "Name (mode=search)",
                        "type": "string",
                        "description": "Full or partial name to search obituaries for.",
                        "default": "Smith"
                    },
                    "country": {
                        "title": "Country",
                        "enum": [
                            "us",
                            "ca",
                            "au",
                            "nz"
                        ],
                        "type": "string",
                        "description": "Which Echovita market to browse. Determines which of `state` / `caProvince` / `auState` / `nzRegion` applies to `byState`/`byCity`/`funeralHomes`.",
                        "default": "us"
                    },
                    "state": {
                        "title": "US state (country=us)",
                        "enum": [
                            "al",
                            "ak",
                            "az",
                            "ar",
                            "ca",
                            "co",
                            "ct",
                            "de",
                            "dc",
                            "fl",
                            "ga",
                            "hi",
                            "id",
                            "il",
                            "in",
                            "ia",
                            "ks",
                            "ky",
                            "la",
                            "me",
                            "md",
                            "ma",
                            "mi",
                            "mn",
                            "ms",
                            "mo",
                            "mt",
                            "ne",
                            "nv",
                            "nh",
                            "nj",
                            "nm",
                            "ny",
                            "nc",
                            "nd",
                            "oh",
                            "ok",
                            "or",
                            "pa",
                            "ri",
                            "sc",
                            "sd",
                            "tn",
                            "tx",
                            "ut",
                            "vt",
                            "va",
                            "wa",
                            "wv",
                            "wi",
                            "wy"
                        ],
                        "type": "string",
                        "description": "Required for `byState` / `byCity` when `country=us`. Optional location filter for `funeralHomes`."
                    },
                    "caProvince": {
                        "title": "Canadian province/territory (country=ca)",
                        "enum": [
                            "ab",
                            "bc",
                            "mb",
                            "nb",
                            "nl",
                            "ns",
                            "nt",
                            "nu",
                            "on",
                            "pe",
                            "qc",
                            "sk",
                            "yt"
                        ],
                        "type": "string",
                        "description": "Required for `byState` / `byCity` when `country=ca`. Optional location filter for `funeralHomes`."
                    },
                    "auState": {
                        "title": "Australian state/territory (country=au)",
                        "enum": [
                            "act",
                            "nsw",
                            "nt",
                            "qld",
                            "sa",
                            "tas",
                            "vic",
                            "wa"
                        ],
                        "type": "string",
                        "description": "Required for `byState` / `byCity` when `country=au`. Optional location filter for `funeralHomes`."
                    },
                    "nzRegion": {
                        "title": "New Zealand island (country=nz)",
                        "enum": [
                            "ni",
                            "si"
                        ],
                        "type": "string",
                        "description": "Required for `byState` / `byCity` when `country=nz`. Optional location filter for `funeralHomes`. Echovita groups New Zealand obituaries by island rather than by region/district."
                    },
                    "city": {
                        "title": "City (mode=byCity)",
                        "type": "string",
                        "description": "City name, required for `byCity` (used together with the state/province/region field for the selected `country`). Optional location filter for `funeralHomes`."
                    },
                    "deathDate": {
                        "title": "Date of death (mode=byDate)",
                        "type": "string",
                        "description": "Date in `YYYY-MM-DD` format. Returns obituaries of people who died on this date, in the selected `country`."
                    },
                    "obituaryUrls": {
                        "title": "Obituary URLs (mode=byUrls)",
                        "type": "array",
                        "description": "Direct echovita.com obituary detail URLs to fetch (any supported country).",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "funeralHomeUrl": {
                        "title": "Funeral home URL (mode=byFuneralHome)",
                        "type": "string",
                        "description": "Direct echovita.com funeral home detail URL. Returns the obituaries that funeral home has published."
                    },
                    "rangeTime": {
                        "title": "Time range",
                        "enum": [
                            "0",
                            "1",
                            "2",
                            "3",
                            "4"
                        ],
                        "type": "string",
                        "description": "Limit `search` / `byState` / `byCity` / `funeralHomes` / `byFuneralHome` to obituaries published within this window (Echovita's own recency filter). Not used by `byDate`, `byUrls`.",
                        "default": "4"
                    },
                    "minBirthYear": {
                        "title": "Min birth year",
                        "minimum": 1850,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Drop obituaries where the person was born before this year."
                    },
                    "maxBirthYear": {
                        "title": "Max birth year",
                        "minimum": 1850,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Drop obituaries where the person was born after this year."
                    },
                    "minDeathYear": {
                        "title": "Min death year",
                        "minimum": 1850,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Drop obituaries where death occurred before this year."
                    },
                    "maxDeathYear": {
                        "title": "Max death year",
                        "minimum": 1850,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Drop obituaries where death occurred after this year."
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Not required — Echovita.com serves pages without anti-bot protection. Left available for resilience.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
