# Bible Verse of the Day & Passage Scraper API (`scrapers_lat/bible-verse-passage-scraper`) Actor

Get a stable verse of the day or look up any Bible verse, passage or range in multiple translations (English, Portuguese, Latin). Clean text plus structured per-verse output and an optional AI devotional. No API key. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/bible-verse-passage-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.56 / 1,000 verse / passage records

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

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

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![Bible Verse of the Day & Passage Scraper API](https://scrapers.lat/banners/bible-verse-passage-scraper.png)](https://console.apify.com/actors/n6hu8paHDHmRuNPyD/input)

## Bible Verse of the Day & Passage Scraper API

Here is one real result, with every field the actor returns:

```json
{
  "mode": "votd",
  "isVerseOfTheDay": true,
  "reference": "Micah 6:8",
  "requestedReference": "Micah 6:8",
  "book": "Micah",
  "bookId": "MIC",
  "chapter": 6,
  "verseStart": 8,
  "verseEnd": 8,
  "verseCount": 1,
  "text": "He has shown you, O man, what is good. What does Yahweh require of you, but to act justly, to love mercy, and to walk humbly with your God?",
  "verses": [
    {
      "book": "Micah",
      "chapter": 6,
      "verse": 8,
      "text": "He has shown you, O man, what is good. What does Yahweh require of you, but to act justly, to love mercy, and to walk humbly with your God?"
    }
  ],
  "translationId": "web",
  "translationName": "World English Bible",
  "translationNote": "Public Domain",
  "wordCount": 27,
  "devotionalReflection": null,
  "devotionalApplication": null,
  "devotionalPrayer": null,
  "source": "bible-api.com",
  "observedAt": "2026-08-23T00:00:00.000Z",
  "error": null
}
```

The most complete verse-of-the-day and passage lookup available on Apify. It returns a stable daily verse plus any verse, range, or whole chapter you ask for, in multiple public-domain translations, with clean single-line text and structured per-verse output, and an optional AI devotional. No API key, no registration, pay per result.

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

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

### Table of contents

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

### What it does

The actor gives you Bible text two ways in a single tool:

- **Verse of the day.** In `votd` mode it returns one stable verse chosen by calendar day from a curated rotation of well-known encouraging passages. The same day always returns the same verse, so it is safe to cache and show as a daily feature. This is our own curated rotation, not an official liturgical or lectionary reading.
- **Reference lookup.** In `reference` mode it returns any verse (`John 3:16`), any range (`Romans 8:28-30`), or any whole chapter (`Psalm 23`). Pass one reference or a batch of them and get one clean record per reference.

Every record includes the full passage as one clean single-line string (source line breaks normalized), a structured `verses` array with one entry per verse, the book, chapter and verse range, the translation used, and a word count. An optional AI devotional adds a short reflection, a practical daily application, and a one-line prayer based on the passage.

Translations available include the World English Bible (`web`), King James Version (`kjv`), Bible in Basic English (`bbe`), American Standard Version (`asv`), Darby, Douay-Rheims (`dra`), Young's Literal (`ylt`, New Testament only), Open English Bible US (`oeb-us`), World English Bible British (`webbe`), Portuguese (`almeida`), and the Latin Vulgate (`clementine`, partial coverage). All are public domain.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns today's verse of the day in the World English Bible.

```json
{
  "mode": "votd",
  "translation": "web"
}
```

To look up specific passages instead, switch to reference mode and pass one or more references:

```json
{
  "mode": "reference",
  "references": ["John 3:16", "Philippians 4:13", "Psalm 23"],
  "translation": "kjv"
}
```

Every input field is optional. With an empty input the actor returns today's verse of the day in the World English Bible.

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `mode` | enum | no | `votd` | `votd` returns today's curated verse of the day. `reference` looks up the reference(s) you provide. |
| `reference` | string | no | (empty) | Used in `reference` mode. One reference: a verse (`John 3:16`), a range (`Romans 8:28-30`), or a chapter (`Psalm 23`). |
| `references` | string\[] | no | (empty) | Used in `reference` mode. A batch of references, one result row each, for example `["John 3:16", "Psalm 23"]`. Combined with `reference`. |
| `translation` | enum | no | `web` | Translation id. One of `web`, `kjv`, `bbe`, `asv`, `darby`, `dra`, `ylt`, `oeb-us`, `webbe`, `almeida` (Portuguese), `clementine` (Latin, partial). |
| `aiDevotional` | boolean | no | `false` | Paid add-on. Adds an AI reflection, practical application, and one-line prayer for the passage. Charged only on a usable result. Disabled for free plans. |
| `maxResults` | integer | no | `10` | Maximum passages to return across the run. In `votd` mode this is a single row. Free Apify plans are capped at 10 per run. |

### Output reference

One dataset item per verse or passage. Types: `string`, `number`, `boolean`, `object[]`, or `null` when a value is absent.

| Field | Type | Description |
|---|---|---|
| `mode` | string | How the row was produced: `votd` or `reference`. |
| `isVerseOfTheDay` | boolean | `true` when this row is today's curated verse of the day. |
| `reference` | string | Canonical reference as resolved, for example `John 3:16` or `Psalms 23`. |
| `requestedReference` | string | The reference exactly as requested in the input. |
| `book` | string | Book name of the first verse, for example `John`. |
| `bookId` | string | Short book id of the first verse, for example `JHN`. |
| `chapter` | number | Chapter number of the first verse. |
| `verseStart` | number | First verse number in the passage. |
| `verseEnd` | number | Last verse number in the passage. |
| `verseCount` | number | Number of verses returned. |
| `text` | string | Full passage text as one clean single-line string. |
| `verses` | object\[] | Structured per-verse output: array of `{book, chapter, verse, text}`. |
| `translationId` | string | Translation identifier, for example `web`, `kjv`, `almeida`. |
| `translationName` | string | Human-readable translation name. |
| `translationNote` | string | Translation license or note, usually `Public Domain`. |
| `wordCount` | number | Word count of the clean passage text. |
| `devotionalReflection` | string | AI reflection on the passage. Null unless the AI devotional add-on is on and succeeds. |
| `devotionalApplication` | string | AI practical daily application. Null unless the add-on is on and succeeds. |
| `devotionalPrayer` | string | AI one-line prayer inspired by the passage. Null unless the add-on is on and succeeds. |
| `source` | string | Data source. |
| `observedAt` | string | ISO 8601 timestamp when the record was collected. |
| `error` | string | `null` on success. On a failed lookup a row with a populated `error` is written and not charged. |

### Example output record

Real record from a live run with `{"mode": "reference", "reference": "Romans 8:28-30", "translation": "kjv"}`:

```json
{
  "mode": "reference",
  "isVerseOfTheDay": false,
  "reference": "Romans 8:28-30",
  "requestedReference": "Romans 8:28-30",
  "book": "Romans",
  "bookId": "ROM",
  "chapter": 8,
  "verseStart": 28,
  "verseEnd": 30,
  "verseCount": 3,
  "text": "And we know that all things work together for good to them that love God, to them who are the called according to his purpose. For whom he did foreknow, he also did predestinate to be conformed to the image of his Son, that he might be the firstborn among many brethren. Moreover whom he did predestinate, them he also called: and whom he called, them he also justified: and whom he justified, them he also glorified.",
  "verses": [
    { "book": "Romans", "chapter": 8, "verse": 28, "text": "And we know that all things work together for good to them that love God, to them who are the called according to his purpose." },
    { "book": "Romans", "chapter": 8, "verse": 29, "text": "For whom he did foreknow, he also did predestinate to be conformed to the image of his Son, that he might be the firstborn among many brethren." },
    { "book": "Romans", "chapter": 8, "verse": 30, "text": "Moreover whom he did predestinate, them he also called: and whom he called, them he also justified: and whom he justified, them he also glorified." }
  ],
  "translationId": "kjv",
  "translationName": "King James Version",
  "translationNote": "Public Domain",
  "wordCount": 74,
  "devotionalReflection": null,
  "devotionalApplication": null,
  "devotionalPrayer": null,
  "source": "bible-api.com",
  "observedAt": "2026-08-23T00:00:00.000Z",
  "error": null
}
```

### How we compare

| Capability | This actor | API.Bible | Ajith Holy Bible (RapidAPI) | They Said So Bible API |
|---|---|---|---|---|
| API key / registration required | No | Yes | Yes (RapidAPI key) | Yes (API key) |
| Verse of the day | Yes, stable per calendar day | Build it yourself | No | Yes |
| Arbitrary verse / range lookup | Yes | Yes | Verse and chapter | Verse lookup |
| Whole chapter lookup | Yes | Yes | Yes | Limited |
| Batch multiple references per call | Yes | One per call | One per call | One per call |
| Multiple translations | Yes, 11 public domain | Many (some paid per version) | KJV | A few |
| Non-English (Portuguese, Latin) | Yes | Depends on license | No | Limited |
| Structured per-verse output | Yes | Yes | Partial | Partial |
| Clean single-line text | Yes | Raw with markup | Raw | Raw |
| AI devotional (reflection, application, prayer) | Yes, optional | No | No | No |
| Export to CSV / Excel / JSON | Yes | JSON only | JSON only | JSON only |

**Why choose this**

- No API key and no registration. Paste a reference and run.
- Verse of the day plus arbitrary reference, range, and whole-chapter lookup in one actor.
- Multiple translations including Portuguese and Latin, not just English.
- Structured per-verse output and clean single-line text, ready for apps and spreadsheets.
- Optional AI devotional turns any verse into a short reflection, a practical application, and a prayer.

### Use cases

- **Verse of the day feature.** Power a daily verse widget, push notification, or email in a devotional app. The same day returns the same verse, so it caches cleanly.
- **Devotional and study apps.** Fetch any passage or chapter on demand in the reader's preferred translation.
- **Content and social scheduling.** Batch a week of references in one run and export to a spreadsheet for a content calendar.
- **Multilingual outreach.** Serve the same passage in English, Portuguese, or Latin.
- **AI-assisted devotionals.** Turn a verse into a ready-to-publish reflection, application, and prayer with the AI add-on.

### Run via API and CLI

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

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~bible-verse-passage-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"reference","references":["John 3:16","Philippians 4:13"],"translation":"web"}'
```

Get today's verse of the day:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~bible-verse-passage-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"votd","translation":"web"}'
```

Apify CLI:

```bash
apify call scrapers_lat/bible-verse-passage-scraper \
  --input '{"mode":"reference","reference":"Psalm 23","translation":"kjv"}'
```

### Fetch results

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

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

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

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

### Billing and limits

- **Pay per result.** You are charged per verse or passage returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/bible-verse-passage-scraper/pricing) for the current per-result price.
- **AI devotional add-on.** Off by default. When on, it is charged only when the AI returns a usable devotional. Disabled for free plans.
- **No charge on failure.** A bad reference or source error writes a single item with a populated `error` field and is not charged. Empty runs cost nothing.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 results per run and cannot use the paid add-on. Upgrade for higher `maxResults`.

### FAQ and troubleshooting

**Is the verse of the day an official reading?**
No. It is our own curated rotation of well-known encouraging passages, chosen deterministically by calendar day so it is stable and cacheable. It is not a liturgical or lectionary reading.

**A reference returned an error. Why?**
The reference could not be found in the chosen translation. Check the book, chapter, and verse spelling, or try another translation. Some public-domain translations (for example the Latin `clementine`) do not cover every book. Not-found lookups are not charged.

**How do I look up a whole chapter?**
Set `mode` to `reference` and pass just the book and chapter, for example `Psalm 23` or `Romans 8`.

**Can I get several passages in one run?**
Yes. Use `reference` mode and pass a `references` array. Each reference returns one result row.

**Which translations are non-English?**
`almeida` is Portuguese and `clementine` is the Latin Vulgate. The rest are English. All are public domain.

**Is this an official Bible app or publisher tool?**
No. This actor is independent and reads only public-domain Bible text. It has no affiliation with any Bible publisher or app.

### Related scrapers

- [openFDA Food Recall & Enforcement Scraper](https://apify.com/scrapers_lat/openfda-food-recalls-scraper): US food recalls and enforcement reports.
- [DeFi Yield Pools Scraper](https://apify.com/scrapers_lat/defi-yield-pools-scraper): live APY, TVL and yield-pool data across chains.

### More scrapers at scrapers.lat

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

***

> Independent tool. Reads only public-domain Bible text. Not affiliated with any Bible publisher or app. The verse of the day is a curated rotation, not an official liturgical reading.

# Actor input Schema

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

votd = return today's verse of the day (a stable curated verse chosen by calendar day). reference = look up the specific reference(s) you provide below.

## `reference` (type: `string`):

Used when mode = reference. A single Bible reference: a verse (e.g. "John 3:16"), a range (e.g. "Romans 8:28-30"), or a whole chapter (e.g. "Psalm 23"). Ignored in votd mode.

## `references` (type: `array`):

Used when mode = reference. Look up several references in one run, e.g. \["John 3:16", "Philippians 4:13", "Psalm 23"]. Each returns one result row. Combined with the single Reference field above.

## `translation` (type: `string`):

Bible translation to return. web = World English Bible (default). Non-English: almeida (Portuguese), clementine (Latin Vulgate, partial coverage). Some public-domain translations do not cover every book.

## `aiDevotional` (type: `boolean`):

Use AI to add a short reflection, a practical daily application and a one-line prayer based on the verse or passage. Charged only when a usable devotional is returned. Disabled on free plans.

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

Maximum number of passages to return across the run. In votd mode this is a single row; in reference mode it caps the batch. Free Apify plans are capped at 10 per run.

## Actor input object example

```json
{
  "mode": "votd",
  "translation": "web",
  "aiDevotional": false,
  "maxResults": 10
}
```

# Actor output Schema

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

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/bible-verse-passage-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 = { "maxResults": 10 }

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

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

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

```

## CLI example

```bash
echo '{
  "maxResults": 10
}' |
apify call scrapers_lat/bible-verse-passage-scraper --silent --output-dataset

```

## MCP server setup

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

```

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

## OpenAPI specification

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