> ## 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 the Works > Natural-language search across the Bible and the other works, or one work with `work`. The list holds the 100 nearest chunks (a chunk is a few verses, about one Urantia paragraph long); each has `similarity` and `strength` (strong, related, weak), and `meta.total` is the length of that list, and `meta.related` counts those that are related or better. A reference gives those units with no vector. Each result carries its nearest Urantia paragraphs (`urantiaParallelLimit`, 0 to 10, default 3). **The Urantia parallels are semantic, not curated.** They show the paragraphs closest in meaning by embedding similarity. They do not claim that two teachings are the same. Accepts query parameters instead of a JSON body. ## OpenAPI ````yaml GET /works/search/semantic openapi: 3.1.0 info: title: Urantia Papers API version: 1.0.0 description: >- An API and MCP server for the Urantia Papers. Structured access to all 197 papers and more than 14,500 paragraphs, with full-text and semantic search, named entities, cross-references to public domain texts of the world's religions, and audio. No key needed. Docs: https://docs.urantia.dev termsOfService: https://docs.urantia.dev/terms-of-service contact: name: urantia.dev url: https://docs.urantia.dev/help email: kelson@urantia.dev license: name: MIT url: https://github.com/urantia-hub/urantia-dev-api/blob/main/LICENSE servers: - url: https://api.urantia.dev description: Production - url: http://localhost:3000 description: Local development security: [] paths: /works/search/semantic: get: tags: - Works summary: Semantic search across the works (GET) description: >- Natural-language search across the Bible and the other works, or one work with `work`. The list holds the 100 nearest chunks (a chunk is a few verses, about one Urantia paragraph long); each has `similarity` and `strength` (strong, related, weak), and `meta.total` is the length of that list, and `meta.related` counts those that are related or better. A reference gives those units with no vector. Each result carries its nearest Urantia paragraphs (`urantiaParallelLimit`, 0 to 10, default 3). **The Urantia parallels are semantic, not curated.** They show the paragraphs closest in meaning by embedding similarity. They do not claim that two teachings are the same. Accepts query parameters instead of a JSON body. operationId: searchWorksSemanticGet parameters: - schema: type: string minLength: 1 maxLength: 500 required: true name: q in: query - schema: type: string description: 'One work only: "bible" or a work id such as "dhammapada".' required: false description: 'One work only: "bible" or a work id such as "dhammapada".' name: work in: query - schema: type: - integer - 'null' minimum: 0 default: 0 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 100 default: 20 required: false name: limit in: query - schema: type: - integer - 'null' minimum: 0 maximum: 10 default: 3 required: false name: urantiaParallelLimit in: query responses: '200': description: Search results content: application/json: schema: type: object properties: data: type: array items: type: object properties: work: type: object properties: id: type: string title: type: string tradition: type: string required: - id - title - tradition reference: type: string description: >- "John 3:16", "Dhp 183", "BG 2.47-49" (a chunk in semantic search). text: type: string url: type: - string - 'null' description: The public page that holds the text, or null. match: type: string enum: - reference - exact - all - near description: 'Keyword search: how it matched.' similarity: type: number description: 'Semantic search: cosine similarity.' strength: type: string enum: - strong - related - weak description: >- How close the result is: strong (most right answers score this), related, or weak (likely off the topic). urantiaParallels: type: array items: type: object properties: standardReferenceId: type: string paperTitle: type: string sectionTitle: type: - string - 'null' text: type: string similarity: type: number rank: type: integer required: - standardReferenceId - paperTitle - sectionTitle - text - similarity - rank description: >- The nearest Urantia paragraphs (semantic parallels, not curated ones). required: - work - reference - text - url - urantiaParallels meta: type: object properties: page: type: integer limit: type: integer total: type: integer totalPages: type: integer didYouMean: type: string related: type: integer description: >- Semantic search only: how many results of the list are related or better. required: - page - limit - total - totalPages required: - data - meta example: data: - work: id: dhammapada title: The Dhammapada tradition: Buddhist reference: Dhp 3-5 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. url: >- https://www.gutenberg.org/cache/epub/2017/pg2017-images.html#:~:text=those%20who%20harbour%20such similarity: 0.663218010380599 strength: strong urantiaParallels: - standardReferenceId: '131:3.6' 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 - standardReferenceId: '140:8.5' paperTitle: The Ordination of the Twelve sectionTitle: Thursday Afternoon on the Lake text: >- He never ceased to warn his disciples against the evil practice of retaliation; he made no allowance for revenge, the idea of getting even. He deplored the holding of grudges. He disallowed the idea of an eye for an eye and a tooth for a tooth. He discountenanced the whole concept of private and personal revenge, assigning these matters to civil government, on the one hand, and to the judgment of God, on the other. He made it clear to the three that his teachings applied to the individual, not the state. He summarized his instructions up to that time regarding these matters, as: similarity: 0.401049 rank: 2 - work: id: bible title: The Bible (World English Bible) tradition: Jewish and Christian reference: Proverbs 10:12 text: Hatred stirs up strife, but love covers all wrongs. url: https://ebible.org/eng-web/PRO10.htm#V12 similarity: 0.50763853796286 strength: weak urantiaParallels: - standardReferenceId: '131:2.11' paperTitle: The World’s Religions sectionTitle: Judaism text: >- “Love your neighbor as yourself; bear a grudge against no man. Whatsoever you hate do to no man. Love your brother, for the Lord has said: ‘I will love my children freely.’ The path of the just is as a shining light which shines more and more until the perfect day. They who are wise shall shine as the brightness of the firmament and they who turn many to righteousness as the stars forever and ever. Let the wicked forsake his evil way and the unrighteous man his rebellious thoughts. Says the Lord: ‘Let them return to me, and I will have mercy on them; I will abundantly pardon.’ similarity: 0.491502 rank: 1 - standardReferenceId: '54:5.5' paperTitle: Problems of the Lucifer Rebellion sectionTitle: The Wisdom of Delay text: >- 4. While wrongdoing is always deleterious to a family, wisdom and love admonish the upright children to bear with an erring brother during the time granted by the affectionate father in which the sinner may see the error of his way and embrace salvation. similarity: 0.466579 rank: 2 meta: page: 0 limit: 2 total: 100 totalPages: 50 related: 1 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 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' '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.