# The Gifting Brief – Gift Catalog API

> The Gifting Brief – Gift Catalog API is a paid API for AI agents from thegiftingbrief.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns a curated catalog of hand-verified gifts from Mississippi makers, filterable by scope, category, occasion, and price

## Facts

- Endpoint: GET https://thegiftingbrief.com/api/gift/catalog
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-gifting-brief-gift-catalog-api-f92e654f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3GQO1AWz79AS6eBKj341-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability the-gifting-brief-gift-catalog-api-f92e654f
```

Example prompt: Can you pull up The Gifting Brief's Mississippi-made gift catalog and show me pottery gifts under $75 for a housewarming occasion?

## When to prefer this

Choose this endpoint when you need curated, hand-verified gift recommendations specifically from Mississippi or southern regional makers, especially when filtering by occasion, category, or budget. Prefer this over generic gift APIs when regional provenance, artisan authenticity, or maker-verified quality matters to the user.

## Known failure modes

- Invalid scope value returns no results or error
- Category or occasion string not recognized returns empty matches array
- price_max set to zero or negative may return no products
- Payment not completed (x402 protocol) results in 402 response blocking catalog access
- Network or upstream service unavailability returns non-ok response

## How this service works

Hand-verified gift intelligence from Mississippi makers. Curated recommendations, a full maker catalog, and live AI gift matching for people and AI agents. Part of the Parkland Archives consortium.

## Output

Returns a JSON object with an 'ok' boolean, a 'matches' array of AI-matched gift recommendations, and a 'products' array containing full catalog entries for gifts matching the requested scope, category, occasion, and price filters — each product entry includes maker and product details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "scope": {
   "type": "string",
   "description": "mississippi-made (default), southern, or general"
  },
  "category": {
   "type": "string",
   "description": "Filter by category, e.g. Food, Pottery, Art"
  },
  "occasion": {
   "type": "string",
   "description": "Filter by occasion"
  },
  "price_max": {
   "type": "number",
   "description": "Maximum price in US dollars"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ok"
 ],
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "matches": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "products": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-gifting-brief-gift-catalog-api-f92e654f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from thegiftingbrief.com](https://www.zero.xyz/host/thegiftingbrief.com/llms.txt)