{"uid":"cap_beUz8Y71PhzpzfD64byZW","slug":"the-gifting-brief-gift-matching-api-6a5b0d37","name":"The Gifting Brief – Gift Matching API","description":"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.","url":"https://thegiftingbrief.com/api/gift/brief","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"matches":{"type":"array","items":{"type":"object"}},"products":{"type":"array","items":{"type":"object"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZSaCZG6dYZiPxiUk6ov5o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns AI-matched gift recommendations from hand-verified Mississippi and Southern makers, filtered by budget, occasion, interests, and demographic","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Birthday gift for a foodie mom","prompt":"My mom's birthday is coming up and she loves cooking — can you find her a Mississippi-made gift under $60? She's a woman in her 60s and I'd love something really local and artisan."},{"title":"Wedding gift from Southern makers","prompt":"I need a wedding gift that comes from a Southern maker — budget is around $100. The couple is into home décor and entertaining. What does The Gifting Brief have that fits?"},{"title":"Corporate thank-you gift sourcing","prompt":"I need to send thank-you gifts to a group of clients — can you pull some Southern-made options under $40 each that would work for a professional occasion? General interests like food and lifestyle are fine."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:52.485Z","isFirstParty":false}