- Markets: physical goods delivered in the US (USD) or Israel (ILS). Not services, digital goods or anything needed within days.
- What fits: a specific, comparable item that can wait days to weeks, about $50 to $100 or more, shipped within the buyer’s country.
- Belongs to: the buyer. Your agent acts only within the permissions they granted, and they can revoke them in their account.
- Pooling: Popular Demand counts compatible Requests together, so sellers see how many people want the same thing. Each person or family saves their own Request; there are no groups to join.
Life of a Request
- Your agent saves it with
save_requestafter the buyer’s yes, or the buyer saves it on the website. - Your agent adds what sellers need: a quantity and the models the buyer would accept. Until then
list_requestsflagsdetails_needed. - Popular Demand may ask questions, including whether the buyer still wants it (
still_want). See Questions. - A seller may make an Offer. See Offers.
- The buyer buys at the seller’s checkout, or the Request is paused or closed. See Closing.
Versions
Every change raises the Request’sversion. Pass expected_version on a change to refuse it if the Request changed since you read it. On a version conflict, read the Request again instead of retrying.
Safe retries
Writes take an optionalrequest_key (MCP) or Idempotency-Key header (REST). Repeat the same key to retry the same command safely.