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.
Documentation
Full personal-shopper trip: 3 picks per item + stacked savings plan
Birdie researches each item across findpulse (best-fit products, used market, ethical sourcing, local options) and dealpulse (savings stacking, credit-card rewards), then assembles one trip report. Internal fleet calls are real x402 settlements — you are hiring an agent that itself pays specialist agents. FTC disclosure: Birdie earns commissions from some links; her picks don't.
**Price:** $0.25 USDC per call
Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.
Authentication
No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.
Request schema
{
"properties": {
"items": {
"description": "Structured shopping list (preferred). Max 3 items per trip.",
"items": {
"properties": {
"budget_usd": {
"description": "Per-item budget in USD",
"type": "number"
},
"ethical": {
"description": "Also research made-in-USA / handmade / sustainable sourcing",
"type": "boolean"
},
"local": {
"description": "City/area if you want local options, e.g. \"Austin TX\"",
"type": "string"
},
"query": {
"description": "What you want, with the specs that matter (size, material, origin, constraints)",
"maxLength": 300,
"type": "string"
},
"used": {
"description": "Also research the second-hand market",
"type": "boolean"
}
},
"required": [
"query"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"lang": {
"description": "Response language (default English)",
"type": "string"
},
"list": {
"description": "Alternative: free-text shopping list, parsed automatically (first 3 items kept)",
"type": "string"
}
},
"type": "object"
}
Example request
{
"items": [
{
"budget_usd": 20,
"query": "5A hickory drumsticks made in USA"
},
{
"budget_usd": 120,
"query": "quiet mechanical keyboard for open office"
}
]
}
Example response
{
"disclosure": "Birdie earns commissions from some links; her picks don't. Best fit to your spec wins even when we have no affiliate relationship.",
"generated_at": "2026-07-18T20:00:00.000Z",
"meta": {
"engines": [
"findpulse",
"dealpulse"
],
"fleet_calls_settled": 4,
"items_researched": 2
},
"trip": {
"card_recommendation": "Flat 2% cashback card — no category bonus applies here",
"items": [
{
"picks": [
{
"est_price": "$14",
"links": [
"https://example.com/vater-5a"
],
"name": "Vater 5A Hickory",
"rank": 1,
"where": "Sweetwater",
"why": "US-made hickory, matches spec under budget"
},
{
"est_price": "$15",
"links": [],
"name": "Vic Firth American Classic 5A",
"rank": 2,
"where": "Guitar Center",
"why": "US hickory benchmark, widely stocked"
}
],
"request": "5A hickory drumsticks made in USA"
}
],
"savings_plan": {
"steps": [
{
"action": "Join retailer loyalty program (5% first order)",
"estimated_savings": "$1.00",
"step": 1
}
]
},
"total_estimated": "$38"
}
}