Short-lived session token to include in subsequent requests
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Glood.AI: AI-Powered Commerce Solutions","colors":{"primary":"#153A4A","light":"#FF9F8A","dark":"#153A4A"},"logo":{"light":"https://mintcdn.com/gloodai/PlqgQA6WIn5Qmrbw/logo/glood-light.svg?fit=max\u0026auto=format\u0026n=PlqgQA6WIn5Qmrbw\u0026q=85\u0026s=873d27c50626460b46936d8501310622","dark":"https://mintcdn.com/gloodai/PlqgQA6WIn5Qmrbw/logo/glood-dark.svg?fit=max\u0026auto=format\u0026n=PlqgQA6WIn5Qmrbw\u0026q=85\u0026s=dbb8bada5baa01f983fa0b69123dbae9"},"favicon":"https://mintcdn.com/gloodai/PTi15WhxaSq2cZPd/favicon.svg?fit=max\u0026auto=format\u0026n=PTi15WhxaSq2cZPd\u0026q=85\u0026s=49af01e447263ce7fd47628420353efc","api":{"openapi":"api-reference/openapi.json"},"appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"mailto:support@glood.ai","label":"Support"}],"primary":{"type":"button","label":"Install for Free","href":"https://apps.shopify.com/recommendation-kit"}},"footer":{"socials":{"x":"https://x.com/glood_ai","linkedin":"https://www.linkedin.com/company/glood-ai"}},"integrations":{"intercom":{"appId":"s2m1k3bl"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://glood.ai"},{"anchor":"Install for Free","icon":"play","href":"https://apps.shopify.com/recommendation-kit"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gloodai","hasAudioNarration":false,"actualSubdomain":"gloodai","customDomains":["docs.glood.ai"],"gitSource":{"type":"github","owner":"loopclub","repo":"glood-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aeb1b0ec8520f7b8ee225ea","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"For Developers","count":98},{"language":"default","tag":"Documentation","count":57},{"language":"default","tag":"Guides","count":34},{"language":"default","tag":"API Reference","count":28},{"language":"default","tag":"Platform","count":26},{"language":"default","tag":"Hydrogen SDK","count":22},{"language":"default","tag":"Headless APIs","count":15},{"language":"default","tag":"AI Search \u0026 Merchandising","count":14},{"language":"default","tag":"Creating Sections","count":12},{"language":"default","tag":"Search","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/recommendations/headless/init","slug":"/api-reference/recommendations/headless/init","pageMetadata":{"title":"Headless Init","openapi":"POST /api/storefront/v3/headless/init","description":"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.","href":"/api-reference/recommendations/headless/init"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\"\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":"Headless Init","openapi":"POST /api/storefront/v3/headless/init","description":"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.","href":"/api-reference/recommendations/headless/init"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.","parameters":["103125b6-d47c-403a-b69e-127d854c4bc5"],"requestBody":"ef7ee1e9-cbba-4a1a-b049-0aca5e3a466b","responses":{"200":"6e7e22dc-4186-48cf-a6d8-530442783089","400":"4774af49-7d2a-4e26-87a7-18e708ca43c5"},"method":"post","type":"path","servers":["f7b99dcb-afea-455d-adbd-6cfb8b5220c1"],"security":["af96273f-410b-4ec8-8ec8-b0b99406ae76"],"path":"/api/storefront/v3/headless/init","baseUrlOptions":["https://storefront.glood.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"103125b6-d47c-403a-b69e-127d854c4bc5":{"name":"x-shop","in":"header","description":"Shopify store URL","required":true,"schema":{"type":"string","example":"shop.myshopify.com","isRequired":true,"description":"Shopify store URL","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"Visitor identification payload","content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Anonymous visitor identifier (persisted across sessions)","uniqueKey":"user_id","typeLabel":"string"},"client_id":{"type":"string","description":"Client/device identifier for the current session","uniqueKey":"client_id","typeLabel":"string"},"customer_id":{"type":"string","description":"Shopify customer ID for authenticated visitors","uniqueKey":"customer_id","typeLabel":"string"},"page_type":{"type":"string","description":"Type of the current page","enum":["home","product","collection","cart","checkout","order_status","search","other"],"uniqueKey":"page_type","typeLabel":"enum\u003cstring>"},"page_url":{"type":"string","description":"Full URL of the current page","uniqueKey":"page_url","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"user_id":"\u003cstring>","client_id":"\u003cstring>","customer_id":"\u003cstring>","page_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6e7e22dc-4186-48cf-a6d8-530442783089":{"description":"Visitor context and shop configuration","content":{"application/json":{"schema":{"type":"object","properties":{"visit_id":{"type":"string","description":"Unique identifier for this visit session","uniqueKey":"visit_id","typeLabel":"string"},"user_id":{"type":"string","description":"Anonymous visitor identifier to persist on the client","uniqueKey":"user_id","typeLabel":"string"},"client_id":{"type":"string","description":"Client/device identifier","uniqueKey":"client_id","typeLabel":"string"},"customer_id":{"type":"string","description":"Shopify customer ID if authenticated","uniqueKey":"customer_id","typeLabel":"string"},"visitor":{"type":"object","description":"Visitor's historical activity context","properties":{"browsed_products":{"type":"array","items":{"type":"integer","uniqueKey":"visitor.browsed_products.items.[INDEX]","typeLabel":"integer"},"description":"Product IDs recently viewed by the visitor","uniqueKey":"visitor.browsed_products","typeLabel":"integer[]"},"cart_products":{"type":"array","items":{"type":"integer","uniqueKey":"visitor.cart_products.items.[INDEX]","typeLabel":"integer"},"description":"Product IDs currently in the visitor's cart","uniqueKey":"visitor.cart_products","typeLabel":"integer[]"},"purchased_products":{"type":"array","items":{"type":"integer","uniqueKey":"visitor.purchased_products.items.[INDEX]","typeLabel":"integer"},"description":"Product IDs previously purchased by the visitor","uniqueKey":"visitor.purchased_products","typeLabel":"integer[]"}},"uniqueKey":"visitor","typeLabel":"object"},"config":{"type":"object","description":"Shop configuration relevant to the storefront","properties":{"shop":{"type":"object","properties":{"money_format":{"type":"string","description":"Shopify money format string","uniqueKey":"config.shop.money_format","typeLabel":"string"},"currency":{"type":"string","description":"Shop's default currency code","uniqueKey":"config.shop.currency","typeLabel":"string"}},"uniqueKey":"config.shop","typeLabel":"object"},"integrations_enabled":{"type":"boolean","description":"Whether Glood integrations are active for this shop","uniqueKey":"config.integrations_enabled","typeLabel":"boolean"},"product_review_app":{"type":"string","description":"Product review app integrated with the shop, if any","uniqueKey":"config.product_review_app","typeLabel":"string"},"analytics_enabled":{"type":"boolean","description":"Whether analytics tracking is enabled","uniqueKey":"config.analytics_enabled","typeLabel":"boolean"},"skip_parent_product":{"type":"boolean","description":"Whether to skip the parent product in recommendation results","uniqueKey":"config.skip_parent_product","typeLabel":"boolean"}},"uniqueKey":"config","typeLabel":"object"},"token":{"type":"string","description":"Short-lived session token to include in subsequent requests","uniqueKey":"token","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"visit_id":"\u003cstring>","user_id":"\u003cstring>","client_id":"\u003cstring>","customer_id":"\u003cstring>","visitor":{"browsed_products":[123],"cart_products":[123],"purchased_products":[123]},"config":{"shop":{"money_format":"\u003cstring>","currency":"\u003cstring>"},"integrations_enabled":true,"product_review_app":"\u003cstring>","analytics_enabled":true,"skip_parent_product":true},"token":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4774af49-7d2a-4e26-87a7-18e708ca43c5":{"description":"Validation error","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"af96273f-410b-4ec8-8ec8-b0b99406ae76":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"f7b99dcb-afea-455d-adbd-6cfb8b5220c1":{"url":"https://storefront.glood.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"gloodai","siteName":"Glood.AI: AI-Powered Commerce Solutions","title":"Headless Init - Glood.AI: AI-Powered Commerce Solutions","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-30T10:37:35.971Z","originalFileLocation":"api-reference/recommendations/headless/init.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=\"light\"}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=\"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Glood.AI: AI-Powered Commerce Solutions\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_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/gloodai/BGCDgfNoJl8EzFWD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Headless Init - Glood.AI: AI-Powered Commerce Solutions\">\u003cmeta data-mint-head property=\"og:description\" content=\"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Glood.AI: AI-Powered Commerce Solutions\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.glood.ai/api-reference/recommendations/headless/init\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gloodai.mintlify.site/_mintlify/api/og/v2?division=Headless+APIs\u0026amp;title=Headless+Init\u0026amp;description=Identify+a+visitor+and+retrieve+shop+configuration.+Call+this+once+per+session+before+fetching+sections+or+sending+events.\u0026amp;theme=c55c0792e66686b6e5aabfbc\u0026amp;signature=0ff28e6153aa31b7bcb7c5937e0bba0ea08136971d779b90bc5f9916e108206c\">\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=\"Headless Init - Glood.AI: AI-Powered Commerce Solutions\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gloodai.mintlify.site/_mintlify/api/og/v2?division=Headless+APIs\u0026amp;title=Headless+Init\u0026amp;description=Identify+a+visitor+and+retrieve+shop+configuration.+Call+this+once+per+session+before+fetching+sections+or+sending+events.\u0026amp;theme=c55c0792e66686b6e5aabfbc\u0026amp;signature=0ff28e6153aa31b7bcb7c5937e0bba0ea08136971d779b90bc5f9916e108206c\">\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/gloodai/BGCDgfNoJl8EzFWD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Glood.AI: AI-Powered Commerce Solutions\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#153A4A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.glood.ai/api-reference/recommendations/headless/init\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/recommendations/headless/init.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.glood.ai/#organization\",\"name\":\"Glood.AI: AI-Powered Commerce Solutions\",\"url\":\"https://docs.glood.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gloodai/PlqgQA6WIn5Qmrbw/logo/glood-light.svg?fit=max\u0026auto=format\u0026n=PlqgQA6WIn5Qmrbw\u0026q=85\u0026s=873d27c50626460b46936d8501310622\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.glood.ai#website\",\"name\":\"Glood.AI: AI-Powered Commerce Solutions\",\"url\":\"https://docs.glood.ai\",\"publisher\":{\"@id\":\"https://docs.glood.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.glood.ai/api-reference/recommendations/headless/init#webpage\",\"url\":\"https://docs.glood.ai/api-reference/recommendations/headless/init\",\"name\":\"Headless Init\",\"description\":\"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\",\"dateModified\":\"2026-03-30T10:37:35.971Z\",\"isPartOf\":{\"@id\":\"https://docs.glood.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.glood.ai/api-reference/recommendations/headless/init#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.glood.ai/api-reference/recommendations/headless/init#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Glood.AI: AI-Powered Commerce Solutions\",\"item\":\"https://docs.glood.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Headless Init\",\"item\":\"https://docs.glood.ai/api-reference/recommendations/headless/init\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.glood.ai/api-reference/recommendations/headless/init#apireference\",\"headline\":\"Headless Init\",\"name\":\"Headless Init\",\"description\":\"Identify a visitor and retrieve shop configuration. Call this once per session before fetching sections or sending events.\",\"url\":\"https://docs.glood.ai/api-reference/recommendations/headless/init\",\"mainEntityOfPage\":{\"@id\":\"https://docs.glood.ai/api-reference/recommendations/headless/init#webpage\"},\"dateModified\":\"2026-03-30T10:37:35.971Z\",\"publisher\":{\"@id\":\"https://docs.glood.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.glood.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Glood.AI: AI-Powered Commerce Solutions\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Glood.AI: AI-Powered Commerce Solutions\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/recommendations/headless/init.md","siteName":"Glood.AI: AI-Powered Commerce Solutions","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://glood.ai"},{"anchor":"Install for Free","icon":"play","href":"https://apps.shopify.com/recommendation-kit"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"AI Search \u0026 Merchandising","pages":[{"title":"AI Search \u0026 Merchandising","href":"/ai-search-merchandising"}]},{"tab":"AI Image \u0026 Video Editor","pages":[{"title":"AI Image \u0026 Video Editor","href":"/ai-image-video-editor"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/dashboard/getting-started"}]},{"tab":"For Developers","pages":[{"title":"For Developers","href":"/for-developers/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API reference","description":"Integrate Glood.AI recommendations and search into any storefront","href":"/api-reference/introduction"}]},{"group":"Product Recommendations","pages":[{"group":"Headless APIs","pages":[{"title":"Headless Init","openapi":"POST /api/storefront/v3/headless/init","href":"/api-reference/recommendations/headless/init"},{"title":"Get Headless Sections","openapi":"POST /api/storefront/v3/headless/sections","description":"Get recommendation sections with full product details for a given page context.","href":"/api-reference/recommendations/headless/sections"},{"title":"Send Headless Events","openapi":"POST /api/storefront/v3/headless/events","href":"/api-reference/recommendations/headless/events"},{"title":"Get Headless Recommendations using Query","openapi":"POST /api/storefront/v3/headless/recommendations","href":"/api-reference/recommendations/headless/recommendations"},{"title":"Get Customer Recommendations","openapi":"POST /api/storefront/v3/headless/recommendations/customer","href":"/api-reference/recommendations/headless/customer-recommendations"},{"title":"Get Automatic Recommendations","openapi":"POST /api/storefront/v3/headless/recommendations/automatic","href":"/api-reference/recommendations/headless/automatic-recommendations"},{"title":"Get Top Recommendations","openapi":"POST /api/storefront/v3/headless/recommendations/top","href":"/api-reference/recommendations/headless/top-recommendations"}]},{"group":"Partner APIs","pages":[{"title":"Partner APIs","tag":"COMING SOON","href":"/api-reference/recommendations/partners/introduction"}]}]},{"group":"Search","pages":[{"title":"Search APIs","href":"/api-reference/search/introduction"},{"group":"Headless APIs","pages":[{"title":"Headless Search Init","openapi":"POST /api/storefront/v1/headless/init","href":"/api-reference/search/headless/init"},{"title":"Search Config","openapi":"POST /api/storefront/v1/headless/config","href":"/api-reference/search/headless/config"},{"title":"Instant Search","openapi":"POST /api/storefront/v1/headless/instant-search","href":"/api-reference/search/headless/instant-search"},{"title":"Filters","openapi":"POST /api/storefront/v1/headless/filters","href":"/api-reference/search/headless/filters"},{"title":"Filter Aggregations","openapi":"POST /api/storefront/v1/headless/filter-aggregations","href":"/api-reference/search/headless/filter-aggregations"},{"title":"Search","openapi":"POST /api/storefront/v1/headless/search","href":"/api-reference/search/headless/search"},{"title":"Image Search","openapi":"POST /api/storefront/v1/headless/image-search","href":"/api-reference/search/headless/image-search"},{"title":"Send Search Events","openapi":"POST /api/storefront/v1/headless/events","href":"/api-reference/search/headless/events"}]}]}]}]},"basePath":"","title":"Headless Init - Glood.AI: AI-Powered Commerce Solutions","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}