{"uid":"cap_Z43Ei96-nluizJF5ifsGx","slug":"shopperpulse-birdie-ai-personal-shopper-d37b1e71","name":"ShopperPulse Birdie AI Personal Shopper","description":"Birdie, the AI personal shopper: POST a shopping list (up to 3 items, free text or structured) and get back 3 best-fit picks per item plus a stacked savings plan — loyalty %, coupons, discounted gift cards, and the right credit card — researched live across the PulseNetwork shopping fleet. Best fit to your spec wins, not the cheapest listing.","url":"https://shopperpulse.theaslangroupllc.com/api/shopper/trip","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"type":"string","description":"optional response language"},"list":{"type":"string","description":"JSON body alternative: free-text shopping list, parsed automatically"},"items":{"type":"string","description":"JSON body array, max 3: [{ query: \"what you want with specs\", budget_usd?: 20, used?: true, ethical?: true, local?: \"Austin TX\" }]"}}},"responseSchema":{"type":"json","example":{"trip":{"items":[{"picks":[{"why":"US-made hickory, matches spec under budget","name":"Vater 5A Hickory","rank":1,"links":["https://example.com/vater-5a"],"where":"Sweetwater","est_price":"$14"}],"request":"5A hickory drumsticks made in USA"}],"savings_plan":{"steps":[{"step":1,"action":"Join retailer loyalty program (5% first order)","estimated_savings":"$1.00"}]},"total_estimated":"$38","card_recommendation":"Flat 2% cashback card — no category bonus applies here"},"disclosure":"Birdie earns commissions from some links; her picks don’t.","generated_at":"2026-07-18T20:00:00.000Z"}},"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_ztEVgkoVLKTXi4qQltWBc","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":"POST a shopping list and receive the 3 best-fit product picks per item plus a stacked savings plan covering loyalty programs, coupons, discounted gift cards, and credit card recommendations.","exampleAgentPrompt":"I need to buy 5A hickory drumsticks made in the USA, a snare drum stand, and a practice pad — find me the 3 best picks for each item and put together a savings plan with loyalty programs, coupons, and the best credit card to use.","exampleUseCases":[{"title":"Budget back-to-school supply run","prompt":"I need to buy a 15-inch laptop backpack, a set of gel pens, and a scientific calculator — find me the top 3 options for each and tell me how to stack savings using loyalty programs, coupons, and the right credit card."},{"title":"Home gym gear shopping trip","prompt":"Help me put together a shopping trip for a yoga mat, a set of resistance bands, and a foam roller — I want the 3 best picks per item and a full savings plan showing me which loyalty programs to join and what card to pay with."},{"title":"Holiday gift list optimization","prompt":"I have a gift list: a LEGO Technic set for a 10-year-old, a cashmere scarf for my mom, and noise-cancelling headphones under $150 — give me 3 best options for each and a savings plan with coupons, discounted gift cards, and the best credit card."}],"resultDescription":"Returns a structured trip object containing up to 3 ranked product picks per shopping list item (with product name, retailer, estimated price, purchase link, and a reason for the recommendation), a step-by-step savings plan (loyalty signups, coupons, discounted gift cards), an overall estimated total, a credit card recommendation, a disclosure about affiliate commissions, and a generation timestamp.","failureModes":["Empty or malformed shopping list returns no picks","Highly niche or ambiguous item descriptions may yield low-confidence recommendations","Retailer links in response may be affiliate links or become stale over time","No items found matching spec — pick list may be empty for that item","Network or payment authorization failure returns no response"],"whenToPreferThis":"Choose this endpoint when a user has a concrete list of items to buy and wants AI-curated product recommendations paired with an actionable savings strategy (loyalty, coupons, gift cards, credit card pairing) in a single call. Prefer it over general search APIs when stacked deal optimization and ranked picks per item are needed together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:45.305Z","isFirstParty":false}