{"uid":"cap_WEDD1Pl0iEccJanRoun2y","slug":"the-gifting-brief-ai-gift-match-45f1d332","name":"The Gifting Brief - AI Gift Match","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/match","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"age":{"type":"number","description":"Recipient age"},"avoid":{"type":"string","description":"Anything to avoid, e.g. alcohol"},"notes":{"type":"string","description":"Free-form context about the recipient"},"budget":{"type":"number","description":"Maximum price in US dollars (non-negative)"},"occasion":{"type":"string","description":"e.g. birthday"},"interests":{"type":"string","description":"Recipient interests as an array of strings or a comma-separated string, e.g. gardening, cooking"},"relationship":{"type":"string","description":"Who the recipient is to the giver, e.g. mother"}}},"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.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hO2srPbdPp3vuH19bXi9J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","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 Mississippi makers based on recipient profile, occasion, interests, and budget","exampleAgentPrompt":"Can you use The Gifting Brief to find me a handmade Mississippi-maker gift for my mother's 65th birthday — she loves gardening and cooking, budget is $80, and please avoid anything alcohol-related?","exampleUseCases":[{"title":"Birthday gift for craft-loving parent","prompt":"Find me a gift from The Gifting Brief for my dad's 70th birthday — he's really into woodworking and outdoor stuff, budget is around $60, and I want something handcrafted and unique."},{"title":"Holiday gift for a colleague","prompt":"I need a holiday gift for a coworker I don't know super well — she's in her 30s, seems to like home decor and candles, budget is $40, and nothing too personal. Can you check The Gifting Brief for ideas?"},{"title":"Kid's birthday gift from local makers","prompt":"My nephew is turning 8 and I want to get him something fun and creative from a local artisan — budget is $35, he's into dinosaurs and art, can you match something on The Gifting Brief?"}],"resultDescription":"Returns an object with an 'ok' boolean flag and arrays of matched gift products and maker catalog items. Each match is a product object from Mississippi makers, scored or ranked for fit against the recipient profile, occasion, and budget provided.","failureModes":["Invalid or missing budget (negative number) returns error","No matches found for very restrictive filters (narrow budget + many avoidances)","Malformed interests string may return generic results","Payment failure via x402 protocol returns 402 before processing","Missing all optional fields may return broad, less personalized results"],"whenToPreferThis":"Choose this endpoint when the user wants curated, handmade or artisan gift suggestions — especially from Mississippi-based makers — rather than generic Amazon-style product search. Best for occasions where thoughtful, hand-verified recommendations matter more than raw catalog breadth. Prefer over general e-commerce search when the user values local provenance, maker story, or wants AI-matched personalization rather than keyword search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:23.688Z","isFirstParty":false}