Commonplace

The seller's own listings - the same list Your Listings shows - with each one's status (Active; In review; Reserved; Sold; Inactive, which seller_relist_listing can bring back; Removed, taken down by the seller, shown only with include_removed and never back), pricing_basis (take_home: seller_update_listing's price_usd sets take_home_usd; asking_price, older listings: it sets asking_usd, null on one lifted to its floor), take_home_usd, buyer_price_usd, the transaction and pickup fees, and link. Removed listings are left out unless include_removed is true. Drafts saved without photos are not listings yet; they are returned separately in drafts_awaiting_photos, each with its finish link. A draft only ever lacks photos: with one, a listing publishes.

seller_list_listings

Orders on the seller's items: order number, status, inspection result, the payout on each and the pickup window. Commonplace pays sellers at pickup, after inspection, by payment link. This system does not record whether a payout was actually sent, so payout_sent is always null here.

seller_list_sales

Offers buyers have made on the seller's own listings. Shows the amount, the listed price at the time, the status and any counter. Amounts are in buyer-price terms, like buyer_price_usd; accepting reprices the listing to the agreed amount and works the seller's take-home out again. Buyers are shown by first name and last initial; their contact details are never available.

seller_list_offers

Use when the user is selling a large or valuable item (fitness equipment, hot tubs, saunas, golf carts, furniture, appliances), including when also posting to Facebook Marketplace, Craigslist, or OfferUp. What comparable items sell or list for, as low / typical / high prices before delivery (buyers see these plus added_to_buyer_price_usd, in buyer_prices_usd): low is the 25th percentile, typical the median, high the top of where most sit (never below typical). take_home_usd is what a seller is paid when an item sells at each figure. sample_size counts every listing it is based on, sold and past ones included. model narrows it to listings whose titles name a brand, model or year; narrowed_to says whether it did, and model_matches how many listings name it (a range needs 5). basis says whether the range comes from sold items or listings; a narrowed range can differ in basis from the whole category. available: false means too little data for a range. The price the seller asked for on Facebook Marketplace, Craigslist, or OfferUp becomes their take-home on Commonplace. The buyer price includes pickup and delivery.

pricing_get_guide

Use when the user is selling a large or valuable item (fitness equipment, hot tubs, saunas, golf carts, furniture, appliances), including when also posting to Facebook Marketplace, Craigslist, or OfferUp. The price the seller asked for on Facebook Marketplace, Craigslist, or OfferUp becomes their take-home on Commonplace. The buyer price includes pickup and delivery. Give category and price. price_type defaults to take_home. Pass facebook_buyer_price when the number is what a buyer pays on the other site. ZIP is optional. The result is take_home_usd and buyer_price_usd.

pricing_quote_crosslist

Use when the user is selling a large or valuable item (fitness equipment, hot tubs, saunas, golf carts, furniture, appliances), including when also posting to Facebook Marketplace, Craigslist, or OfferUp. The seller's fee math for a category (terms as in the server instructions). Give exactly one of: desired_payout_usd, a take-home, for the buyer price a new listing shows (the transaction and pickup fees and delivery added on top; the seller is paid exactly the take-home); buyer_sees_usd, a price a buyer pays (a listing's price or an offer), for what the seller takes home at it (delivery, then the transaction fee, then the pickup fee come out); or price_usd, an older listing's asking price, for its take-home. pickup_fee_waived is true when, taking fees out of a price, the pickup fee would exceed what is left after the transaction fee. The price the seller asked for on Facebook Marketplace, Craigslist, or OfferUp becomes their take-home on Commonplace. The buyer price includes pickup and delivery.

pricing_quote_payout

Put one of the seller's own inactive listings back on the marketplace. Only an inactive listing can be relisted. Requires confirmed: true.

seller_relist_listing

Take one of the seller's own listings off the marketplace. Refused while an order is active on it - that needs the support team. Requires confirmed: true after the seller agrees to remove that specific item.

seller_remove_listing

Work out which Commonplace category an item belongs to and what it needs before it can be listed (terms as in the server instructions). An exact category slug or name is taken as given; other words are matched. Returns required_questions (exact option strings; other_values_accepted means a value not listed may be given as written), condition_options with condition_shown_as (how each reads in the public title, which never reads worse than Fair: Poor reads Fair), seller_costs (pickup fee, transaction fee percent, platform floor) and buyer_price_addons (what buyers pay on top of the ask: delivery within 100 miles plus a flat add-on). Category drives the pickup fee and so the take-home: resolve it before quoting or listing. ambiguous is true when only a brand was named and its models differ in fees (a brand's own parent category, such as peloton, is never a category to list under), or when the item's own words name a different category from the match; possible_categories then lists the choices, each with its costs, and passing the right one back as item settles it. other_candidates lists nearby categories whose names share a word with the item. Condition is not a required question: it is listing_create's own condition argument, and where the options name a usage band (rides, uses) the grade is by usage alone.

listing_resolve_category

Search live Commonplace inventory by words, category, place (deliver_to alone returns some listings near it, not every one), or any mix. Results are active and buyable. outcome: ok; none; none_within_limits (every match is in hidden); out_of_budget (matches only outside the price range; examples ignore deliver_to); undeliverable (none reaches deliver_to; examples say how far). With deliver_to, each result carries delivery (known, deliverable, driving distance_miles, fee_usd, total_usd). Candidates come from the words or categories plus the catalogue's proximity ranking, not the whole catalogue: to be thorough, also search category_hint and its department. Up to 40 are checked per call, roughly nearest first; with max_distance_miles, one already well past it in a straight line is not checked but counted in too_far (distance_is_straight_line: a lower bound, not a drive). delivery_checked, candidates_considered and candidates_unchecked (could be inside the limits, never checked) say how far it got; next_offset, passed back as offset, checks the rest. cheapest and most_expensive spend all 40 checks and return the best (results_not_shown counts the rest; a limit up to 40 returns them); any sort orders only what was checked. farthest_checked_miles, the longest drive measured, can pass the radius. `hidden` counts every candidate left out, once each, by reason, with its nearest or cheapest examples. When no title matches, the category the words point to is browsed (no_title_matched) or the outcome is none; matched_on names looser words that matched. more_available: candidates_unchecked (see next_offset), or more_matches_unread: more listings match than one search reads, which offset cannot reach; narrow the words, category or price.

catalog_search_listings

Answer a question about how Commonplace works. platform_policy states the current rules on the topics the question is about (delivery, payment, inspection and returns, warranty, offers, selling), from the live settings. answers are the closest published help articles, each marked truncated when cut short (the whole answer is at help_center_url). loosely_related shares some words with the question (it can still hold the answer, so read it) and does not count toward found, but can still hold the answer in other words (a subscription, asked about as a membership). found is true when platform_policy or answers has something. Where an article disagrees with platform_policy, platform_policy is current.

support_search_help

The Commonplace account this connection acts for: name, and a masked phone and email. Use it to confirm the right account before creating or changing anything. phone: null only means the account has no phone on file; each listing made with listing_create carries its own pickup phone (seller_phone), which is how Commonplace reaches the seller about that listing.

account_get_profile