ShopperPulse

{
  "properties": {
    "domain": {
      "description": "Merchant domain or URL (normalized to the host)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}

{
  "properties": {
    "attribution": {
      "type": "string"
    },
    "band": {
      "enum": [
        "high",
        "medium",
        "low",
        "very_low",
        "avoid"
      ],
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "domain": {
      "type": "string"
    },
    "reasons": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "score": {
      "type": "integer"
    },
    "signals": {
      "type": "object"
    }
  },
  "type": "object"
}

{
  "attribution": "test",
  "band": "high",
  "checked_at": "test",
  "confidence": 1,
  "domain": "test",
  "reasons": [
    "test"
  ],
  "score": 1,
  "signals": {}
}

{
  "properties": {
    "country": {
      "description": "ISO-2 country code, or EU for EU/EEA-wide notices",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "q": {
      "description": "Product name, brand, or category",
      "minLength": 2,
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "since": {
      "description": "Only recalls on/after this date (YYYY-MM-DD)",
      "format": "date",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "q"
  ],
  "type": "object"
}

{
  "properties": {
    "attribution": {
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "recalls": {
      "items": {
        "properties": {
          "country": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "hazard": {
            "type": "string"
          },
          "official_url": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "remedy": {
            "type": "string"
          },
          "source": {
            "enum": [
              "US-CPSC",
              "OECD-GlobalRecalls"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "returned": {
      "type": "integer"
    },
    "sources": {
      "type": "object"
    },
    "total_matches": {
      "type": "integer"
    }
  },
  "type": "object"
}

{
  "attribution": "test",
  "checked_at": "test",
  "query": "test",
  "recalls": [
    {
      "country": "test",
      "date": "test",
      "hazard": "test",
      "official_url": "test",
      "product": "test",
      "remedy": "test",
      "source": "US-CPSC"
    }
  ],
  "returned": 1,
  "sources": {},
  "total_matches": 1
}

{
  "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"
}

{
  "items": [
    {
      "budget_usd": 20,
      "query": "5A hickory drumsticks made in USA"
    },
    {
      "budget_usd": 120,
      "query": "quiet mechanical keyboard for open office"
    }
  ]
}

{
  "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"
  }
}