{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Taste Engine","colors":{"primary":"#171717","light":"#EAECE7","dark":"#171717"},"logo":{"light":"https://mintcdn.com/tastelabs/lMcn8IvQ-WbXAKni/logo/taste-engine-light.png?fit=max\u0026auto=format\u0026n=lMcn8IvQ-WbXAKni\u0026q=85\u0026s=16b11d3a9a0b80eaa5a2cac0416a8302","dark":"https://mintcdn.com/tastelabs/lMcn8IvQ-WbXAKni/logo/taste-engine-dark.png?fit=max\u0026auto=format\u0026n=lMcn8IvQ-WbXAKni\u0026q=85\u0026s=d9c4bf49c12137ed7b63f4f78938f60d"},"favicon":"https://mintcdn.com/tastelabs/VgdXg7WVd5ngvNjs/favicon.ico?fit=max\u0026auto=format\u0026n=VgdXg7WVd5ngvNjs\u0026q=85\u0026s=8c55a4849dd50033afa63bbeaa6ca952","appearance":{"default":"dark"},"background":{"color":{"light":"#EAECE7","dark":"#171717"}},"navbar":{"links":[{"href":"mailto:support@thetaste.ai","label":"Support"}],"primary":{"type":"button","label":"Get API key","href":"https://engine.tastelabs.com/app/api-keys"}},"fonts":{"heading":{"family":"Azeret Mono","weight":300,"source":"https://cdn.jsdelivr.net/gh/sanvi-saya/taste-labs-fonts@main/AzeretSemiMono-Regular.woff2","format":"woff2"},"body":{"family":"Matter","weight":400,"source":"https://cdn.jsdelivr.net/gh/sanvi-saya/taste-labs-fonts@main/Matter-Regular.woff2","format":"woff2"}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tastelabs","hasAudioNarration":false,"actualSubdomain":"tastelabs","customDomains":["docs.tastelabs.com"],"gitSource":{"type":"github","owner":"taste-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"7189bea5-d062-42c4-8d1c-2dcf654f20ff","liveDeploymentHistoryId":"6ae205e94fe4c8cc739cf941","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae205e94fe4c8cc739cf941"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae205e94fe4c8cc739cf941","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Brand extractor","count":13},{"language":"default","tag":"Brand adherence verifier","count":6},{"language":"default","tag":"Brand search","count":4},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"From a URL","count":4},{"language":"default","tag":"Integrate Agents","count":3},{"language":"default","tag":"Use cases","count":3},{"language":"default","tag":"Account","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#api-playground-input,#chat-assistant-sheet,#feedback-form,#request-example,#response-example,#search-bar-entry,#search-bar-entry-mobile,#topbar-cta-button,accordion,accordion-group,callout,card,code-block,code-group,expandable,frame,step,steps,tabs,tile{border-radius:6px}.lottie-tile{box-sizing:border-box;height:222px;padding:24px;border-radius:16px;background:#2b2b2b;overflow:hidden;margin:1.5rem 0}.lottie-tile.lottie-tile-extract{background:#272726}.lottie-tile dotlottie-wc{display:block;width:100%;height:100%}.lottie-tile.lottie-tile-verify{position:relative;height:auto;aspect-ratio:6/5;padding:0}.lottie-tile.lottie-tile-verify dotlottie-wc{position:absolute;top:0;left:-6.6%;width:113.2%;height:100%}.lottie-tile.lottie-tile-search{height:100px;padding:16px 24px}a.link:has(>code),a.link:has(>code):hover{border-bottom:0;text-decoration:none}"}],"page":{"pagePath":"api-reference/endpoint/list-searches","slug":"/api-reference/endpoint/list-searches","pageMetadata":{"title":"List searches","openapi":"api-reference/openapi.json GET /search/submissions","description":"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits.\n\nSearch results themselves are not stored, only the request and its outcome. Extraction history lives at [`GET /design/submissions`](/api-reference/endpoint/list-submissions).","href":"/api-reference/endpoint/list-searches"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Search results themselves are not stored, only the request and its outcome. Extraction history lives at \", _jsx(_components.a, {\n href: \"/api-reference/endpoint/list-submissions\",\n children: _jsx(_components.code, {\n children: \"GET /design/submissions\"\n })\n }), \".\"]\n })]\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{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":"List searches","openapi":"api-reference/openapi.json GET /search/submissions","description":"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits.\n\nSearch results themselves are not stored, only the request and its outcome. Extraction history lives at [`GET /design/submissions`](/api-reference/endpoint/list-submissions).","href":"/api-reference/endpoint/list-searches"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/tastelabs/76568ed90a0209b3/lottie.js"],"openApiReferenceData":{"operation":{"operationId":"listSearches","summary":"List searches","description":"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits.\n\nSearch results themselves are not stored, only the request and its outcome. Extraction history lives at [`GET /design/submissions`](/api-reference/endpoint/list-submissions).","tags":["Search"],"parameters":["5ee236cf-f526-40be-b402-1e01a86558e7","f4c202f0-b216-45b0-a170-b1ef5d9620d5","0d4d3c9f-dfdb-42b9-a815-5ed840ff9b9c","e12f887d-cb6c-46c9-8be0-8a98fd4eaac0","3cc04cbb-dfa1-4f95-8f4d-5ff97146e4a2","b0fb9e57-07db-4c08-a8a7-c3a593f487c4","52000d21-42e8-4987-812d-8307390bb903"],"responses":{"200":"6d7ae364-33ab-471b-8020-d5b88c3dfc79","401":"d8a18da5-4def-4202-b1c5-cfdf34f83c2e","500":"bb2a5644-58fe-43e7-83f3-19a085d848cf"},"method":"get","type":"path","servers":["0598e6f9-8098-4b6e-920e-0423fc731288"],"security":["459696c1-9068-49b3-8e05-948962c91f1f"],"path":"/search/submissions","baseUrlOptions":["https://api.tastelabs.com"],"title":"List searches","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5ee236cf-f526-40be-b402-1e01a86558e7":{"name":"kind","in":"query","required":false,"description":"Filter to query searches or similarity lookups.","schema":{"type":"string","enum":["search","similar"],"isRequired":false,"description":"Filter to query searches or similarity lookups.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"f4c202f0-b216-45b0-a170-b1ef5d9620d5":{"name":"status","in":"query","required":false,"description":"Filter by outcome.","schema":{"type":"string","enum":["completed","failed","in_progress"],"isRequired":false,"description":"Filter by outcome.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"0d4d3c9f-dfdb-42b9-a815-5ed840ff9b9c":{"name":"depth","in":"query","required":false,"description":"Filter query searches by depth.","schema":{"type":"string","enum":["fast","deep"],"isRequired":false,"description":"Filter query searches by depth.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"e12f887d-cb6c-46c9-8be0-8a98fd4eaac0":{"name":"q","in":"query","required":false,"description":"Free-text filter over the query text.","schema":{"type":"string","isRequired":false,"description":"Free-text filter over the query text.","uniqueKey":"","typeLabel":"string"}},"3cc04cbb-dfa1-4f95-8f4d-5ff97146e4a2":{"name":"api_key_id","in":"query","required":false,"description":"Only searches made with one API key. Useful for separating environments that share an account.","schema":{"type":"string","isRequired":false,"description":"Only searches made with one API key. Useful for separating environments that share an account.","uniqueKey":"","typeLabel":"string"}},"b0fb9e57-07db-4c08-a8a7-c3a593f487c4":{"name":"limit","in":"query","required":false,"description":"Maximum number of searches to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"isRequired":false,"description":"Maximum number of searches to return.","uniqueKey":"","typeLabel":"integer"}},"52000d21-42e8-4987-812d-8307390bb903":{"name":"offset","in":"query","required":false,"description":"Number of searches to skip, for pagination.","schema":{"type":"integer","minimum":0,"default":0,"isRequired":false,"description":"Number of searches to skip, for pagination.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"6d7ae364-33ab-471b-8020-d5b88c3dfc79":{"description":"A page of past searches.","content":{"application/json":{"schema":{"type":"object","properties":{"submissions":{"type":"array","description":"Past searches, newest first.","items":{"type":"object","description":"One past search. Results are not stored, only the request and its outcome.","properties":{"id":{"type":"string","description":"Identifier of the search.","uniqueKey":"submissions.items.[INDEX].id","typeLabel":"string"},"kind":{"type":"string","description":"`search` for a query search, `similar` for a similarity lookup.","enum":["search","similar"],"uniqueKey":"submissions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"query":{"type":"string","description":"The query text, or the source URL for a `similar` lookup.","uniqueKey":"submissions.items.[INDEX].query","typeLabel":"string"},"depth":{"oneOf":[{"type":"string","description":"Depth used. `null` for `similar` lookups.","default":"fast","enum":["fast","deep"],"uniqueKey":"submissions.items.[INDEX].depth.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Depth used. `null` for `similar` lookups.","uniqueKey":"submissions.items.[INDEX].depth.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].depth","typeLabel":"enum\u003cstring> | null"},"filters":{"oneOf":[{"type":"object","description":"The hard constraints sent with the search, when any.","uniqueKey":"submissions.items.[INDEX].filters.oneOf.0","typeLabel":"object"},{"type":"null","description":"The hard constraints sent with the search, when any.","uniqueKey":"submissions.items.[INDEX].filters.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].filters","typeLabel":"object | null"},"query_tags":{"oneOf":[{"type":"object","description":"The engine's soft reading of the query, as returned with the results.","uniqueKey":"submissions.items.[INDEX].query_tags.oneOf.0","typeLabel":"object"},{"type":"null","description":"The engine's soft reading of the query, as returned with the results.","uniqueKey":"submissions.items.[INDEX].query_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].query_tags","typeLabel":"object | null"},"status":{"type":"string","description":"Outcome of the search.","uniqueKey":"submissions.items.[INDEX].status","typeLabel":"string"},"result_count":{"oneOf":[{"type":"integer","description":"How many results the search returned.","uniqueKey":"submissions.items.[INDEX].result_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"How many results the search returned.","uniqueKey":"submissions.items.[INDEX].result_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].result_count","typeLabel":"integer | null"},"latency_ms":{"oneOf":[{"type":"integer","description":"How long the search took, in milliseconds.","uniqueKey":"submissions.items.[INDEX].latency_ms.oneOf.0","typeLabel":"integer"},{"type":"null","description":"How long the search took, in milliseconds.","uniqueKey":"submissions.items.[INDEX].latency_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].latency_ms","typeLabel":"integer | null"},"credit_ref_id":{"oneOf":[{"type":"string","description":"Reference to the credit charge for this search.","uniqueKey":"submissions.items.[INDEX].credit_ref_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Reference to the credit charge for this search.","uniqueKey":"submissions.items.[INDEX].credit_ref_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].credit_ref_id","typeLabel":"string | null"},"credits_consumed":{"oneOf":[{"type":"integer","description":"Credits consumed by this search, net of any refund.","uniqueKey":"submissions.items.[INDEX].credits_consumed.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Credits consumed by this search, net of any refund.","uniqueKey":"submissions.items.[INDEX].credits_consumed.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].credits_consumed","typeLabel":"integer | null"},"api_key_name":{"oneOf":[{"type":"string","description":"Name of the API key that made the search, when one was used.","uniqueKey":"submissions.items.[INDEX].api_key_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the API key that made the search, when one was used.","uniqueKey":"submissions.items.[INDEX].api_key_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].api_key_name","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"submissions.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].completed_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"submissions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"submissions","typeLabel":"object[]"},"total":{"type":"integer","description":"Total searches matching the filter, ignoring pagination.","uniqueKey":"total","typeLabel":"integer"},"total_by_status":{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"total_by_status.additionalProperties","typeLabel":"integer"},"description":"Counts by outcome under the other filters, ignoring pagination, so a status picker can label its options.","uniqueKey":"total_by_status","typeLabel":"object"},"limit":{"type":"integer","uniqueKey":"limit","typeLabel":"integer"},"offset":{"type":"integer","uniqueKey":"offset","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"submissions":[{"id":"\u003cstring>","kind":"search","query":"\u003cstring>","depth":"fast","filters":{},"query_tags":{},"status":"\u003cstring>","result_count":123,"latency_ms":123,"credit_ref_id":"\u003cstring>","credits_consumed":123,"api_key_name":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z"}],"total":123,"total_by_status":{},"limit":123,"offset":123}}},"exampleType":"generated"}},"exampleType":"generated"},"d8a18da5-4def-4202-b1c5-cfdf34f83c2e":{"description":"The API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for non-2xx responses: the machine-readable `error` code and the human-readable `message` are nested under `detail`. Validation errors (`422`) and search failures (`502`, `503`) shape `detail` differently; see those responses.","properties":{"detail":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code.","examples":["UNAUTHORIZED","FORBIDDEN","NOT_FOUND","NOT_READY"],"isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation of the error.","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"}},"required":["error","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"required":["detail"],"uniqueKey":"","typeLabel":"object"},"example":{"detail":{"error":"UNAUTHORIZED","message":"Bearer token or X-API-Key required"}},"examples":{"Example":{"title":"Example","value":{"detail":{"error":"UNAUTHORIZED","message":"Bearer token or X-API-Key required"}}}},"exampleType":"examples"}},"exampleType":"examples"},"bb2a5644-58fe-43e7-83f3-19a085d848cf":{"description":"An unexpected server error occurred. The body is plain text.","content":{"text/plain":{"example":"Internal Server Error","examples":{"Example":{"title":"Example","value":"Internal Server Error"}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"459696c1-9068-49b3-8e05-948962c91f1f":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"0598e6f9-8098-4b6e-920e-0423fc731288":{"url":"https://api.tastelabs.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"tastelabs","siteName":"Taste Engine","title":"List searches - Taste Engine","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-07T20:13:15.606Z","originalFileLocation":"api-reference/endpoint/list-searches.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=\"dark\"}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=\"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits. Search results themselves are not stored, only the request and its outcome. Extraction history lives at GET /design/submissions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Taste Engine\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_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=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List searches - Taste Engine\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits. Search results themselves are not stored, only the request and its outcome. Extraction history lives at GET /design/submissions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Taste Engine\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tastelabs.com/api-reference/endpoint/list-searches\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tastelabs.mintlify.app/_mintlify/api/og/v2?division=Brand+search\u0026amp;title=List+searches\u0026amp;description=Returns+your+past+searches+and+similarity+lookups%2C+newest+first.+Free%3A+listing+history+costs+no+credits.%0A%0ASearch+results+themselves+are+not+stored%2C+only+the+req\u0026amp;theme=2503431c8b55ea04159a70c0\u0026amp;signature=4cae85ced10169862d4657222263e680b6584de52d8a8ac123ab1f8aba4e1e62\">\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=\"List searches - Taste Engine\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits. Search results themselves are not stored, only the request and its outcome. Extraction history lives at GET /design/submissions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tastelabs.mintlify.app/_mintlify/api/og/v2?division=Brand+search\u0026amp;title=List+searches\u0026amp;description=Returns+your+past+searches+and+similarity+lookups%2C+newest+first.+Free%3A+listing+history+costs+no+credits.%0A%0ASearch+results+themselves+are+not+stored%2C+only+the+req\u0026amp;theme=2503431c8b55ea04159a70c0\u0026amp;signature=4cae85ced10169862d4657222263e680b6584de52d8a8ac123ab1f8aba4e1e62\">\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=\"/mintlify-assets/_mintlify/favicons/tastelabs/JjPiBFIDNaN6gB-y/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Taste Engine\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tastelabs.com/api-reference/endpoint/list-searches\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/list-searches.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tastelabs.com/#organization\",\"name\":\"Taste Engine\",\"url\":\"https://docs.tastelabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tastelabs/lMcn8IvQ-WbXAKni/logo/taste-engine-light.png?fit=max\u0026auto=format\u0026n=lMcn8IvQ-WbXAKni\u0026q=85\u0026s=16b11d3a9a0b80eaa5a2cac0416a8302\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tastelabs.com#website\",\"name\":\"Taste Engine\",\"url\":\"https://docs.tastelabs.com\",\"publisher\":{\"@id\":\"https://docs.tastelabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches#webpage\",\"url\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches\",\"name\":\"List searches\",\"description\":\"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits. Search results themselves are not stored, only the request and its outcome. Extraction history lives at GET /design/submissions.\",\"dateModified\":\"2026-08-07T20:13:15.606Z\",\"isPartOf\":{\"@id\":\"https://docs.tastelabs.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Brand search\",\"item\":\"https://docs.tastelabs.com/api-reference/endpoint/search-brands\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List searches\",\"item\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches#apireference\",\"headline\":\"List searches\",\"name\":\"List searches\",\"description\":\"Returns your past searches and similarity lookups, newest first. Free: listing history costs no credits. Search results themselves are not stored, only the request and its outcome. Extraction history lives at GET /design/submissions.\",\"url\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tastelabs.com/api-reference/endpoint/list-searches#webpage\"},\"dateModified\":\"2026-08-07T20:13:15.606Z\",\"publisher\":{\"@id\":\"https://docs.tastelabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tastelabs.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Taste Engine\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Taste Engine","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get current user","openapi":"api-reference/openapi.json GET /design/me","href":"/api-reference/endpoint/get-current-user"}]},{"group":"Brand extractor","pages":[{"title":"Create submission","openapi":"api-reference/openapi.json POST /design/submissions","href":"/api-reference/endpoint/create-submission"},{"title":"Create brand kit submission","openapi":"api-reference/openapi.json POST /design/submissions/brand-kit","href":"/api-reference/endpoint/create-brand-kit-submission"},{"title":"List submissions","openapi":"api-reference/openapi.json GET /design/submissions","href":"/api-reference/endpoint/list-submissions"},{"title":"Get submission","openapi":"api-reference/openapi.json GET /design/submissions/{id}","href":"/api-reference/endpoint/get-submission"},{"title":"Get submission result","openapi":"api-reference/openapi.json GET /design/submissions/{id}/result","href":"/api-reference/endpoint/get-submission-result"},{"title":"Download submission bundle","openapi":"api-reference/openapi.json GET /design/submissions/{id}/download","href":"/api-reference/endpoint/download-submission"},{"title":"Update visibility","openapi":"api-reference/openapi.json PATCH /design/submissions/{id}/visibility","href":"/api-reference/endpoint/update-visibility"},{"title":"Enhance prompt","openapi":"api-reference/openapi.json POST /design/prompts/enhance","href":"/api-reference/endpoint/enhance-prompt"}]},{"group":"Brand search","pages":[{"title":"Search brands","openapi":"api-reference/openapi.json POST /search","href":"/api-reference/endpoint/search-brands"},{"title":"Find similar brands","openapi":"api-reference/openapi.json GET /search/similar","description":"Returns brands from the corpus that look like one of your completed extractions, as the same result cards as [`POST /search`](/api-reference/endpoint/search-brands).\n\nRuns synchronously. Consumes credits, refunded if the request fails. The submission must be completed and readable by the caller.\n\nNeighbours are computed fresh on every call, so they can vary slightly between calls for the same submission.\n\nRequires a full extraction, created without sections. Selective submissions return 422 FULL_EXTRACTION_REQUIRED, including those served from a full cached extraction.","href":"/api-reference/endpoint/find-similar-brands"},{"title":"List searches","openapi":"api-reference/openapi.json GET /search/submissions","href":"/api-reference/endpoint/list-searches"}]},{"group":"Brand adherence verifier","pages":[{"title":"Create brand-adherence job","openapi":"api-reference/openapi.json POST /judge/brand-adherence","description":"Judges how well a page (the `source_url`) adheres to a reference site's brand (the `reference_url`). Use it to score a rebuild, a generated page, or a redesign against the brand it should follow.\n\nThe job runs asynchronously: poll `GET /judge/brand-adherence/{job_id}` until the status is `completed` or `failed`, then read the verdict from `GET /judge/brand-adherence/{job_id}/result`.\n\nBoth URLs are extracted automatically, and a recent extraction of either side is reused. You do not need to create submissions first.","href":"/api-reference/endpoint/create-brand-adherence"},{"title":"List brand-adherence jobs","openapi":"api-reference/openapi.json GET /judge/brand-adherence","href":"/api-reference/endpoint/list-brand-adherence-jobs"},{"title":"Get brand-adherence job","openapi":"api-reference/openapi.json GET /judge/brand-adherence/{job_id}","href":"/api-reference/endpoint/get-brand-adherence-job"},{"title":"Get brand-adherence verdict","openapi":"api-reference/openapi.json GET /judge/brand-adherence/{job_id}/result","href":"/api-reference/endpoint/get-brand-adherence-verdict"},{"title":"Update job visibility","openapi":"api-reference/openapi.json PATCH /judge/brand-adherence/{job_id}/visibility","href":"/api-reference/endpoint/update-brand-adherence-visibility"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"List searches - Taste Engine","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}