{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"docs","colors":{"primary":"#927dff","light":"#927dff","dark":"#927dff"},"logo":{"light":"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f","dark":"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f"},"favicon":"/logo/logo.svg","navbar":{"links":[{"href":"mailto:support@managem.co.uk","label":"Support"}],"primary":{"type":"button","label":"Marketplace","href":"https://managem.co.uk"}},"footer":{"socials":{"discord":"https://discord.gg/qaU4KSEQRd"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"book","href":"https://docs.managem.co.uk"},{"anchor":"Connect AI","icon":"bot","href":"/mcp"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"managem","hasAudioNarration":false,"actualSubdomain":"managem","customDomains":["docs.managem.co.uk"],"gitSource":{"type":"github","owner":"managemco","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ec1bfb57cfb9e9a7a3bf","collectionId":"4ff6f1e9-0826-44a0-ba21-388ed56861cb","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21ec1bfb57cfb9e9a7a3bf:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Sellers","count":62},{"language":"default","tag":"Buyers","count":58},{"language":"default","tag":"Marketplace","count":26},{"language":"default","tag":"Account","count":17},{"language":"default","tag":"Management","count":17},{"language":"default","tag":"Listings","count":15},{"language":"default","tag":"Search","count":12},{"language":"default","tag":"Cases","count":12},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Conversations","count":9}]},"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":[],"page":{"pagePath":"api-reference/search/full-text-faceted-search","slug":"/api-reference/search/full-text-faceted-search","pageMetadata":{"title":"Full-text faceted search","description":"\nThis is the main marketplace search endpoint.\n\nUse it for:\n- global search bars\n- category and filter pages\n- any browse/results screen where users need discoverability\n\nBehavior:\n- Accepts free-text query, facet filters, sorting, and paging input.\n- Returns matching items plus facet aggregations so the UI can render filter chips and counts.\n\nGood to know:\n- Results are cached briefly (~30s) for identical request bodies.\n- Different JSON bodies generate different cache keys.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search","href":"/api-reference/search/full-text-faceted-search","autogeneratedByOpenApi":true},"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 li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"This is the main marketplace search endpoint.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Use it for:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"global search bars\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"category and filter pages\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"any browse/results screen where users need discoverability\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Behavior:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Accepts free-text query, facet filters, sorting, and paging input.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Returns matching items plus facet aggregations so the UI can render filter chips and counts.\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Good to know:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Results are cached briefly (~30s) for identical request bodies.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Different JSON bodies generate different cache keys.\"\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":"Full-text faceted search","description":"\nThis is the main marketplace search endpoint.\n\nUse it for:\n- global search bars\n- category and filter pages\n- any browse/results screen where users need discoverability\n\nBehavior:\n- Accepts free-text query, facet filters, sorting, and paging input.\n- Returns matching items plus facet aggregations so the UI can render filter chips and counts.\n\nGood to know:\n- Results are cached briefly (~30s) for identical request bodies.\n- Different JSON bodies generate different cache keys.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search","href":"/api-reference/search/full-text-faceted-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["search"],"operationId":"search","summary":"Full-text faceted search","description":"\nThis is the main marketplace search endpoint.\n\nUse it for:\n- global search bars\n- category and filter pages\n- any browse/results screen where users need discoverability\n\nBehavior:\n- Accepts free-text query, facet filters, sorting, and paging input.\n- Returns matching items plus facet aggregations so the UI can render filter chips and counts.\n\nGood to know:\n- Results are cached briefly (~30s) for identical request bodies.\n- Different JSON bodies generate different cache keys.\n","requestBody":"53f4c1cc-636b-4adb-8d82-0a874ddb516a","responses":{"200":"209b9758-6f85-4e34-996f-abb404ec4629"},"method":"post","type":"path","servers":["a1faa4d7-f526-41b5-8c48-d2be7d297f34"],"security":[],"path":"/search","baseUrlOptions":["https://api.managem.co.uk"],"title":"Full-text faceted search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"One or more free text search terms","uniqueKey":"query","typeLabel":"string"},"filters":{"type":"array","items":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"filters.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"filters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters","typeLabel":"object[]"},"facets":{"type":"object","properties":{"Game":{"type":"array","items":{"type":"string","uniqueKey":"facets.Game.items.[INDEX]","typeLabel":"string"},"description":"Game name to match, e.g. Pokemon or Magic","uniqueKey":"facets.Game","typeLabel":"string[]"},"Product Type":{"type":"array","items":{"type":"string","uniqueKey":"facets.Product Type.items.[INDEX]","typeLabel":"string"},"description":"Type of product, for example \"card\" or \"product\"","uniqueKey":"facets.Product Type","typeLabel":"string[]"},"Rarity":{"type":"array","items":{"type":"string","uniqueKey":"facets.Rarity.items.[INDEX]","typeLabel":"string"},"description":"Card rarity values","uniqueKey":"facets.Rarity","typeLabel":"string[]"},"Series":{"type":"array","items":{"type":"string","uniqueKey":"facets.Series.items.[INDEX]","typeLabel":"string"},"description":"Series names","uniqueKey":"facets.Series","typeLabel":"string[]"},"Set":{"type":"array","items":{"type":"string","uniqueKey":"facets.Set.items.[INDEX]","typeLabel":"string"},"description":"Set names","uniqueKey":"facets.Set","typeLabel":"string[]"},"Illustrator":{"type":"array","items":{"type":"string","uniqueKey":"facets.Illustrator.items.[INDEX]","typeLabel":"string"},"description":"Illustrator names as stored on item images","uniqueKey":"facets.Illustrator","typeLabel":"string[]"},"Condition":{"type":"array","items":{"type":"string","uniqueKey":"facets.Condition.items.[INDEX]","typeLabel":"string"},"description":"Listing condition codes, e.g. MT, NM","uniqueKey":"facets.Condition","typeLabel":"string[]"},"Grading":{"type":"array","items":{"type":"string","enum":["Graded","Ungraded"],"uniqueKey":"facets.Grading.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Whether the card is \"Graded\" or \"Ungraded\"","uniqueKey":"facets.Grading","typeLabel":"enum\u003cstring>[]"},"Price":{"type":"array","items":{"type":"string","enum":["Under £1","£1-£10","£10-£20","£20-£50","£50-£100","Over £100"],"uniqueKey":"facets.Price.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Price buckets expressed in pounds sterling (inclusive of lower bounds)","uniqueKey":"facets.Price","typeLabel":"enum\u003cstring>[]"},"Quantity":{"type":"array","items":{"type":"string","enum":["1","2-10","10-50","50+"],"uniqueKey":"facets.Quantity.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Quantity buckets for available stock","uniqueKey":"facets.Quantity","typeLabel":"enum\u003cstring>[]"},"Valid":{"type":"array","items":{"type":"string","enum":["Valid","Invalid"],"uniqueKey":"facets.Valid.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Listing validity status for seller views","uniqueKey":"facets.Valid","typeLabel":"enum\u003cstring>[]"},"Hidden":{"type":"array","items":{"type":"string","enum":["Hidden","Visible"],"uniqueKey":"facets.Hidden.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Listing visibility status for seller views","uniqueKey":"facets.Hidden","typeLabel":"enum\u003cstring>[]"},"Availability":{"type":"array","items":{"type":"string","enum":["In Stock"],"uniqueKey":"facets.Availability.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Filter listings or items to only those that are \"In Stock\"","uniqueKey":"facets.Availability","typeLabel":"enum\u003cstring>[]"},"Category":{"type":"array","items":{"type":"string","uniqueKey":"facets.Category.items.[INDEX]","typeLabel":"string"},"description":"Item categories (metadata)","uniqueKey":"facets.Category","typeLabel":"string[]"}},"additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"facets.additionalProperties.items.[INDEX]","typeLabel":"string"},"description":"Additional facets accepted by the search endpoints. Unknown keys are passed through verbatim and applied as term filters.","uniqueKey":"facets.additionalProperties","typeLabel":"string[]"},"description":"Facets to refine the search results. Values are case-sensitive unless noted otherwise.","uniqueKey":"facets","typeLabel":"object"},"from":{"oneOf":[{"type":"number","default":0,"description":"Offset for pagination","uniqueKey":"from.oneOf.0","typeLabel":"number"},{"type":"null","default":0,"description":"Offset for pagination","uniqueKey":"from.oneOf.1","typeLabel":"null"}],"uniqueKey":"from","typeLabel":"number | null"},"size":{"type":"number","minimum":1,"maximum":50,"default":25,"description":"Number of results to return","uniqueKey":"size","typeLabel":"number"},"sorting":{"type":"object","properties":{"field":{"type":"string","enum":["name","number","indexed","price"],"isRequired":true,"uniqueKey":"sorting.field","typeLabel":"enum\u003cstring>"},"order":{"type":"string","enum":["asc","desc"],"isRequired":true,"uniqueKey":"sorting.order","typeLabel":"enum\u003cstring>"}},"required":["field","order"],"description":"Sort results by field and order","uniqueKey":"sorting","typeLabel":"object"}},"title":"Search Query","description":"A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting.","uniqueKey":"","typeLabel":"Search Query · object"},"examples":{"PokemonTextSearch":{"title":"PokemonTextSearch","description":"Returns the first page of Pokemon-related items.","value":{"query":"pokemon","size":2}},"PokemonCardsOnly":{"title":"PokemonCardsOnly","description":"Filters Pokemon results to card items only.","value":{"query":"pokemon","facets":{"Game":["Pokemon"],"Product Type":["card"]},"size":2}},"PikachuInSet151SortedByPrice":{"title":"PikachuInSet151SortedByPrice","description":"Combines free text, set filtering, and explicit price sorting.","value":{"query":"pikachu","facets":{"Game":["Pokemon"],"Set":["151"]},"sorting":{"field":"price","order":"asc"},"size":2}},"PokemonInStockBrowse":{"title":"PokemonInStockBrowse","description":"Uses only facets (no query text) for browse-first interfaces.","value":{"facets":{"Game":["Pokemon"],"Availability":["In Stock"]},"size":2}},"PokemonPaginationOffset":{"title":"PokemonPaginationOffset","description":"Shows a later page window using `from` + `size`.","value":{"query":"pokemon","from":10,"size":2}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"209b9758-6f85-4e34-996f-abb404ec4629":{"description":"Search items and available facets","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","isRequired":true,"uniqueKey":"total","typeLabel":"number"},"hits":{"type":"array","items":{"oneOf":[{"type":"object","required":["urn","type","game","title","name","rarity","set","series","images"],"properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.urn","typeLabel":"string"},"type":{"type":"string","enum":["card"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"game":{"type":"string","enum":["Pokemon"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.game","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.title","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.name","typeLabel":"string"},"rarity":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.rarity","typeLabel":"string"},"set":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set.urn","typeLabel":"string"},"counts":{"type":"object","properties":{"printed":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.0.set.counts.printed","typeLabel":"number"},"total":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.0.set.counts.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set.counts","typeLabel":"object"},"references":{"type":"array","items":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.0.set.references.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set.references","typeLabel":"string[]"},"size":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.0.set.size","typeLabel":"number"},"symbol":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set.symbol.url","typeLabel":"string"}},"required":["url"],"uniqueKey":"hits.items.[INDEX].oneOf.0.set.symbol","typeLabel":"object"},"released":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.0.set.released","typeLabel":"string"}},"required":["name","urn","counts","references"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.set","typeLabel":"object"},"series":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.series.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.series.urn","typeLabel":"string"}},"required":["name","urn"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.series","typeLabel":"object"},"images":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.images.items.[INDEX].urn","typeLabel":"string"},"orientation":{"type":"string","enum":["portrait","landscape"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.images.items.[INDEX].orientation","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.images.items.[INDEX].url","typeLabel":"string\u003curi>"},"illustrator":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.0.images.items.[INDEX].illustrator","typeLabel":"string"}},"required":["urn","orientation","url"],"uniqueKey":"hits.items.[INDEX].oneOf.0.images.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.images","typeLabel":"object[]"},"number":{"oneOf":[{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.0.number.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"hits.items.[INDEX].oneOf.0.number.oneOf.1","typeLabel":"null"}],"uniqueKey":"hits.items.[INDEX].oneOf.0.number","typeLabel":"string | null"},"description":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.0.description","typeLabel":"string"},"price":{"type":"integer","uniqueKey":"hits.items.[INDEX].oneOf.0.price","typeLabel":"integer"},"available":{"type":"integer","default":0,"description":"Total available for this listing","uniqueKey":"hits.items.[INDEX].oneOf.0.available","typeLabel":"integer"},"quantity":{"type":"integer","default":0,"description":"Total quantity available","uniqueKey":"hits.items.[INDEX].oneOf.0.quantity","typeLabel":"integer"},"min":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.min.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.min.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.min.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"hits.items.[INDEX].oneOf.0.min","typeLabel":"object"},"max":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.max.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.max.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.0.max.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"hits.items.[INDEX].oneOf.0.max","typeLabel":"object"}},"uniqueKey":"hits.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["urn","type","game","title","name","classification","count","images","series","set"],"properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.urn","typeLabel":"string"},"type":{"type":"string","enum":["product"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"game":{"type":"string","enum":["Pokemon"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.game","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.title","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.name","typeLabel":"string"},"classification":{"type":"string","enum":["CARD"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.classification","typeLabel":"enum\u003cstring>"},"count":{"type":"number","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.count","typeLabel":"number"},"images":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.images.items.[INDEX].urn","typeLabel":"string"},"orientation":{"type":"string","enum":["portrait","landscape"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.images.items.[INDEX].orientation","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.images.items.[INDEX].url","typeLabel":"string\u003curi>"},"illustrator":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.1.images.items.[INDEX].illustrator","typeLabel":"string"}},"required":["urn","orientation","url"],"uniqueKey":"hits.items.[INDEX].oneOf.1.images.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.images","typeLabel":"object[]"},"series":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.series.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.series.urn","typeLabel":"string"}},"required":["name","urn"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.series","typeLabel":"object"},"set":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set.name","typeLabel":"string"},"urn":{"type":"string","pattern":"[^/]$","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set.urn","typeLabel":"string"},"counts":{"type":"object","properties":{"printed":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.1.set.counts.printed","typeLabel":"number"},"total":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.1.set.counts.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set.counts","typeLabel":"object"},"references":{"type":"array","items":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.1.set.references.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set.references","typeLabel":"string[]"},"size":{"type":"number","uniqueKey":"hits.items.[INDEX].oneOf.1.set.size","typeLabel":"number"},"symbol":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set.symbol.url","typeLabel":"string"}},"required":["url"],"uniqueKey":"hits.items.[INDEX].oneOf.1.set.symbol","typeLabel":"object"},"released":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.1.set.released","typeLabel":"string"}},"required":["name","urn","counts","references"],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.set","typeLabel":"object"},"description":{"type":"string","uniqueKey":"hits.items.[INDEX].oneOf.1.description","typeLabel":"string"},"price":{"type":"integer","uniqueKey":"hits.items.[INDEX].oneOf.1.price","typeLabel":"integer"},"available":{"type":"integer","default":0,"description":"Total available for this listing","uniqueKey":"hits.items.[INDEX].oneOf.1.available","typeLabel":"integer"},"quantity":{"type":"integer","default":0,"description":"Total quantity available","uniqueKey":"hits.items.[INDEX].oneOf.1.quantity","typeLabel":"integer"},"min":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.min.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the cheapest listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.min.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.min.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"hits.items.[INDEX].oneOf.1.min","typeLabel":"object"},"max":{"type":"object","properties":{"price":{"oneOf":[{"type":"integer","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.max.price.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Price of the most expensive listing in pence","isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.max.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"hits.items.[INDEX].oneOf.1.max.price","typeLabel":"integer | null"}},"required":["price"],"uniqueKey":"hits.items.[INDEX].oneOf.1.max","typeLabel":"object"}},"uniqueKey":"hits.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"hits.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"hits","typeLabel":"object[]"},"facets":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"facets.additionalProperties.additionalProperties","typeLabel":"number"},"uniqueKey":"facets.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"facets","typeLabel":"object"}},"required":["total","hits","facets"],"uniqueKey":"","typeLabel":"object"},"examples":{"PokemonTextSearchResponse":{"title":"PokemonTextSearchResponse","description":"Observed live response for a simple Pokemon text search (`query: pokemon`, `size: 1`).","value":{"total":4217,"hits":[{"urn":"urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283","type":"product","game":"Pokemon","title":"Miscellaneous: Pokemon Stacking Tin: Paradox Pokemon","name":"Pokemon Stacking Tin: Paradox Pokemon","classification":"BOX","count":1,"description":"Stack 'Em High! Choose a tin with powerful Pokemon from Paldea or Kitakami.","images":[{"urn":"urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0","orientation":"portrait","url":"https://images.managem.co.uk/urn:managem:pokemon:set/miscellaneous/product/pokemon-stacking-tin-paradox-pokemon-a4cf2283/image/0"}],"series":{"name":"Miscellaneous","urn":"urn:managem:pokemon:series/miscellaneous"},"set":{"name":"Miscellaneous","urn":"urn:managem:pokemon:set/miscellaneous","counts":{"printed":0,"total":0},"symbol":{"url":"https://images.managem.co.uk/7722e2a1-df84-41ff-9c0f-41b82b144500"},"references":[]},"available":0,"quantity":0,"slug":"pokemon/product/miscellaneous/pokemon-stacking-tin-paradox-pokemon-a4cf2283"}],"facets":{"Game":{"Pokemon":4203,"Magic: The Gathering":14},"Product Type":{"card":2589,"product":1628},"Set":{"151":63,"Miscellaneous":564,"Pokemon GO":125},"Availability":{"In Stock":120},"Price":{"Under £1":118,"£1-£10":2,"£10-£20":0,"£20-£50":0,"£50-£100":0,"Over £100":1}}}},"PokemonCardsOnlyResponse":{"title":"PokemonCardsOnlyResponse","description":"Observed live response when filtering to Pokemon card results only.","value":{"total":2581,"hits":[{"urn":"urn:managem:pokemon:set/base-set-2/card/105","type":"card","game":"Pokemon","title":"Base Set 2: Pokemon Breeder","name":"Pokemon Breeder","rarity":"Rare","number":"105","set":{"name":"Base Set 2","urn":"urn:managem:pokemon:set/base-set-2","counts":{"printed":130,"total":130},"symbol":{"url":"https://images.managem.co.uk/urn:managem:pokemon:set/base-set-2/symbol/0"},"released":"2000-02-24T00:00:00.000Z","references":["base4","base04","B2","b2"]},"series":{"name":"Base","urn":"urn:managem:pokemon:series/base"},"images":[{"urn":"urn:managem:pokemon:set/base-set-2/card/105/image/0","illustrator":"Ken Sugimori","orientation":"portrait","url":"https://images.managem.co.uk/urn:managem:pokemon:set/base-set-2/card/105/image/0"}],"available":0,"quantity":0,"slug":"pokemon/card/base-set-2/105"}],"facets":{"Game":{"Pokemon":2581},"Product Type":{"card":2581},"Set":{"Pokemon GO":88,"Paldea Evolved":82,"Paradox Rift":70},"Availability":{"In Stock":118},"Price":{"Under £1":117,"£1-£10":1,"£10-£20":0,"£20-£50":0,"£50-£100":0,"Over £100":0}}}},"PikachuSetSortedByPriceResponse":{"title":"PikachuSetSortedByPriceResponse","description":"Observed live response for `pikachu` in set `151`, sorted by ascending price.","value":{"total":2,"hits":[{"urn":"urn:managem:pokemon:set/151/card/25","type":"card","game":"Pokemon","title":"151: Pikachu","name":"Pikachu","rarity":"Common","number":"25","description":"When it is angered, it immediately discharges the energy stored in the pouches in its cheeks.","set":{"name":"151","urn":"urn:managem:pokemon:set/151","counts":{"printed":165,"total":207},"symbol":{"url":"https://images.managem.co.uk/urn:managem:pokemon:set/151/symbol/0"},"released":"2023-09-21T23:00:00.000Z","references":["sv3pt5","sv03t5","MEW","mew"]},"series":{"name":"Scarlet \u0026 Violet","urn":"urn:managem:pokemon:series/scarlet-and-violet"},"images":[{"urn":"urn:managem:pokemon:set/151/card/25/image/0","illustrator":"Naoyo Kimura","orientation":"portrait","url":"https://images.managem.co.uk/urn:managem:pokemon:set/151/card/25/image/0"}],"available":2,"quantity":2,"min":{"price":3},"max":{"price":3},"slug":"pokemon/card/151/25"}],"facets":{"Game":{"Pokemon":2},"Product Type":{"card":2},"Set":{"151":2},"Availability":{"In Stock":1},"Price":{"Under £1":1,"£1-£10":0,"£10-£20":0,"£20-£50":0,"£50-£100":0,"Over £100":0}}}},"PokemonInStockBrowseResponse":{"title":"PokemonInStockBrowseResponse","description":"Observed live response for facet-only in-stock Pokemon browsing.","value":{"total":768,"hits":[{"urn":"urn:managem:pokemon:set/chilling-reign/card/15","type":"card","game":"Pokemon","title":"Chilling Reign: Tsareena","name":"Tsareena","rarity":"Rare","number":"15","description":"A kick from the hardened tips of this Pokemon's legs leaves a wound in the opponent's body and soul that will never heal.","set":{"name":"Chilling Reign","urn":"urn:managem:pokemon:set/chilling-reign","counts":{"printed":198,"total":233},"symbol":{"url":"https://images.managem.co.uk/urn:managem:pokemon:set/chilling-reign/symbol/0"},"released":"2021-06-17T23:00:00.000Z","references":["swsh6","swsh06","CRE","cre"]},"series":{"name":"Sword \u0026 Shield","urn":"urn:managem:pokemon:series/sword-and-shield"},"images":[{"urn":"urn:managem:pokemon:set/chilling-reign/card/15/image/0","illustrator":"Yuu Nishida","orientation":"portrait","url":"https://images.managem.co.uk/urn:managem:pokemon:set/chilling-reign/card/15/image/0"}],"available":1,"quantity":1,"min":{"price":10},"max":{"price":10},"slug":"pokemon/card/chilling-reign/15"}],"facets":{"Game":{"Pokemon":768},"Product Type":{"card":765,"product":3},"Set":{"151":60,"Fusion Strike":183,"Chilling Reign":129},"Availability":{"In Stock":768},"Price":{"Under £1":709,"£1-£10":50,"£10-£20":4,"£20-£50":3,"£50-£100":0,"Over £100":2}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"a1faa4d7-f526-41b5-8c48-d2be7d297f34":{"url":"https://api.managem.co.uk","description":"Production API"}}},"originalFileLocation":"https://api.managem.co.uk/doc"},"subdomain":"managem","siteName":"docs","title":"Full-text faceted search - docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-29T05:02:00.068Z","originalFileLocation":"api-reference/search/full-text-faceted-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=\"This is the main marketplace search endpoint. Use it for: - global search bars - category and filter pages - any browse/results screen where users need discoverability Behavior: - Accepts free-text query, facet filters, sorting, and paging input. - Returns matching items plus facet aggregations so the UI can render filter chips and counts. Good to know: - Results are cached briefly (~30s) for identical request bodies. - Different JSON bodies generate different cache keys.\">\u003cmeta data-mint-head name=\"application-name\" content=\"docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_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/managem/tj0HUBDvoCmgK6BV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Full-text faceted search - docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"This is the main marketplace search endpoint. Use it for: - global search bars - category and filter pages - any browse/results screen where users need discoverability Behavior: - Accepts free-text query, facet filters, sorting, and paging input. - Returns matching items plus facet aggregations so the UI can render filter chips and counts. Good to know: - Results are cached briefly (~30s) for identical request bodies. - Different JSON bodies generate different cache keys.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://managem.mintlify.app/_mintlify/api/og/v2?division=Cards+%26+sealed+products\u0026amp;title=Full-text+faceted+search\u0026amp;description=%0AThis+is+the+main+marketplace+search+endpoint.%0A%0AUse+it+for%3A%0A-+global+search+bars%0A-+category+and+filter+pages%0A-+any+browse%2Fresults+screen+where+users+need+discov\u0026amp;theme=be07e209d93d2fc80a8b1eae\u0026amp;signature=75ff48ad4908d7cf32ccf96b990c289083f163c1b40720bde9fcd2b7436d05d5\">\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=\"Full-text faceted search - docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This is the main marketplace search endpoint. Use it for: - global search bars - category and filter pages - any browse/results screen where users need discoverability Behavior: - Accepts free-text query, facet filters, sorting, and paging input. - Returns matching items plus facet aggregations so the UI can render filter chips and counts. Good to know: - Results are cached briefly (~30s) for identical request bodies. - Different JSON bodies generate different cache keys.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://managem.mintlify.app/_mintlify/api/og/v2?division=Cards+%26+sealed+products\u0026amp;title=Full-text+faceted+search\u0026amp;description=%0AThis+is+the+main+marketplace+search+endpoint.%0A%0AUse+it+for%3A%0A-+global+search+bars%0A-+category+and+filter+pages%0A-+any+browse%2Fresults+screen+where+users+need+discov\u0026amp;theme=be07e209d93d2fc80a8b1eae\u0026amp;signature=75ff48ad4908d7cf32ccf96b990c289083f163c1b40720bde9fcd2b7436d05d5\">\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/managem/tj0HUBDvoCmgK6BV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#927dff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/search/full-text-faceted-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.managem.co.uk/#organization\",\"name\":\"docs\",\"url\":\"https://docs.managem.co.uk\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/managem/JwthiBp-Ca5zDncq/logo/logo.svg?fit=max\u0026auto=format\u0026n=JwthiBp-Ca5zDncq\u0026q=85\u0026s=781554ca2edef422e6d5522cec6abe6f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.managem.co.uk#website\",\"name\":\"docs\",\"url\":\"https://docs.managem.co.uk\",\"publisher\":{\"@id\":\"https://docs.managem.co.uk/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search#webpage\",\"url\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search\",\"name\":\"Full-text faceted search\",\"description\":\"This is the main marketplace search endpoint. Use it for: - global search bars - category and filter pages - any browse/results screen where users need discoverability Behavior: - Accepts free-text query, facet filters, sorting, and paging input. - Returns matching items plus facet aggregations so the UI can render filter chips and counts. Good to know: - Results are cached briefly (~30s) for identical request bodies. - Different JSON bodies generate different cache keys.\",\"dateModified\":\"2026-03-29T05:02:00.068Z\",\"isPartOf\":{\"@id\":\"https://docs.managem.co.uk#website\"},\"breadcrumb\":{\"@id\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Search\",\"item\":\"https://docs.managem.co.uk/marketplace/search-and-data\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Full-text faceted search\",\"item\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search#apireference\",\"headline\":\"Full-text faceted search\",\"name\":\"Full-text faceted search\",\"description\":\"This is the main marketplace search endpoint. Use it for: - global search bars - category and filter pages - any browse/results screen where users need discoverability Behavior: - Accepts free-text query, facet filters, sorting, and paging input. - Returns matching items plus facet aggregations so the UI can render filter chips and counts. Good to know: - Results are cached briefly (~30s) for identical request bodies. - Different JSON bodies generate different cache keys.\",\"url\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.managem.co.uk/api-reference/search/full-text-faceted-search#webpage\"},\"dateModified\":\"2026-03-29T05:02:00.068Z\",\"publisher\":{\"@id\":\"https://docs.managem.co.uk/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.managem.co.uk#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"docs","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"book","href":"https://docs.managem.co.uk"},{"anchor":"Connect AI","icon":"bot","href":"/mcp"}]},"tabs":[{"tab":"Marketplace","icon":"store","groups":[{"group":"Search","icon":"binoculars","pages":[{"title":"Search \u0026 Data","description":"Discovery and searching is easy on Managem with our Search \u0026 Data APIs","href":"/marketplace/search-and-data"},{"group":"Cards \u0026 sealed products","pages":[{"title":"Full-text faceted search","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search","href":"/api-reference/search/full-text-faceted-search"},{"title":"Lookup item","description":"\nResolve a single indexed item using either a URN or a slug.\n\nUse this when opening an item detail page from a stable identifier.\n\nBehavior:\n- Accepts query parameters for `urn` or `slug`.\n- Returns the matched indexed item document when found.\n- Returns `404` when no matching item exists.\n\nGood to know:\n- 200 and 404 responses are both cacheable for a short period, which helps repeated lookups.\n","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /search/lookup","href":"/api-reference/search/lookup-item"},{"title":"Lookup items by URN","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/lookup/bulk","href":"/api-reference/search/lookup-items-by-urn"},{"title":"Vector image search","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/vector","href":"/api-reference/search/vector-image-search"}]},{"group":"Users","pages":[{"title":"Search users","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/users","href":"/api-reference/search/search-users"}]},{"group":"Hierarchy","pages":[{"title":"Full hierarchy","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /search/hierarchy","href":"/api-reference/search/full-hierarchy"},{"title":"Hierarchy by games","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/hierarchy/{game}","href":"/api-reference/search/hierarchy-by-games"},{"title":"Hierarchy by set","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/hierarchy/{game}/{set}","href":"/api-reference/search/hierarchy-by-set"},{"title":"Hierarchy by product","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /search/hierarchy/{game}/{set}/{type}","href":"/api-reference/search/hierarchy-by-product"}]}]},{"group":"Data","icon":"database","pages":[{"title":"URNs","href":"/marketplace/data/urn"},{"title":"Items","href":"/marketplace/data/items"},{"title":"Pokemon","href":"/marketplace/data/pokemon"},{"title":"Lorcana","href":"/marketplace/data/lorcana"},{"title":"Riftbound","href":"/marketplace/data/riftbound"},{"title":"Star Wars Unlimited","href":"/marketplace/data/star-wars-unlimited"},{"title":"Magic: The Gathering","href":"/marketplace/data/magic-the-gathering"}]},{"group":"Listings","icon":"list","pages":[{"title":"Search all live listings","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /listings","href":"/api-reference/listings/search-all-live-listings"},{"title":"Search a seller's listings","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /listings/seller/{id}","href":"/api-reference/listings/search-a-sellers-listings"},{"title":"Search listings for an item","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc post /listings/item","href":"/api-reference/listings/search-listings-for-an-item"},{"title":"Retrieve historical prices","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /listings/prices","href":"/api-reference/listings/retrieve-historical-prices"}]},{"group":"Profile","icon":"user","pages":[{"title":"Get profile","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /profile/{identifier}","href":"/api-reference/profile/get-profile"},{"title":"List reviews","deprecated":null,"version":null,"openapi":"https://api.managem.co.uk/doc get /profile/{identifier}/reviews","href":"/api-reference/profile/list-reviews"}]},{"group":"Third party integrations","icon":"handshake","pages":[{"title":"Getting started","href":"/marketplace/third-party-integrations"},{"title":"Authentication","href":"/marketplace/integrations/authenticate-users"},{"title":"Managing Listings","href":"/marketplace/integrations/managing-listings"}]}]},{"tab":"Sellers","pages":[{"title":"Sellers","href":"/sellers"}]},{"tab":"Buyers","pages":[{"title":"Buyers","href":"/api-reference/basket/get-basket-items"}]}]},"title":"Full-text faceted search - docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}