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

# Semantic Search

> Search the Urantia Papers using semantic similarity (vector embeddings).
Returns conceptually related results even without exact keyword matches.
Optional filters: paperId, partId.



## OpenAPI

````yaml POST /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:
  /search/semantic:
    post:
      tags:
        - Search
      summary: Semantic similarity search across all paragraphs
      description: |-
        Search the Urantia Papers using semantic similarity (vector embeddings).
        Returns conceptually related results even without exact keyword matches.
        Optional filters: paperId, partId.
      operationId: semanticSearch
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                  minLength: 1
                  maxLength: 2000
                page:
                  type: integer
                  minimum: 0
                  default: 0
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                paperId:
                  type: string
                partId:
                  type: string
                include:
                  type: string
              required:
                - q
      responses:
        '200':
          description: Semantic search results with pagination
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        standardReferenceId:
                          type: string
                        sortId:
                          type: string
                        paperId:
                          type: string
                        sectionId:
                          type: string
                          nullable: true
                        partId:
                          type: string
                        paperTitle:
                          type: string
                        sectionTitle:
                          type: string
                          nullable: true
                        paragraphId:
                          type: string
                        text:
                          type: string
                        htmlText:
                          type: string
                        language:
                          type: string
                        labels:
                          type: array
                          nullable: true
                          items:
                            type: string
                        audio:
                          type: object
                          nullable: true
                          additionalProperties:
                            type: object
                            additionalProperties:
                              type: object
                              properties:
                                format:
                                  type: string
                                url:
                                  type: string
                                duration:
                                  type: number
                                bitrate:
                                  type: number
                                fileSize:
                                  type: number
                              required:
                                - format
                                - url
                        entities:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              type:
                                type: string
                                enum:
                                  - being
                                  - place
                                  - order
                                  - race
                                  - religion
                                  - concept
                            required:
                              - id
                              - name
                              - type
                        bibleParallels:
                          type: array
                          items:
                            type: object
                            properties:
                              chunkId:
                                type: string
                              reference:
                                type: string
                              bookCode:
                                type: string
                              chapter:
                                type: integer
                              verseStart:
                                type: integer
                              verseEnd:
                                type: integer
                              text:
                                type: string
                              similarity:
                                type: number
                              rank:
                                type: integer
                              source:
                                type: string
                              embeddingModel:
                                type: string
                            required:
                              - chunkId
                              - reference
                              - bookCode
                              - chapter
                              - verseStart
                              - verseEnd
                              - text
                              - similarity
                              - rank
                              - source
                              - embeddingModel
                        urantiaParallels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              standardReferenceId:
                                type: string
                              paperId:
                                type: string
                              paperTitle:
                                type: string
                              sectionTitle:
                                type: string
                                nullable: true
                              text:
                                type: string
                              similarity:
                                type: number
                              rank:
                                type: integer
                              source:
                                type: string
                              embeddingModel:
                                type: string
                            required:
                              - id
                              - standardReferenceId
                              - paperId
                              - paperTitle
                              - sectionTitle
                              - text
                              - similarity
                              - rank
                              - source
                              - embeddingModel
                        similarity:
                          type: number
                      required:
                        - id
                        - standardReferenceId
                        - sortId
                        - paperId
                        - sectionId
                        - partId
                        - paperTitle
                        - sectionTitle
                        - paragraphId
                        - text
                        - htmlText
                        - labels
                        - audio
                        - similarity
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total:
                        type: integer
                      totalPages:
                        type: integer
                    required:
                      - page
                      - limit
                      - total
                      - totalPages
                required:
                  - data
                  - meta
        '400':
          description: Invalid search query
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail

````