# Urantia Papers

> Read and search The Urantia Book through the free Urantia Papers API from urantia.dev. Look up any of its 14,500 paragraphs by reference, pull a random one for a daily quote, read a whole paper, search by words or by meaning, explore its index of named beings, places and concepts, check a quotation, format a citation, and compare passages with the Bible and nine texts of the world's religions.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/urantia-papers

## Actions

### Check a quote

Check whether a quotation is really in the Urantia Papers. It says whether it is word for word, close or not found, where it is, the exact wording and every word that differs. Case and punctuation are ignored. A quote needs at least four words and must fall within one paragraph.

**Inputs**

- Quote (`quote_text`, text, required): The quotation to check.
- Claimed paragraph (`reference`, text): The reference the quote is attributed to, like 2:5.1, to check that too. Leave empty if there isn't one.

**Outputs**

- `also_found_at` (text)
- `claimed_reference` (text)
- `claimed_reference_exists` (true/false)
- `claimed_reference_verdict` (text)
- `difference_count` (number)
- `differences` (text)
- `is_exact` (true/false)
- `is_found` (true/false)
- `matched_text` (text)
- `paper_title` (text)
- `reference` (text): Where it is, or the nearest paragraph.
- `section_title` (text)
- `similarity` (number)
- `summary` (text)
- `verdict` (text): exact, close or not_found.

**Example output**

```json
{
  "also_found_at": "",
  "claimed_reference": "2:5.1",
  "claimed_reference_exists": true,
  "claimed_reference_verdict": "close",
  "difference_count": 1,
  "differences": "'enough' is 'sufficiently' in the text",
  "is_exact": false,
  "is_found": true,
  "matched_text": "The Father loves us sufficiently to bestow his life upon us",
  "paper_title": "The Nature of God",
  "reference": "2:5.1",
  "section_title": "The Love of God",
  "similarity": 0.909,
  "summary": "Found, with small differences in wording.",
  "verdict": "close"
}
```

### Cite a paragraph

Get a ready-made citation for a paragraph in APA, MLA, Chicago or BibTeX style.

**Inputs**

- Paragraph (`reference`, text, required): The paragraph's reference: paper, then section, then paragraph, like 1:0.1 (paper 1, section 0, paragraph 1). Every result here reports one, so it usually comes from an earlier step.
- Style (`style`, text): The citation style. One of: `apa`, `mla`, `chicago`, `bibtex`. Default: `apa`.

**Outputs**

- `citation` (text)
- `reference` (text)
- `style` (text)

**Example output**

```json
{
  "citation": "The Urantia Book. (1955). Urantia Foundation. Paper 1, Section 0, Paragraph 1.",
  "reference": "1:0.1",
  "style": "apa"
}
```

### Find Urantia parallels to a Bible verse

Get the ten Urantia paragraphs closest in meaning to a Bible verse, closest first. These are matches by meaning, not claims that the two teach the same thing.

**Inputs**

- Book (`book`, text, required): Which book of the Bible.
- Chapter (`chapter`, number, required): The chapter number. From 1 to 150.
- Verse (`verse`, number, required): The verse number. From 1 to 200.

**Outputs**

- `compared_passage` (text)
- `parallel_count` (number)
- `parallels` (list)
- `reference` (text)
- `top_parallel_reference` (text)
- `top_parallel_text` (text)
- `verse_text` (text)

**Example output**

```json
{
  "compared_passage": "John 3:10-21",
  "parallel_count": 1,
  "parallels": [
    {
      "paper_number": 142,
      "paper_title": "The Passover at Jerusalem",
      "reference": "142:6.6",
      "section_title": "The Visit with Nicodemus",
      "similarity": 0.7,
      "text": "Nicodemus replied: \u201cBut I do not understand, how can that be?\u201d"
    }
  ],
  "reference": "John 3:16",
  "top_parallel_reference": "142:6.6",
  "top_parallel_text": "Nicodemus replied: \u201cBut I do not understand, how can that be?\u201d",
  "verse_text": "For God so loved the world, that he gave his only born Son, that whoever believes in him should not perish, but have eternal life."
}
```

### Find Urantia parallels to a world religions passage

Get the ten Urantia paragraphs closest in meaning to one passage of a world religion's text, closest first. These are matches by meaning, not claims that the two teach the same thing.

**Inputs**

- Text (`scripture`, text, required): Which world religion's text: the Bhagavad Gita, the Dhammapada, the Tao Te Ching, the Analects, the Koran and others.
- Passage (`reference`, text, required): One passage: chapter and verse with a dot, like 2.47. The Dhammapada, the Japji and the Shinto Oracles use one number (183), and Epictetus uses three (3.22.5).

**Outputs**

- `compared_passage` (text)
- `parallel_count` (number)
- `parallels` (list)
- `passage_text` (text)
- `reference` (text)
- `religion` (text)
- `scripture_title` (text)
- `top_parallel_reference` (text)
- `top_parallel_text` (text)
- `translation_year` (number)
- `translator` (text)
- `urantia_section` (text): The section of the Urantia Papers about this religion.

**Example output**

```json
{
  "compared_passage": "TTC 1",
  "parallel_count": 1,
  "parallels": [
    {
      "paper_number": 131,
      "paper_title": "The World\u2019s Religions",
      "reference": "131:8.2",
      "section_title": "Taoism",
      "similarity": 0.52,
      "text": "How pure and tranquil is the Supreme One and yet how powerful and mighty."
    }
  ],
  "passage_text": "The Tao that can be trodden is not the enduring and unchanging Tao.",
  "reference": "TTC 1.1",
  "religion": "Taoism",
  "scripture_title": "The Tao Te Ching",
  "top_parallel_reference": "131:8.2",
  "top_parallel_text": "How pure and tranquil is the Supreme One and yet how powerful and mighty.",
  "translation_year": 1891,
  "translator": "James Legge",
  "urantia_section": "131:8"
}
```

### Find where a name is mentioned

Get the paragraphs that mention a named being, place or concept, in the order they appear in the book.

**Inputs**

- Name (`entity_id`, text, required): The entry's id, such as universal-father. Search names returns it as 'entity_id'; typing the name itself, like Universal Father, works too.
- Number of paragraphs (`limit`, number): How many paragraphs to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.

**Outputs**

- `entity_id` (text)
- `paragraph_count` (number)
- `paragraphs` (list)
- `total_mentions` (number)

**Example output**

```json
{
  "entity_id": "universal-father",
  "paragraph_count": 1,
  "paragraphs": [
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.1",
      "section_number": 0,
      "section_title": null,
      "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
    }
  ],
  "total_mentions": 404
}
```

### Get a Bible passage

Get a verse, or a whole chapter, from the World English Bible, a public domain translation.

**Inputs**

- Book (`book`, text, required): Which book of the Bible.
- Chapter (`chapter`, number, required): The chapter number. From 1 to 150.
- Verse (`verse`, number): The verse number. Leave empty for the whole chapter. From 1 to 200.

**Outputs**

- `book_name` (text)
- `chapter` (number)
- `reference` (text)
- `testament` (text)
- `text` (text)
- `translation` (text)
- `verse_count` (number)
- `verses` (list)

**Example output**

```json
{
  "book_name": "John",
  "chapter": 3,
  "reference": "John 3:16",
  "testament": "New Testament",
  "text": "For God so loved the world, that he gave his only born Son, that whoever believes in him should not perish, but have eternal life.",
  "translation": "World English Bible",
  "verse_count": 1,
  "verses": [
    {
      "reference": "John 3:16",
      "text": "For God so loved the world, that he gave his only born Son, that whoever believes in him should not perish, but have eternal life.",
      "verse": 16
    }
  ]
}
```

### Get a paper

Get a whole paper: its sections, every paragraph, the full text in one piece, and links to an audio narration and video of the paper.

**Inputs**

- Paper (`paper`, text, required): Which paper: the Foreword or one of papers 1 to 196.

**Outputs**

- `audio_url` (text)
- `full_text` (text)
- `paper_number` (number)
- `paragraph_count` (number)
- `paragraphs` (list)
- `part_number` (number)
- `part_title` (text)
- `section_count` (number)
- `sections` (list)
- `title` (text)
- `topics` (text)
- `video_url` (text)

**Example output**

```json
{
  "audio_url": "https://cdn.urantia.dev/audio/eng/papers/1.mp3",
  "full_text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder.\n\nThe Universal Father is the explanation of universal creation; he is the first cause, the eternal source.",
  "paper_number": 1,
  "paragraph_count": 2,
  "paragraphs": [
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.1",
      "section_number": 0,
      "section_title": null,
      "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
    },
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.2.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 2,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.2",
      "section_number": 0,
      "section_title": null,
      "text": "The Universal Father is the explanation of universal creation; he is the first cause, the eternal source."
    }
  ],
  "part_number": 1,
  "part_title": "The Central and Superuniverses",
  "section_count": 1,
  "sections": [
    {
      "first_reference": "1:0.1",
      "paragraph_count": 2,
      "section_number": 0,
      "title": "Introduction"
    }
  ],
  "title": "The Universal Father",
  "topics": "Spirituality, Theology, Philosophy",
  "video_url": "https://video.urantiahub.com/tts-1-hd-nova-1.mp4"
}
```

### Get a paragraph

Get one paragraph of the Urantia Papers by its reference, such as 1:0.1, with its paper and section, a link to an audio narration, the names it mentions, and the references of the paragraphs before and after it.

**Inputs**

- Paragraph (`reference`, text, required): The paragraph's reference: paper, then section, then paragraph, like 1:0.1 (paper 1, section 0, paragraph 1). Every result here reports one, so it usually comes from an earlier step.

**Outputs**

- `next_reference` (text)
- `paragraph` (object)
- `previous_reference` (text)

**Example output**

```json
{
  "next_reference": "1:0.2",
  "paragraph": {
    "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
    "mention_names": "Creator Sons, monotheism, Universal Father",
    "mentions": [
      {
        "entity_id": "creator-sons",
        "name": "Creator Sons",
        "type": "order"
      },
      {
        "entity_id": "monotheism",
        "name": "monotheism",
        "type": "religion"
      },
      {
        "entity_id": "universal-father",
        "name": "Universal Father",
        "type": "being"
      }
    ],
    "paper_number": 1,
    "paper_title": "The Universal Father",
    "paragraph_number": 1,
    "part_number": 1,
    "part_title": "The Central and Superuniverses",
    "reference": "1:0.1",
    "section_number": 0,
    "section_title": null,
    "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
  },
  "previous_reference": null
}
```

### Get a paragraph with its context

Get a paragraph together with the paragraphs around it, as a list and as one combined text, so a quote can be read in context or handed to an AI step.

**Inputs**

- Paragraph (`reference`, text, required): The paragraph's reference: paper, then section, then paragraph, like 1:0.1 (paper 1, section 0, paragraph 1). Every result here reports one, so it usually comes from an earlier step.
- Paragraphs on each side (`window`, number): How many paragraphs to include before and after, from 1 to 10. Defaults to 2. From 1 to 10. Default: `2`.

**Outputs**

- `combined_text` (text)
- `first_reference` (text)
- `last_reference` (text)
- `paragraph` (object)
- `paragraphs_after` (number)
- `paragraphs_before` (number)
- `passage` (list)

**Example output**

```json
{
  "combined_text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder.\n\nThe Universal Father is the explanation of universal creation; he is the first cause, the eternal source.",
  "first_reference": "1:0.1",
  "last_reference": "1:0.2",
  "paragraph": {
    "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
    "paper_number": 1,
    "paper_title": "The Universal Father",
    "paragraph_number": 1,
    "part_number": 1,
    "part_title": "The Central and Superuniverses",
    "reference": "1:0.1",
    "section_number": 0,
    "section_title": null,
    "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
  },
  "paragraphs_after": 1,
  "paragraphs_before": 0,
  "passage": [
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.1",
      "section_number": 0,
      "section_title": null,
      "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
    },
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.2.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 2,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.2",
      "section_number": 0,
      "section_title": null,
      "text": "The Universal Father is the explanation of universal creation; he is the first cause, the eternal source."
    }
  ]
}
```

### Get a random paragraph

Get a paragraph picked at random, for a daily quote or reading. Set a length range to keep it short enough to post.

**Inputs**

- Shortest length (`min_length`, number): Only pick a paragraph at least this many characters long. Leave empty for no minimum. From 1 to 10000.
- Longest length (`max_length`, number): Only pick a paragraph at most this many characters long. 280 fits a post on X. Leave empty for no maximum. From 1 to 10000.

**Outputs**

- `next_reference` (text)
- `paragraph` (object)
- `previous_reference` (text)

**Example output**

```json
{
  "next_reference": "1:0.2",
  "paragraph": {
    "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
    "mention_names": "Creator Sons, monotheism, Universal Father",
    "mentions": [
      {
        "entity_id": "creator-sons",
        "name": "Creator Sons",
        "type": "order"
      },
      {
        "entity_id": "monotheism",
        "name": "monotheism",
        "type": "religion"
      },
      {
        "entity_id": "universal-father",
        "name": "Universal Father",
        "type": "being"
      }
    ],
    "paper_number": 1,
    "paper_title": "The Universal Father",
    "paragraph_number": 1,
    "part_number": 1,
    "part_title": "The Central and Superuniverses",
    "reference": "1:0.1",
    "section_number": 0,
    "section_title": null,
    "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
  },
  "previous_reference": null
}
```

### Get a share image

Get a link to a 1200 by 630 picture of a paragraph, sized for link previews and social posts.

**Inputs**

- Paragraph (`reference`, text, required): The paragraph's reference: paper, then section, then paragraph, like 1:0.1 (paper 1, section 0, paragraph 1). Every result here reports one, so it usually comes from an earlier step.
- Colour (`theme`, text): The picture's colour scheme. One of: `default` (Blue), `warm` (Amber), `purple`, `minimal`. Default: `default`.

**Outputs**

- `height` (number)
- `image_url` (text)
- `reference` (text)
- `theme` (text)
- `width` (number)

**Example output**

```json
{
  "height": 630,
  "image_url": "https://api.urantia.dev/og/1:0.1",
  "reference": "1:0.1",
  "theme": "default",
  "width": 1200
}
```

### Get a world religions passage

Get a passage, a short range of up to 50, or a whole chapter from one of nine public domain texts of the world's religions, such as the Bhagavad Gita or the Tao Te Ching.

**Inputs**

- Text (`scripture`, text, required): Which world religion's text: the Bhagavad Gita, the Dhammapada, the Tao Te Ching, the Analects, the Koran and others.
- Passage (`reference`, text, required): Chapter and verse with a dot, like 2.47. The Dhammapada, the Japji and the Shinto Oracles use one number (183), and Epictetus uses three (3.22.5). A range like 2.47-49 or a chapter number alone returns several passages.

**Outputs**

- `passage_count` (number)
- `passage_text` (text)
- `passages` (list)
- `reference` (text)
- `religion` (text)
- `scripture_title` (text)
- `translation_year` (number)
- `translator` (text)
- `urantia_section` (text): The section of the Urantia Papers about this religion.

**Example output**

```json
{
  "passage_count": 1,
  "passage_text": "Thy business is with the action only, never with its fruits.",
  "passages": [
    {
      "chapter": 2,
      "chapter_title": null,
      "reference": "BG 2.47",
      "text": "Thy business is with the action only, never with its fruits."
    }
  ],
  "reference": "BG 2.47",
  "religion": "Hinduism",
  "scripture_title": "The Bhagavad Gita",
  "translation_year": 1922,
  "translator": "Annie Besant (4th edition)",
  "urantia_section": "131:4"
}
```

### List papers

List the papers of The Urantia Book in order, with their part, topics and a narrated video, either all 197 or one part.

**Inputs**

- Part (`part`, text): Which part of the book to list. One of: `any` (The whole book), `0` (Foreword), `1` (Part 1: The Central and Superuniverses), `2` (Part 2: The Local Universe), `3` (Part 3: The History of Urantia), `4` (Part 4: The Life and Teachings of Jesus). Default: `any`.

**Outputs**

- `paper_count` (number)
- `papers` (list)
- `part_number` (number)
- `part_title` (text)

**Example output**

```json
{
  "paper_count": 1,
  "papers": [
    {
      "paper_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "title": "The Universal Father",
      "topics": "Spirituality, Theology, Philosophy",
      "video_minutes": 39,
      "video_url": "https://video.urantiahub.com/tts-1-hd-nova-1.mp4"
    }
  ],
  "part_number": 1,
  "part_title": "The Central and Superuniverses"
}
```

### Look up a name

Get the index entry for one named being, place or concept: what it is, what else it is called, related names and how often the book mentions it.

**Inputs**

- Name (`entity_id`, text, required): The entry's id, such as universal-father. Search names returns it as 'entity_id'; typing the name itself, like Universal Father, works too.

**Outputs**

- `entity` (object)

**Example output**

```json
{
  "entity": {
    "also_called": "",
    "description": "The First Person of Deity, the First Source and Center of all reality, creator and controller of the universe of universes.",
    "entity_id": "universal-father",
    "mention_count": 404,
    "name": "Universal Father",
    "see_also": "God, I AM, Infinite, personality circuit, Thought Adjusters",
    "type": "being",
    "type_label": "Beings and personalities"
  }
}
```

### Search by meaning

Ask a question or describe an idea in your own words and get the paragraphs closest in meaning, even when they use different words. Each result has a similarity from 0 to 1.

**Inputs**

- Question or idea (`query`, text, required): What you want to read about, in plain words.
- Only in paper (`paper`, text): Search only this paper. Leave empty to search the whole book.
- Only in part (`part`, text): Search only one of the book's four parts, or the Foreword. One of: `any` (The whole book), `0` (Foreword), `1` (Part 1: The Central and Superuniverses), `2` (Part 2: The Local Universe), `3` (Part 3: The History of Urantia), `4` (Part 4: The Life and Teachings of Jesus). Default: `any`.
- Number of results (`limit`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.

**Outputs**

- `paper_number` (number)
- `part_number` (number)
- `query` (text)
- `result_count` (number)
- `results` (list)

**Example output**

```json
{
  "paper_number": null,
  "part_number": null,
  "query": "Who is God?",
  "result_count": 1,
  "results": [
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.1",
      "section_number": 0,
      "section_title": null,
      "similarity": 0.62,
      "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
    }
  ]
}
```

### Search names

Search the book's index of more than 4,000 named beings, places, orders, races, religions and concepts, each with a short description and how often it is mentioned.

**Inputs**

- Name contains (`query`, text): Part of a name or alias. Leave empty to browse.
- Kind (`entity_type`, text): Only return one kind of name. One of: `any` (Any kind), `being` (Beings and personalities), `order` (Orders of beings), `place` (Places), `race` (Races and peoples), `religion` (Religions), `concept` (Concepts). Default: `any`.
- Number of results (`limit`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.

**Outputs**

- `entities` (list)
- `entity_count` (number)
- `entity_type` (text)
- `query` (text)
- `total_matches` (number)

**Example output**

```json
{
  "entities": [
    {
      "also_called": "",
      "description": "The First Person of Deity, the First Source and Center of all reality, creator and controller of the universe of universes.",
      "entity_id": "universal-father",
      "mention_count": 404,
      "name": "Universal Father",
      "see_also": "God, I AM, Infinite, personality circuit, Thought Adjusters",
      "type": "being",
      "type_label": "Beings and personalities"
    }
  ],
  "entity_count": 1,
  "entity_type": "any",
  "query": "universal father",
  "total_matches": 1
}
```

### Search the Bible by meaning

Find Bible passages closest in meaning to a question or idea, each with the Urantia paragraphs closest to it.

**Inputs**

- Question or idea (`query`, text, required): What you want to find, in plain words.
- Testament (`testament`, text): Search the whole Bible or one part of it. One of: `any` (Whole Bible), `ot` (Old Testament), `nt` (New Testament), `deuterocanon`. Default: `any`.
- Only in book (`book`, text): Search only this book. Leave empty for all of them.
- Number of results (`limit`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Urantia parallels per result (`parallels`, number): How many of the closest Urantia paragraphs to attach to each result, from 0 to 10. Defaults to 3. From 0 to 10. Default: `3`.

**Outputs**

- `query` (text)
- `result_count` (number)
- `results` (list)

**Example output**

```json
{
  "query": "love your enemies",
  "result_count": 1,
  "results": [
    {
      "book_name": "Luke",
      "chapter": 6,
      "parallels": [
        {
          "paper_number": 140,
          "paper_title": "The Ordination of the Twelve",
          "reference": "140:3.15",
          "section_title": "The Ordination Sermon",
          "similarity": 0.761,
          "text": "I say to you: Love your enemies, do good to those who hate you."
        }
      ],
      "reference": "Luke 6:27-30",
      "similarity": 0.541,
      "testament": "New Testament",
      "text": "But I tell you who hear: love your enemies, do good to those who hate you.",
      "top_parallel_reference": "140:3.15",
      "top_parallel_text": "I say to you: Love your enemies, do good to those who hate you."
    }
  ]
}
```

### Search the text

Find the paragraphs that contain some words or an exact phrase, best match first, across the whole book or one paper or part. A search that finds nothing returns no results rather than failing.

**Inputs**

- Search for (`query`, text, required): The words or phrase to look for.
- Match (`match`, text): Whether a paragraph needs every word, any word, or the exact phrase. One of: `all` (All the words), `any` (Any of the words), `phrase` (The exact phrase). Default: `all`.
- Only in paper (`paper`, text): Search only this paper. Leave empty to search the whole book.
- Only in part (`part`, text): Search only one of the book's four parts, or the Foreword. One of: `any` (The whole book), `0` (Foreword), `1` (Part 1: The Central and Superuniverses), `2` (Part 2: The Local Universe), `3` (Part 3: The History of Urantia), `4` (Part 4: The Life and Teachings of Jesus). Default: `any`.
- Number of results (`limit`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.

**Outputs**

- `match` (text)
- `paper_number` (number)
- `part_number` (number)
- `query` (text)
- `result_count` (number)
- `results` (list)
- `total_matches` (number)

**Example output**

```json
{
  "match": "all",
  "paper_number": null,
  "part_number": null,
  "query": "universal father",
  "result_count": 1,
  "results": [
    {
      "audio_url": "https://cdn.urantia.dev/audio/eng/paragraphs/nova/tts-1-hd-nova-1:1.0.1.mp3",
      "paper_number": 1,
      "paper_title": "The Universal Father",
      "paragraph_number": 1,
      "part_number": 1,
      "part_title": "The Central and Superuniverses",
      "reference": "1:0.1",
      "section_number": 0,
      "section_title": null,
      "text": "THE Universal Father is the God of all creation, the First Source and Center of all things and beings. First think of God as a creator, then as a controller, and lastly as an infinite upholder."
    }
  ],
  "total_matches": 1210
}
```

### Search world religions texts by meaning

Find passages in the world religions texts closest in meaning to a question or idea, each with the Urantia paragraphs closest to it.

**Inputs**

- Question or idea (`query`, text, required): What you want to find, in plain words.
- Only in text (`scripture`, text): Search only this text. Leave empty for all of them.
- Number of results (`limit`, number): How many results to return, from 1 to 50. Defaults to 10. From 1 to 50. Default: `10`.
- Urantia parallels per result (`parallels`, number): How many of the closest Urantia paragraphs to attach to each result, from 0 to 10. Defaults to 3. From 0 to 10. Default: `3`.

**Outputs**

- `query` (text)
- `result_count` (number)
- `results` (list)

**Example output**

```json
{
  "query": "hatred ceases by love",
  "result_count": 1,
  "results": [
    {
      "parallels": [
        {
          "paper_number": 131,
          "paper_title": "The World\u2019s Religions",
          "reference": "131:3.6",
          "section_title": "Buddhism",
          "similarity": 0.412,
          "text": "Pay good for evil; overcome evil with the good."
        }
      ],
      "reference": "Dhp 3-5",
      "religion": "Buddhism",
      "scripture_title": "The Dhammapada",
      "similarity": 0.599,
      "text": "For hatred does not cease by hatred at any time: hatred ceases by love, this is an old rule.",
      "top_parallel_reference": "131:3.6",
      "top_parallel_text": "Pay good for evil; overcome evil with the good."
    }
  ]
}
```