> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glood.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Integrate Glood.AI recommendations and search into any storefront

Build personalized shopping experiences on Shopify with Glood.AI APIs. Use headless APIs for Hydrogen, mobile apps, and custom storefronts — or integrate via partner APIs.

## Product recommendations

<CardGroup cols={2}>
  <Card title="Initialize session" icon="rocket" href="/api-reference/recommendations/headless/init">
    Identify visitors, get shop config, and obtain a storefront token.
  </Card>

  <Card title="Get sections" icon="table-columns" href="/api-reference/recommendations/headless/sections">
    Fetch recommendation sections with full product details for your page.
  </Card>

  <Card title="Track events" icon="chart-line" href="/api-reference/recommendations/headless/events">
    Send tracking events from mobile apps and headless storefronts.
  </Card>

  <Card title="Query recommendations" icon="sparkles" href="/api-reference/recommendations/headless/recommendations">
    Get AI recommendations for specific products using flexible queries.
  </Card>
</CardGroup>

## Search

<Card title="Search APIs" icon="magnifying-glass" href="/api-reference/search/introduction">
  Semantic search, auto-suggestions, and intelligent product discovery.
</Card>

## Authentication

Pass your Shopify store URL in the `x-shop` header on all requests:

```bash theme={null}
-H "x-shop: your-store.myshopify.com"
```

For recommendation query endpoints, include the storefront token (obtained from `/init`) as a Bearer token:

```bash theme={null}
-H "Authorization: Bearer <storefront-token>"
```