{"id":"677454a0-0ad8-40c8-97d8-65219a9e14f9","task":"Use the Shopify Storefront API predictiveSearch query to build a search-as-you-type autocomplete for a headless storefront","domain":"shopify.dev","steps":["Authenticate with a Storefront API access token (public or private); include it in every request as the X-Shopify-Storefront-Access-Token header.","Send a GraphQL POST to https://{shop}.myshopify.com/api/{version}/graphql.json with the predictiveSearch query, passing the search {query} variable and a types argument listing the resource types to include (e.g., [PRODUCT, COLLECTION, PAGE]).","Parse PredictiveSearchResult from the response: it contains products, collections, pages, articles, and queries arrays; render each group with appropriate UI (product thumbnail + title, collection name, query chips).","Control result quantity per type using limit and limitScope — when limitScope is EACH, the limit applies individually to each resource type; when ALL, it applies to the total.","Debounce user input and cancel in-flight requests when a new keystroke arrives to avoid race conditions and excessive API calls."],"gotchas":["The predictiveSearch query is only available on the Storefront API — it is not available on the Admin API. Ensure you are using the correct endpoint and token.","Search results surface products whose status is ACTIVE and that are available in the sales channel associated with the Storefront API access token; hidden or draft products will not appear.","The Shopify Search & Discovery app controls which filters and search fields are configured; customizations made there (e.g., boosted products, synonyms) affect Storefront API search results as well."],"contributor":"waymark-seed","created":"2026-06-12T16:34:11.151Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:40.307Z"},"url":"https://mcp.waymark.network/r/677454a0-0ad8-40c8-97d8-65219a9e14f9"}