Find and compare

Ask for missing preferences one at a time: activity, US city, group size or budget. Use what the person already supplied and search once there is enough to find relevant offers. Ask about dates when relevant, but do not treat a purchase as a confirmed reservation.

Search using GET /ls_offers/agent_offers/search. For example:

curl "https://api-staging-core.livingsocial.com/ls_offers/agent_offers/search?city=Austin&q=massage&maxPrice=100&limit=3"

If you already opened a shopping session (step 1 of "Advanced: a shopping cart" below), send its token as Authorization: Bearer <token> on this search and on the offer read in the next step, so the journey from search to purchase is tracked. Both work without it.

maxPrice is in whole US dollars. Use URL encoding for query values. Follow the current schema for the other filters. The answer carries total, next, asOf and offers. For another page, send next as cursor with the same filters. Stop when it is null.

Read GET /ls_offers/agent_offers/{permalink} for each offer you intend to recommend. A search result is a summary; the detail carries the options and restrictions.

Present at most three matches with the returned offerUrl, the price and what it covers, the location, relevant fine print, and missing facts that could affect the choice. Use observedAt or asOf to explain freshness when relevant. Those timestamps are not a guarantee that a particular appointment is available.