> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urantia.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Semantic Search Across World Religions Texts

> Natural-language search across every scripture chunk, or one corpus with `corpus`. Each result carries its top Urantia paragraphs (`urantiaParallelLimit`, 0 to 10, default 3). The query is embedded with `text-embedding-3-small` and matched with a pgvector HNSW index.

**These are semantic parallels, not curated ones.** They show the passages closest in meaning by embedding similarity. They do not claim that two teachings are the same.



## OpenAPI

````yaml POST /scriptures/search/semantic
openapi: 3.1.0
info:
  title: Urantia Papers API
  version: 1.0.0
  description: >-
    A developer and AI-agent friendly API for the Urantia Papers. Provides
    full-text search, structured content access, and audio URLs for all 17,000+
    paragraphs across 197 papers.
servers:
  - url: https://api.urantia.dev
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
paths:
  /scriptures/search/semantic:
    post:
      tags:
        - Scriptures
      summary: Semantic search across the world religions texts
      description: >-
        Natural-language search across every scripture chunk, or one corpus with
        `corpus`. Each result carries its top Urantia paragraphs
        (`urantiaParallelLimit`, 0 to 10, default 3). The query is embedded with
        `text-embedding-3-small` and matched with a pgvector HNSW index.


        **These are semantic parallels, not curated ones.** They show the
        passages closest in meaning by embedding similarity. They do not claim
        that two teachings are the same.
      operationId: scriptureSemanticSearch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                  minLength: 1
                  maxLength: 2000
                corpus:
                  type: string
                  minLength: 1
                  maxLength: 64
                  description: >-
                    Corpus id, slug, or ref prefix, e.g. `bhagavad-gita`, `bg`,
                    or `dhammapada`
                page:
                  type: integer
                  minimum: 0
                  default: 0
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 10
                urantiaParallelLimit:
                  type: integer
                  minimum: 0
                  maximum: 10
                  default: 3
              required:
                - q
            example:
              q: hatred ceases by love
              limit: 2
              urantiaParallelLimit: 1
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        chunkId:
                          type: string
                        reference:
                          type: string
                        corpus:
                          type: object
                          properties:
                            id:
                              type: string
                            slug:
                              type: string
                            religion:
                              type: string
                            title:
                              type: string
                            translator:
                              type: string
                            year:
                              type: integer
                            refPrefix:
                              type: string
                            urantiaSection:
                              type:
                                - string
                                - 'null'
                              description: >-
                                The Paper 131 section headed with this religion,
                                or null when Paper 131 has no such heading
                          required:
                            - id
                            - slug
                            - religion
                            - title
                            - translator
                            - year
                            - refPrefix
                            - urantiaSection
                        text:
                          type: string
                        similarity:
                          type: number
                        urantiaParallels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              standardReferenceId:
                                type: string
                              paperId:
                                type: string
                              paperTitle:
                                type: string
                              sectionTitle:
                                type:
                                  - string
                                  - 'null'
                              text:
                                type: string
                              similarity:
                                type: number
                              rank:
                                type: integer
                            required:
                              - id
                              - standardReferenceId
                              - paperId
                              - paperTitle
                              - sectionTitle
                              - text
                              - similarity
                              - rank
                      required:
                        - chunkId
                        - reference
                        - corpus
                        - text
                        - similarity
                        - urantiaParallels
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total:
                        type: integer
                      totalPages:
                        type: integer
                    required:
                      - page
                      - limit
                      - total
                      - totalPages
                required:
                  - data
                  - meta
              example:
                data:
                  - chunkId: dhammapada-muller-1881:Dhp 3
                    reference: Dhp 3-5
                    corpus:
                      id: dhammapada-muller-1881
                      slug: dhammapada
                      religion: Buddhism
                      title: The Dhammapada
                      translator: F. Max Muller
                      year: 1881
                      refPrefix: Dhp
                      urantiaSection: '131:3'
                    text: >-
                      "He abused me, he beat me, he defeated me, he robbed
                      me,"--in those who harbour such thoughts hatred will never
                      cease. "He abused me, he beat me, he defeated me, he
                      robbed me,"--in those who do not harbour such thoughts
                      hatred will cease. For hatred does not cease by hatred at
                      any time: hatred ceases by love, this is an old rule.
                    similarity: 0.599195
                    urantiaParallels:
                      - id: 4:131.3.6
                        standardReferenceId: '131:3.6'
                        paperId: '131'
                        paperTitle: The World’s Religions
                        sectionTitle: Buddhism
                        text: >-
                          “The fool has said in his heart, ‘Evil shall not
                          overtake me’; but safety is found only when the soul
                          craves reproof and the mind seeks wisdom. The wise man
                          is a noble soul who is friendly in the midst of his
                          enemies, tranquil among the turbulent, and generous
                          among the grasping. Love of self is like weeds in a
                          goodly field. Selfishness leads to grief; perpetual
                          care kills. The tamed mind yields happiness. He is the
                          greatest of warriors who overcomes and subdues
                          himself. Restraint in all things is good. He alone is
                          a superior person who esteems virtue and is observant
                          of his duty. Let not anger and hate master you. Speak
                          harshly of no one. Contentment is the greatest wealth.
                          What is given wisely is well saved. Do not to others
                          those things you would not wish done to you. Pay good
                          for evil; overcome evil with the good.
                        similarity: 0.412424
                        rank: 1
                  - chunkId: dhammapada-muller-1881:Dhp 211
                    reference: Dhp 211-213
                    corpus:
                      id: dhammapada-muller-1881
                      slug: dhammapada
                      religion: Buddhism
                      title: The Dhammapada
                      translator: F. Max Muller
                      year: 1881
                      refPrefix: Dhp
                      urantiaSection: '131:3'
                    text: >-
                      Let, therefore, no man love anything; loss of the beloved
                      is evil. Those who love nothing and hate nothing, have no
                      fetters. From pleasure comes grief, from pleasure comes
                      fear; he who is free from pleasure knows neither grief nor
                      fear. From affection comes grief, from affection comes
                      fear; he who is free from affection knows neither grief
                      nor fear.
                    similarity: 0.441808
                    urantiaParallels:
                      - id: 4:131.3.6
                        standardReferenceId: '131:3.6'
                        paperId: '131'
                        paperTitle: The World’s Religions
                        sectionTitle: Buddhism
                        text: >-
                          “The fool has said in his heart, ‘Evil shall not
                          overtake me’; but safety is found only when the soul
                          craves reproof and the mind seeks wisdom. The wise man
                          is a noble soul who is friendly in the midst of his
                          enemies, tranquil among the turbulent, and generous
                          among the grasping. Love of self is like weeds in a
                          goodly field. Selfishness leads to grief; perpetual
                          care kills. The tamed mind yields happiness. He is the
                          greatest of warriors who overcomes and subdues
                          himself. Restraint in all things is good. He alone is
                          a superior person who esteems virtue and is observant
                          of his duty. Let not anger and hate master you. Speak
                          harshly of no one. Contentment is the greatest wealth.
                          What is given wisely is well saved. Do not to others
                          those things you would not wish done to you. Pay good
                          for evil; overcome evil with the good.
                        similarity: 0.475247
                        rank: 1
                meta:
                  page: 0
                  limit: 2
                  total: 2973
                  totalPages: 1487
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '400':
          description: Invalid request
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '429':
          description: Too many requests
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Internal server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
components:
  headers:
    X-RateLimit-Limit:
      description: The number of requests allowed in the current window.
      schema:
        type: integer
      example: 200
    X-RateLimit-Remaining:
      description: The number of requests left in the current window.
      schema:
        type: integer
      example: 199
    X-RateLimit-Reset:
      description: The time the window resets, in Unix seconds.
      schema:
        type: integer
      example: 1791152213
  schemas:
    ProblemDetails:
      type: object
      description: An RFC 9457 problem details object. Every error response uses it.
      properties:
        type:
          type: string
          format: uri
          description: A URI that names the error type.
        title:
          type: string
          description: The short name of the status.
        status:
          type: integer
          description: The HTTP status code.
        detail:
          type: string
          description: What went wrong in this request.
      required:
        - type
        - title
        - status
        - detail
      example:
        type: https://urantia.dev/errors/not-found
        title: Not Found
        status: 404
        detail: Paragraph not found

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.