# OfferUp API: Search listings > Finds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations. Unofficial. Not affiliated with or endorsed by OfferUp. - Page: https://fous.com/methods/offerup.com/search-listings - Method: `offerup.com/search_listings`, version 1 - Website: offerup.com - Returns: title, price, condition, city, state, distance, shipping, seller, image, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"newest"` | Listing order, such as newest. One of "best_match", "newest", "closest", "price_low_to_high", "price_high_to_low". Default "best_match". | | `query` | string | yes | `"table"` | What to search for, such as couch. | | `location` | string | yes | `"Portland, OR"` | US ZIP code or city and state, such as Seattle, WA or 98101. | | `condition` | string | no | | Item condition, such as used. One of "any", "new", "open_box", "reconditioned", "used". Default "any". | | `max_price` | number | no | | Maximum price in USD, such as 500. | | `min_price` | number | no | | Minimum price in USD, such as 100. | | `max_results` | integer | no | `55` | Maximum listings to return, such as 30. Default 30. | | `max_distance_miles` | integer | no | `100` | Maximum distance from the place in miles, such as 20. One of 5, 10, 20, 30, 50, 100. Default 30. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "newest", "query": "table", "location": "Portland, OR", "max_results": 55, "max_distance_miles": 100 } ``` Its output: ```json { "listings": [ { "city": "Aloha", "price": 50, "state": "OR", "title": "White IKEA console", "currency": "USD", "condition": "Used", "image_link": "https://images.offerup.com/iNlIzS9_YiV20lOVMKb3H7RJCQw=/333x250/3181/318164b209264c1a84beac0445affaf9.jpg", "listing_id": "f45fd813-0f41-3505-881c-dc7a4e5813b4", "seller_name": "John & Liz", "listing_link": "https://offerup.com/item/detail/f45fd813-0f41-3505-881c-dc7a4e5813b4", "distance_miles": 9.5, "shipping_available": false }, { "city": "Portland", "price": 550, "state": "OR", "title": "Chiropractic Table", "currency": "USD", "condition": "Used", "image_link": "https://images.offerup.com/7oVi01ezd4ZMBLj2U8hvn_vm2po=/250x333/78b8/78b8536c7b9845b590551fa3d25012f5.jpg", "listing_id": "7b5f2242-8271-3afd-8d2e-5f810ff05210", "seller_name": "Kai Herman", "listing_link": "https://offerup.com/item/detail/7b5f2242-8271-3afd-8d2e-5f810ff05210", "distance_miles": 3.4, "shipping_available": false }, { "city": "Aloha", "price": 50, "state": "OR", "title": "Dining set", "currency": "USD", "condition": "Used", "image_link": "https://images.offerup.com/Ma5uvtMK0mmaIClRE1-IqR9Z26Y=/333x250/9693/96938d4feecc45aabe069fd3a5f97685.jpg", "listing_id": "a2e2c112-1362-313c-8053-e4ec7ea246b6", "seller_name": "John & Liz", "listing_link": "https://offerup.com/item/detail/a2e2c112-1362-313c-8053-e4ec7ea246b6", "distance_miles": 9.5, "shipping_available": false } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"offerup.com/search_listings","input":{"sort":"newest","query":"table","location":"Portland, OR","max_results":55,"max_distance_miles":100}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find used mountain bikes under $300 within 20 miles of Denver, CO, cheapest first - Check OfferUp for a PS5 near ZIP 77002, new or open box only, and show me the seller and distance for each - What sectional couches are for sale near Portland, OR between $150 and $600? Show the newest listings first - Search OfferUp around 30318 for a Weber grill, closest ones within 10 miles - Looking for a reconditioned iPhone 14 near Chicago, IL, max $450, top 15 results with links and whether shipping is available ## Input schema ```json { "type": "object", "required": [ "query", "location" ], "properties": { "sort": { "enum": [ "best_match", "newest", "closest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "best_match", "description": "Listing order, such as newest." }, "query": { "type": "string", "minLength": 1, "description": "What to search for, such as couch." }, "location": { "type": "string", "minLength": 1, "description": "US ZIP code or city and state, such as Seattle, WA or 98101." }, "condition": { "enum": [ "any", "new", "open_box", "reconditioned", "used" ], "type": "string", "default": "any", "description": "Item condition, such as used." }, "max_price": { "type": "number", "minimum": 0, "description": "Maximum price in USD, such as 500." }, "min_price": { "type": "number", "minimum": 0, "description": "Minimum price in USD, such as 100." }, "max_results": { "type": "integer", "default": 30, "maximum": 100, "minimum": 1, "description": "Maximum listings to return, such as 30." }, "max_distance_miles": { "enum": [ 5, 10, 20, 30, 50, 100 ], "type": "integer", "default": 30, "description": "Maximum distance from the place in miles, such as 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "listings" ], "properties": { "listings": { "type": "array", "items": { "type": "object", "required": [ "title", "price", "currency", "condition", "city", "state", "distance_miles", "shipping_available", "seller_name", "image_link", "listing_link", "listing_id" ], "properties": { "city": { "type": [ "string", "null" ] }, "price": { "type": [ "number", "null" ], "description": "Price in USD." }, "state": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "currency": { "type": "string", "description": "Price currency code." }, "condition": { "type": [ "string", "null" ] }, "image_link": { "type": [ "string", "null" ] }, "listing_id": { "type": "string" }, "seller_name": { "type": [ "string", "null" ] }, "listing_link": { "type": "string" }, "distance_miles": { "type": [ "number", "null" ] }, "shipping_available": { "type": "boolean" } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Craigslist API: Search listings](https://fous.com/methods/craigslist.org/search-listings.md): Searches public Craigslist listings in a city or area, newest first. Renewed listings may have older original posting dates. - [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings). - [Mercari API: Search listings](https://fous.com/methods/mercari.com/search-listings.md): Searches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices. - [CarGurus API: Search cars for sale](https://fous.com/methods/cargurus.com/search-cars.md): Searches new and used cars for sale near a US ZIP code for a make and model, with prices, dealer details and CarGurus deal ratings. Used cars come first, then new cars, each in CarGurus order; market difference is positive below market and negative above. - [Cars.com API: Search listings](https://fous.com/methods/cars.com/search-cars.md): Searches Cars.com car listings for a make and model around a US ZIP code within a radius, optionally by condition (new, used or certified pre-owned) and maximum price, in Cars.com search order. - [Autotrader API: Search cars](https://fous.com/methods/autotrader.com/search-cars.md): Searches Autotrader car listings near a US ZIP code by make and model, with condition, price, year and distance filters. Returns up to 100 listings in site order. - [CARFAX API: Search used cars](https://fous.com/methods/carfax.com/search-cars.md): Searches CARFAX used-car listings for a make and model near a US ZIP code, in CARFAX order, with listing details and free vehicle-history highlights. Paid full history reports are not included. - [CarMax API: Search used cars](https://fous.com/methods/carmax.com/search-cars.md): Searches CarMax used cars by make and model with optional ZIP, distance, year, price and mileage filters, keeping CarMax's order. Pages expose only the first 48 cars; distance is CarMax's distance from the selected local store, and larger limits or narrow distance filters may return fewer matches.