Choose a candidate, then Inspect it before running it. If results do not fit, try different keywords; low scores or the last page do not prove a capability is unavailable.
Required on every search. The use case behind this search: what the user asked for, in their own words, with the subject in it — the company, domain, ticker, place or topic. Shorten a long request rather than rewriting it.
The task this search belongs to. A search without a task_id starts a new task. The response returns its task_id. Send it on every later search, inspect and run of the same piece of work. Any stable string is accepted.
The task this search was recorded against — the one you sent, or a newly minted one if you sent none. Pass it back on every later search, inspect and run for the same piece of work.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Glasser","description":"Give your AI access to company, people, web, places, and market data with one Glasser account.","colors":{"primary":"#111111","light":"#e5e5e5","dark":"#171717"},"favicon":"https://mintcdn.com/glasser/UmKPaCGGjUt13e9p/favicon.svg?fit=max\u0026auto=format\u0026n=UmKPaCGGjUt13e9p\u0026q=85\u0026s=4ef0ba1a35f36c7b2499a657f13f068f","api":{"playground":{"display":"interactive"}},"navbar":{"primary":{"type":"button","label":"Get started","href":"https://app.glasser.ai/get-started?utm_source=docs\u0026utm_medium=navbar"}},"footer":{"socials":{"x":"https://x.com/Glasserai","discord":"https://discord.gg/akfMzXuwkw"}},"contextual":{"options":[{"title":"Ask in ChatGPT","description":"Ask questions about this page","icon":"/images/clients/chatgpt.svg","href":{"base":"https://chatgpt.com/","query":[{"key":"hints","value":"search"},{"key":"q","value":"Read this Glasser documentation page and help me understand how to use it: https://glasser.ai/docs$path"}]}},{"title":"Ask in Claude","description":"Ask questions about this page","icon":"/images/clients/claude.svg","href":{"base":"https://claude.ai/new","query":[{"key":"q","value":"Read this Glasser documentation page and help me understand how to use it: https://glasser.ai/docs$path"}]}},"copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"glasser","hasAudioNarration":false,"actualSubdomain":"glasser","customDomains":["glasser.ai"],"gitSource":{"type":"github","owner":"surething-io","repo":"glasser-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad8652bb8fa20a31550ecbc","collectionId":"a2c417b3-14c5-4dea-a9c9-4b4c6377e03f","liveDeploymentHistoryId":"6ad8652bb8fa20a31550ecbc","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad8652bb8fa20a31550ecbc","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"For AI agents","count":19},{"language":"default","tag":"CLI Reference","count":15},{"language":"default","tag":"Solutions","count":13},{"language":"default","tag":"Set up with MCP","count":10},{"language":"default","tag":"Set up with Skill","count":9},{"language":"default","tag":"Runs","count":8},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Data Sources","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Inter\";font-weight:100 900;font-display:swap;src:url(/docs/fonts/inter-latin.woff2) format(\"woff2\"),url(/fonts/inter-latin.woff2) format(\"woff2\");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:\"Inter\";font-weight:100 900;font-display:swap;src:url(/docs/fonts/inter-latin-ext.woff2) format(\"woff2\"),url(/fonts/inter-latin-ext.woff2) format(\"woff2\");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}body{font-family:\"Inter\",ui-sans-serif,system-ui,sans-serif}.dark .client-card-monochrome img[aria-hidden=true],.dark .glasser-page-actions-menu img[src$=\"/chatgpt.svg\"]{filter:invert(1)}h1{letter-spacing:-.02em}.glasser-page-actions>[id=page-context-menu-button]{display:none}.glasser-page-actions>button[aria-haspopup=menu]{width:auto;aspect-ratio:auto;gap:8px;padding:0 12px;border-radius:10px;font-size:14px;font-weight:500}.glasser-page-actions-menu [data-glasser-page-action=copy]{margin-top:6px}.glasser-page-actions-menu [data-glasser-page-action=copy]::before{content:\"\";position:absolute;top:-4px;left:6px;right:6px;border-top:1px solid currentColor;opacity:.15}.font-mono,[class*=font-mono],[class*=paperMono],code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}.rounded-2xl{border-radius:16px}.rounded-xl{border-radius:14px}.rounded-lg{border-radius:10px}.rounded-md{border-radius:8px}[class*=\"rounded-[10px]\"],[class*=\"rounded-[14px]\"]{border-radius:10px}.tryit-button.tryit-button{background-color:oklch(.1684 0 0);height:32px;padding:0 12px;font-size:14px;line-height:20px;border-radius:8px}.tryit-button.tryit-button:hover{background-color:#262626}.bg-primary-dark{border-radius:9999px!important;background-color:oklch(.1684 0 0)!important}.bg-primary-dark~*,a:has(>.bg-primary-dark){font-size:14px}a:has(>.bg-primary-dark),button:has(>.bg-primary-dark){height:32px;padding:0 12px}[class*=\"bg-green-400/20\"]{background-color:#f5f5f5!important}[class*=text-green-700]{color:oklch(.53 0 0)!important}[class*=\"bg-blue-400/20\"]{background-color:#f5f5f5!important}[class*=text-blue-700]{color:oklch(.1684 0 0)!important}[class*=\"bg-orange-400/20\"],[class*=\"bg-yellow-400/20\"]{background-color:#f5f5f5!important}[class*=text-orange-700],[class*=text-yellow-700]{color:oklch(.1684 0 0)!important}[class*=\"bg-red-400/20\"]{background-color:hsl(357 90.5% 95.9%)!important}[class*=text-red-700]{color:hsl(358 64.8% 49%)!important}.dark [class*=\"bg-green-400/20\"]{background-color:oklch(.269 0 0)!important}.dark [class*=text-green-400]{color:oklch(.708 0 0)!important}.dark [class*=\"bg-blue-400/20\"]{background-color:oklch(.269 0 0)!important}.dark [class*=text-blue-400]{color:#e5e5e5!important}.dark [class*=\"bg-red-400/20\"]{background-color:hsl(350 53.2% 15.1%)!important}.dark [class*=text-red-400]{color:hsl(2 100% 78.6%)!important}[class*=page-header] .prose.text-lg{font-size:16px;line-height:26px;color:oklch(.53 0 0)}.dark [class*=page-header] .prose.text-lg{color:oklch(.708 0 0)}[class*=\"bg-[#3064E3]\"]:not(.tryit-button){background-color:#f5f5f5!important;color:oklch(.1684 0 0)!important}.dark [class*=\"bg-[#3064E3]\"]:not(.tryit-button){background-color:oklch(.269 0 0)!important;color:#e5e5e5!important}.integration-flow{max-width:640px;margin:24px auto}.integration-flow img{display:block;width:100%;height:auto;border-radius:12px}.dark .integration-flow-light,.integration-flow-dark{display:none}.dark .integration-flow-dark{display:block}.integration-map{--map-surface:#fafafa;--map-card:#ffffff;--map-border:#e5e5e5;--map-muted:#737373;--map-accent:#ba5639;--map-accent-surface:#fff7f3;--map-accent-border:#ebc3b7;display:grid;grid-template-columns:minmax(0,1.8fr) minmax(0,1fr);align-items:center;gap:12px;margin:24px 0 32px;padding:24px;border:1px solid var(--map-border);border-radius:16px;background:var(--map-surface);font-size:14px;line-height:1.4}.dark .integration-map{--map-surface:#141414;--map-card:#1c1c1c;--map-border:#303030;--map-muted:#a3a3a3;--map-accent:#e5a18a;--map-accent-surface:#2b1e19;--map-accent-border:#674437}.integration-map-product{min-width:0;padding:16px;border:1px dashed var(--map-border);border-radius:12px}.integration-map-label{display:block;margin-bottom:12px;color:var(--map-muted);font-size:11px;font-weight:500;letter-spacing:.06em;text-transform:uppercase}.integration-map-row{display:grid;grid-template-columns:minmax(0,1fr) 24px minmax(0,1.4fr);align-items:center}.integration-map-node{display:flex;min-width:0;min-height:72px;flex-direction:column;align-items:center;justify-content:center;gap:4px;padding:12px 8px;border:1px solid var(--map-border);border-radius:10px;background:var(--map-card);text-align:center;font-weight:500}.integration-map-node strong{font-weight:600}.integration-map-node>span{color:var(--map-muted);font-size:11px;font-weight:400}.integration-map-glasser{border-color:var(--map-accent-border);background:var(--map-accent-surface)}.integration-map-arrow{color:var(--map-accent);font-size:22px;text-align:center}.integration-map-destinations{display:grid;gap:12px}.integration-map-route{display:grid;grid-template-columns:24px minmax(0,1fr);align-items:center;gap:8px}.integration-map-direct{grid-template-columns:minmax(0,1fr) 24px minmax(0,1fr) 24px minmax(0,1fr)}@media (max-width:540px){.integration-map{grid-template-columns:minmax(0,1fr);gap:12px;padding:16px}.integration-map-destinations{grid-template-columns:repeat(auto-fit,minmax(120px,1fr))}.integration-map-route{grid-template-columns:minmax(0,1fr);gap:8px}.integration-map-direct>.integration-map-arrow,.integration-map-route>.integration-map-arrow{transform:rotate(90deg)}.integration-map-direct .integration-map-node{min-height:60px}}.setup-screenshots{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:start;gap:16px;margin:24px 0}.setup-screenshots>div{min-width:0}.setup-screenshots .frame{margin:0}.setup-screenshots .zoom-image-trigger img{width:auto;height:auto;max-width:100%;max-height:280px}.setup-screenshots figcaption{font-size:12px;line-height:1.5}.setup-screenshots-single{grid-template-columns:minmax(0,1fr);max-width:400px}.setup-screenshots-create>div:last-child{grid-column:2;grid-row:1/span 2}.setup-screenshots-create>div:first-child .zoom-image-trigger img{max-height:180px}.setup-screenshots-create>div:last-child .zoom-image-trigger img{max-height:360px}@media (max-width:640px){.setup-screenshots{grid-template-columns:minmax(0,1fr)}.setup-screenshots-create>div:last-child{grid-column:auto;grid-row:auto}}"}],"page":{"pagePath":"api-reference/endpoints/search","slug":"/api-reference/endpoints/search","pageMetadata":{"title":"Search runnable endpoints","description":"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.","deprecated":null,"version":null,"sidebarTitle":"Search","openapi":"/openapi.json post /v1/endpoints/search","href":"/api-reference/endpoints/search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Choose a candidate, then `,_jsx(_components.a,{href:`/api-reference/endpoints/inspect`,children:`Inspect it`}),` before running it. If results do not fit, try different keywords; low scores or the last page do not prove a capability is unavailable.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search runnable endpoints","description":"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.","deprecated":null,"version":null,"sidebarTitle":"Search","openapi":"/openapi.json post /v1/endpoints/search","href":"/api-reference/endpoints/search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/glasser/edf4f5bdc385b1eb/glasser-analytics.js","/docs/_mintlify/custom/glasser/277549e7f7982383/glasser-page-actions.js"],"openApiReferenceData":{"operation":{"tags":["Endpoints"],"operationId":"endpoints-search","parameters":[],"security":["d28caa1b-7646-405d-8867-7808b30e50a8"],"responses":{"200":"9b12d077-8014-4c1c-8d9f-0d0b408ab47f","400":"c15a7535-a3f8-4c0f-a61e-9882a20eb61b","401":"404c753a-4e76-4701-8c77-6618b460218e","403":"9fdeaf35-400c-4539-a623-b7774e3b9336","429":"bcd9b64c-7b96-4d02-9819-f2138a4ca945"},"description":"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.","summary":"Search runnable endpoints","requestBody":"e3f15617-fc04-44a9-b393-5195ae3d89e2","x-mint":{"metadata":{"title":"Search runnable endpoints","description":"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself."},"content":"Choose a candidate, then [Inspect it](/api-reference/endpoints/inspect) before running it. If results do not fit, try different keywords; low scores or the last page do not prove a capability is unavailable.","href":"/api-reference/endpoints/search"},"method":"post","type":"path","servers":["36bbba50-ad20-4ae2-bf87-c49c583803f7"],"path":"/v1/endpoints/search","baseUrlOptions":["https://api.glasser.ai"],"title":"Search runnable endpoints","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"use_case":{"type":"string","minLength":1,"description":"Required on every search. The use case behind this search: what the user asked for, in their own words, with the subject in it — the company, domain, ticker, place or topic. Shorten a long request rather than rewriting it.","isRequired":true,"uniqueKey":"use_case","typeLabel":"string"},"query":{"oneOf":[{"type":"string","description":"Keywords that describe the data you need. Omit or leave empty to browse all Endpoints allowed by your Key's Policy.","uniqueKey":"query.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"query.oneOf.1","typeLabel":"null"}],"uniqueKey":"query","typeLabel":"string | null"},"limit":{"oneOf":[{"type":"integer","description":"Maximum results per page. Default: 5; maximum: 20.","maximum":20,"minimum":1,"uniqueKey":"limit.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"limit.oneOf.1","typeLabel":"null"}],"uniqueKey":"limit","typeLabel":"integer | null"},"cursor":{"oneOf":[{"type":"string","description":"The next_cursor from the previous response. Use the same query; a cursor from a different query returns 400.","uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"},"task_id":{"oneOf":[{"type":"string","description":"The task this search belongs to. A search without a task_id starts a new task. The response returns its task_id. Send it on every later search, inspect and run of the same piece of work. Any stable string is accepted.","uniqueKey":"task_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"task_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"task_id","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","description":"Optional tracking fields, returned on the Run and available as filters. They never go to the Provider or affect routing, Price, or idempotency.\n\n- Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters.\n- Values: strings of 1–500 characters.\n- user_id: your End user's opaque ID, never their email address or name.\n\nInvalid entries are dropped whole, not truncated. The request continues, and the Run returns the fields that were stored.","maxProperties":20,"additionalProperties":{"type":"string","minLength":1,"maxLength":500,"uniqueKey":"metadata.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"description":"Optional tracking fields, returned on the Run and available as filters. They never go to the Provider or affect routing, Price, or idempotency.\n\n- Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters.\n- Values: strings of 1–500 characters.\n- user_id: your End user's opaque ID, never their email address or name.\n\nInvalid entries are dropped whole, not truncated. The request continues, and the Run returns the fields that were stored.","uniqueKey":"metadata.oneOf.1","typeLabel":"any"},{"type":"null","uniqueKey":"metadata.oneOf.2","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | any | null"}},"required":["use_case"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"use_case":"\u003cstring>","query":"\u003cstring>","limit":10,"cursor":"\u003cstring>","task_id":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"9b12d077-8014-4c1c-8d9f-0d0b408ab47f":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","isRequired":true,"uniqueKey":"data.items.[INDEX].provider","typeLabel":"string"},"provider_label":{"type":"string","description":"The Provider's brand name, for display: \"People Data Labs\" for provider \"pdl\". Identity stays with `provider` — that is the value run and inspect take, and this one is never sent back.","isRequired":true,"uniqueKey":"data.items.[INDEX].provider_label","typeLabel":"string"},"endpoint":{"type":"string","pattern":"^\\/.+$","isRequired":true,"uniqueKey":"data.items.[INDEX].endpoint","typeLabel":"string"},"endpoint_version":{"type":"integer","exclusiveMinimum":0,"description":"Supported Endpoint version. Compatible updates keep this version.","isRequired":true,"uniqueKey":"data.items.[INDEX].endpoint_version","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"data.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.items.[INDEX].tags","typeLabel":"string[]"},"price":{"type":"object","properties":{"rule":{"oneOf":[{"type":"object","required":["type","amount_usd"],"properties":{"type":{"type":"string","enum":["flat"],"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.0.type","typeLabel":"enum\u003cstring>"},"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.0.amount_usd","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.0","typeLabel":"object"},{"type":"object","required":["type","per_result_usd","cap_usd"],"properties":{"type":{"type":"string","enum":["per_result"],"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.1.type","typeLabel":"enum\u003cstring>"},"per_result_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.1.per_result_usd","typeLabel":"string"},"cap_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.1.cap_usd","typeLabel":"string"},"partial_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","uniqueKey":"data.items.[INDEX].price.rule.oneOf.1.partial_usd","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","per_million_input_tokens_usd","cap_usd"],"properties":{"type":{"type":"string","enum":["per_token"],"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.2.type","typeLabel":"enum\u003cstring>"},"per_million_input_tokens_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.2.per_million_input_tokens_usd","typeLabel":"string"},"cap_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.2.cap_usd","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.2","typeLabel":"object"},{"type":"object","required":["type","base_usd","included_results","per_extra_result_usd","cap_usd"],"properties":{"type":{"type":"string","enum":["base_plus_per_result"],"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.type","typeLabel":"enum\u003cstring>"},"base_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.base_usd","typeLabel":"string"},"included_results":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.included_results","typeLabel":"integer"},"per_extra_result_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.per_extra_result_usd","typeLabel":"string"},"cap_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.cap_usd","typeLabel":"string"},"unit":{"type":"string","uniqueKey":"data.items.[INDEX].price.rule.oneOf.3.unit","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.3","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.4.type","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.items.[INDEX].price.rule.oneOf.4.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].price.rule","typeLabel":"object"},"display":{"type":"object","properties":{"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.display.amount_usd","typeLabel":"string"},"unit":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].price.display.unit","typeLabel":"string"},"cap_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","uniqueKey":"data.items.[INDEX].price.display.cap_usd","typeLabel":"string"}},"required":["amount_usd","unit"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.display","typeLabel":"object"},"charges":{"type":"object","properties":{"NO_RESULT":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.charges.NO_RESULT","typeLabel":"string"},"PROVIDER_ERROR":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.charges.PROVIDER_ERROR","typeLabel":"string"},"TIMED_OUT":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.charges.TIMED_OUT","typeLabel":"string"},"INTERNAL":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(\\d{2}|\\d{2}\\d{0,3}[1-9])$","description":"Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.","isRequired":true,"uniqueKey":"data.items.[INDEX].price.charges.INTERNAL","typeLabel":"string"}},"required":["NO_RESULT","PROVIDER_ERROR","TIMED_OUT","INTERNAL"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].price.charges","typeLabel":"object"}},"required":["rule","display","charges"],"additionalProperties":false,"description":"Current Price and charging rules. Price can change without an Endpoint version change. New Runs use the Price at admission; accepted Runs keep that Price.","isRequired":true,"uniqueKey":"data.items.[INDEX].price","typeLabel":"object"},"run_mode":{"type":"string","enum":["sync","async"],"isRequired":true,"uniqueKey":"data.items.[INDEX].run_mode","typeLabel":"enum\u003cstring>"},"score":{"oneOf":[{"type":"number","description":"Cosine similarity between the query and this endpoint's searchable text, in [-1, 1]; null when semantic scoring did not run. A similarity signal for comparing rows, not a verdict: ranking fuses two arms, and neither a low score nor the end of the results shows that a capability is absent.","isRequired":true,"uniqueKey":"data.items.[INDEX].score.oneOf.0","typeLabel":"number"},{"type":"string","description":"Cosine similarity between the query and this endpoint's searchable text, in [-1, 1]; null when semantic scoring did not run. A similarity signal for comparing rows, not a verdict: ranking fuses two arms, and neither a low score nor the end of the results shows that a capability is absent.","enum":["Infinity","-Infinity","NaN"],"isRequired":true,"uniqueKey":"data.items.[INDEX].score.oneOf.1","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Cosine similarity between the query and this endpoint's searchable text, in [-1, 1]; null when semantic scoring did not run. A similarity signal for comparing rows, not a verdict: ranking fuses two arms, and neither a low score nor the end of the results shows that a capability is absent.","isRequired":true,"uniqueKey":"data.items.[INDEX].score.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].score","typeLabel":"number | enum\u003cstring> | null"},"timeout_ms":{"oneOf":[{"type":"integer","description":"For sync Endpoints, the maximum time in milliseconds from a Run request to its terminal response. Set your HTTP client timeout above this value.","minimum":0,"exclusiveMinimum":true,"uniqueKey":"data.items.[INDEX].timeout_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.items.[INDEX].timeout_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].timeout_ms","typeLabel":"integer | null"}},"required":["provider","provider_label","endpoint","endpoint_version","name","description","tags","price","run_mode","score"],"additionalProperties":false,"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"description":"Endpoint summaries ranked by relevance and filtered by your Key's Policy. Price does not affect ranking.","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"next_cursor":{"oneOf":[{"type":"string","description":"Pass this value as cursor to get the next page. Null means there are no more pages.","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pass this value as cursor to get the next page. Null means there are no more pages.","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"},"total":{"type":"integer","minimum":0,"description":"Total number of ranked candidates across all pages.","isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"task_id":{"type":"string","description":"The task this search was recorded against — the one you sent, or a newly minted one if you sent none. Pass it back on every later search, inspect and run for the same piece of work.","isRequired":true,"uniqueKey":"task_id","typeLabel":"string"},"client":{"type":"object","properties":{"client_version":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"client.client_version.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"client.client_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"client.client_version","typeLabel":"string | null"},"minimum_version":{"type":"string","isRequired":true,"uniqueKey":"client.minimum_version","typeLabel":"string"},"latest_version":{"type":"string","isRequired":true,"uniqueKey":"client.latest_version","typeLabel":"string"},"upgrade_command":{"type":"string","isRequired":true,"uniqueKey":"client.upgrade_command","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"client.reason","typeLabel":"string"}},"required":["client_version","minimum_version","latest_version","upgrade_command","reason"],"additionalProperties":false,"uniqueKey":"client","typeLabel":"object"}},"required":["data","next_cursor","total","task_id"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"provider":"\u003cstring>","provider_label":"\u003cstring>","endpoint":"\u003cstring>","endpoint_version":123,"name":"\u003cstring>","description":"\u003cstring>","tags":["\u003cstring>"],"price":{"rule":{"type":"flat","amount_usd":"\u003cstring>"},"display":{"amount_usd":"\u003cstring>","unit":"\u003cstring>","cap_usd":"\u003cstring>"},"charges":{"NO_RESULT":"\u003cstring>","PROVIDER_ERROR":"\u003cstring>","TIMED_OUT":"\u003cstring>","INTERNAL":"\u003cstring>"}},"run_mode":"sync","score":123,"timeout_ms":1}],"next_cursor":"\u003cstring>","total":1,"task_id":"\u003cstring>","client":{"client_version":"\u003cstring>","minimum_version":"\u003cstring>","latest_version":"\u003cstring>","upgrade_command":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c15a7535-a3f8-4c0f-a61e-9882a20eb61b":{"description":"ValidationFailed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error","request_id"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_failed"],"isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.error.reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.error.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.error.reason","typeLabel":"string | null"},"control":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.error.control.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.error.control.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.error.control","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"type":"integer","uniqueKey":"oneOf.0.error.retry_after_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"oneOf.0.error.retry_after_ms.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"oneOf.0.error.retry_after_ms.oneOf.2","typeLabel":"null"}],"uniqueKey":"oneOf.0.error.retry_after_ms","typeLabel":"integer · null · null"},"details":{"oneOf":[{"type":"object","uniqueKey":"oneOf.0.error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"oneOf.0.error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.error.details","typeLabel":"object | null"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.request_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error","request_id"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_failed"],"isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.error.reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.1.error.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.reason","typeLabel":"string | null"},"control":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.error.control.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.1.error.control.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.control","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"type":"integer","uniqueKey":"oneOf.1.error.retry_after_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"oneOf.1.error.retry_after_ms.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"oneOf.1.error.retry_after_ms.oneOf.2","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.retry_after_ms","typeLabel":"integer · null · null"},"details":{"oneOf":[{"type":"object","uniqueKey":"oneOf.1.error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"oneOf.1.error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.details","typeLabel":"object | null"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.request_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_failed","message":"\u003cstring>","reason":"\u003cstring>","control":"\u003cstring>","retry_after_ms":123,"details":{}},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"404c753a-4e76-4701-8c77-6618b460218e":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"error.reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.reason","typeLabel":"string | null"},"control":{"oneOf":[{"type":"string","uniqueKey":"error.control.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.control.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.control","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.retry_after_ms","typeLabel":"integer · null · null"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>","control":"\u003cstring>","retry_after_ms":123,"details":{}},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9fdeaf35-400c-4539-a623-b7774e3b9336":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["forbidden"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"error.reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.reason","typeLabel":"string | null"},"control":{"oneOf":[{"type":"string","uniqueKey":"error.control.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.control.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.control","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.retry_after_ms","typeLabel":"integer · null · null"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"\u003cstring>","reason":"\u003cstring>","control":"\u003cstring>","retry_after_ms":123,"details":{}},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"bcd9b64c-7b96-4d02-9819-f2138a4ca945":{"description":"RateLimited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"error.reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.reason","typeLabel":"string | null"},"control":{"oneOf":[{"type":"string","uniqueKey":"error.control.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.control.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.control","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_ms.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"error.retry_after_ms.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.retry_after_ms","typeLabel":"integer · null · null"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"\u003cstring>","reason":"\u003cstring>","control":"\u003cstring>","retry_after_ms":123,"details":{}},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d28caa1b-7646-405d-8867-7808b30e50a8":{"bearer":{"type":"http","scheme":"Bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"36bbba50-ad20-4ae2-bf87-c49c583803f7":{"url":"https://api.glasser.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"Bearer","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"glasser","siteName":"Glasser","title":"Search runnable endpoints - Glasser","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T07:09:36.676Z","originalFileLocation":"api-reference/endpoints/search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Glasser\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search runnable endpoints - Glasser\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Glasser\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://glasser.ai/docs/api-reference/endpoints/search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://glasser.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Search+runnable+endpoints\u0026amp;description=Find+Endpoints+for+the+data+you+need+and+compare+Providers+and+Prices.+Search+returns+ways+to+retrieve+data%3B+it+does+not+retrieve+the+data+itself.\u0026amp;theme=6f084cf64b727740a57b3687\u0026amp;signature=577a7599f0e8f053e280ecf2a0323052ace64c6e5fad048ef97a2dbf7cbe8aee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search runnable endpoints - Glasser\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://glasser.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Search+runnable+endpoints\u0026amp;description=Find+Endpoints+for+the+data+you+need+and+compare+Providers+and+Prices.+Search+returns+ways+to+retrieve+data%3B+it+does+not+retrieve+the+data+itself.\u0026amp;theme=6f084cf64b727740a57b3687\u0026amp;signature=577a7599f0e8f053e280ecf2a0323052ace64c6e5fad048ef97a2dbf7cbe8aee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/glasser/BkuzOUT55q1vTY9q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Glasser\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003clink data-mint-head rel=\"canonical\" href=\"https://glasser.ai/docs/api-reference/endpoints/search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/endpoints/search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://glasser.ai/#organization\",\"name\":\"Glasser\",\"url\":\"https://glasser.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://glasser.ai/docs#website\",\"name\":\"Glasser\",\"url\":\"https://glasser.ai/docs\",\"publisher\":{\"@id\":\"https://glasser.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://glasser.ai/docs/api-reference/endpoints/search#webpage\",\"url\":\"https://glasser.ai/docs/api-reference/endpoints/search\",\"name\":\"Search runnable endpoints\",\"description\":\"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\",\"dateModified\":\"2026-10-21T07:09:36.676Z\",\"isPartOf\":{\"@id\":\"https://glasser.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://glasser.ai/docs/api-reference/endpoints/search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://glasser.ai/docs/api-reference/endpoints/search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://glasser.ai/docs/api-reference/endpoints/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search runnable endpoints\",\"item\":\"https://glasser.ai/docs/api-reference/endpoints/search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://glasser.ai/docs/api-reference/endpoints/search#apireference\",\"headline\":\"Search runnable endpoints\",\"name\":\"Search runnable endpoints\",\"description\":\"Find Endpoints for the data you need and compare Providers and Prices. Search returns ways to retrieve data; it does not retrieve the data itself.\",\"url\":\"https://glasser.ai/docs/api-reference/endpoints/search\",\"mainEntityOfPage\":{\"@id\":\"https://glasser.ai/docs/api-reference/endpoints/search#webpage\"},\"dateModified\":\"2026-10-21T07:09:36.676Z\",\"publisher\":{\"@id\":\"https://glasser.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://glasser.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Glasser\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Glasser","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Get started","pages":[{"title":"API overview","sidebarTitle":"Overview","href":"/api-reference/overview"}]},{"group":"Endpoints","pages":[{"title":"List Providers and Endpoints","description":"Browse Providers and Endpoints in one public list. Use it to choose data for your product or build a Provider picker.","api":"GET https://api.glasser.ai/public/catalog","href":"/api-reference/endpoints/list"},{"title":"Search runnable endpoints","deprecated":null,"version":null,"sidebarTitle":"Search","openapi":"/openapi.json post /v1/endpoints/search","href":"/api-reference/endpoints/search"},{"title":"Inspect an Endpoint","description":"Get an Endpoint's schemas, current Price, and example input. Use these details to prepare a Run.","deprecated":null,"version":null,"sidebarTitle":"Inspect","openapi":"/openapi.json post /v1/endpoints/inspect","href":"/api-reference/endpoints/inspect"}]},{"group":"Runs","pages":[{"title":"Create a Run","deprecated":null,"version":null,"sidebarTitle":"Create","openapi":"/openapi.json post /v1/runs","href":"/api-reference/runs/create"},{"title":"List Runs","deprecated":null,"version":null,"sidebarTitle":"List","openapi":"/openapi.json get /v1/runs","href":"/api-reference/runs/list"},{"title":"Get a Run","deprecated":null,"version":null,"sidebarTitle":"Get","openapi":"/openapi.json get /v1/runs/{runId}","href":"/api-reference/runs/get"},{"title":"Stop a Run","deprecated":null,"version":null,"sidebarTitle":"Stop","openapi":"/openapi.json post /v1/runs/{runId}/stop","href":"/api-reference/runs/stop"}]},{"group":"Balance","pages":[{"title":"Get balance","deprecated":null,"version":null,"sidebarTitle":"Get","openapi":"/openapi.json get /v1/balance","href":"/api-reference/balance/get"},{"title":"List balance history","deprecated":null,"version":null,"sidebarTitle":"History","openapi":"/openapi.json get /v1/balance/history","href":"/api-reference/balance/history"}]},{"group":"Data Sources","pages":[{"title":"Jev API","sidebarTitle":"Jev","href":"/api-reference/data-sources/jev"}]},{"group":"Solutions","pages":[{"title":"Solutions overview","sidebarTitle":"Overview","href":"/api-reference/solutions/overview"},{"title":"Web research","deprecated":null,"version":null,"sidebarTitle":"Web research","openapi":"/openapi.json post /v1/solutions/gtm/web_research","href":"/api-reference/solutions/gtm/web_research"},{"title":"Read a web research result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/web_research/result","href":"/api-reference/solutions/gtm/web_research/result"},{"title":"Company intelligence","deprecated":null,"version":null,"sidebarTitle":"Company intelligence","openapi":"/openapi.json post /v1/solutions/gtm/company_intelligence","href":"/api-reference/solutions/gtm/company_intelligence"},{"title":"Read a company intelligence result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/company_intelligence/result","href":"/api-reference/solutions/gtm/company_intelligence/result"},{"title":"People search","deprecated":null,"version":null,"sidebarTitle":"People search","openapi":"/openapi.json post /v1/solutions/gtm/people_search","href":"/api-reference/solutions/gtm/people_search"},{"title":"Read a people search result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/people_search/result","href":"/api-reference/solutions/gtm/people_search/result"},{"title":"SEO research","deprecated":null,"version":null,"sidebarTitle":"Seo research","openapi":"/openapi.json post /v1/solutions/gtm/seo_research","href":"/api-reference/solutions/gtm/seo_research"},{"title":"Read an SEO research result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/seo_research/result","href":"/api-reference/solutions/gtm/seo_research/result"},{"title":"Social research","deprecated":null,"version":null,"sidebarTitle":"Social research","openapi":"/openapi.json post /v1/solutions/gtm/social_research","href":"/api-reference/solutions/gtm/social_research"},{"title":"Read a social research result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/social_research/result","href":"/api-reference/solutions/gtm/social_research/result"},{"title":"Market data","deprecated":null,"version":null,"sidebarTitle":"Market data","openapi":"/openapi.json post /v1/solutions/gtm/market_data","href":"/api-reference/solutions/gtm/market_data"},{"title":"Read a market data result","deprecated":null,"version":null,"sidebarTitle":"Result","openapi":"/openapi.json get /v1/solutions/gtm/market_data/result","href":"/api-reference/solutions/gtm/market_data/result"}]}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]}]},"title":"Search runnable endpoints - Glasser","buildId":"dpl_BvXubCjoPYfvfFiCP5WgKvGYUZ9k","deploymentId":"dpl_BvXubCjoPYfvfFiCP5WgKvGYUZ9k","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Cn24bQ-L.js","utils-2fswSlDf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CCIi4ABW.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CAH7N_Ow.js","snippetPresets-x_0VpYAk.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-llGafAZf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-W1eCShSz.js","shallow-NLT_NnDI.js","getApiPlaygroundDisplay-QSEhtcdZ.js","CodeSnippet-CK8Lk0kg.js","CodeSnippets-Cra_whAm.js","Page-CQfXSH2v.js","getPastedJson-BEz4UfPL.js","icon-CwvrEduL.js","MethodPill-DblyOGAG.js","DuplicateIcon-7P7ixz4I.js","createIcon-BURR5_pt.js","DynamicMarkdown-DteaQut7.js","SectionHeading-CHtmkzk7.js","axios-vUo_bRtp.js","Markdown-BIU4AXHQ.js","clsx-Ds0AvV0Z.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Ka3QKbKd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BURaoZsB.js"]}