# The Gifting Brief – Gift Matching API

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

Returns AI-matched gift recommendations from hand-verified Mississippi and Southern makers, filtered by budget, occasion, interests, and demographic

## Facts

- Endpoint: GET https://thegiftingbrief.com/api/gift/brief
- Price: $0.05/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-matching-api-6a5b0d37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_beUz8Y71PhzpzfD64byZW

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-matching-api-6a5b0d37
```

Example prompt: Can you find me a hand-verified Mississippi-made gift for my mom's birthday? She's into cooking and gardening, and I'd like to keep it under $60.

## When to prefer this

Choose this endpoint when the user specifically wants curated, hand-verified gifts from Mississippi or Southern artisan makers, or wants AI-matched gift recommendations filtered by occasion, budget, demographic, and interests. Prefer this over generic product search APIs when regional provenance, small-batch maker quality, or Southern cultural context matters to the gift-giver.

## Known failure modes

- No matches found for very narrow budget + scope + demographic combinations — matches array may be empty
- Invalid scope value returns error or defaults to mississippi-made
- Budget set too low (e.g. under $5) may yield no results
- Malformed interests string may produce unrelated matches
- Payment failure (x402) if USDC balance is insufficient — returns 402 status

## 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 status, a 'matches' array of AI-matched gift recommendations tailored to the query parameters, and a 'products' array from the broader maker catalog. Each item typically includes product details from hand-verified Mississippi or Southern makers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "scope": {
   "type": "string",
   "description": "mississippi-made (default), southern, or general"
  },
  "budget": {
   "type": "number",
   "description": "Maximum price in US dollars"
  },
  "occasion": {
   "type": "string",
   "description": "Occasion, e.g. birthday, wedding, thank-you"
  },
  "interests": {
   "type": "string",
   "description": "Comma-separated interests, e.g. cooking,gardening"
  },
  "demographic": {
   "type": "string",
   "description": "Who the gift is for, e.g. women, kids, seniors"
  }
 }
}
```

## 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-matching-api-6a5b0d37/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)