Skip to content

Mercari API: Search listings

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.

mercari.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Mercari.

Inputs

Values from the run on Oct 31, 2026, shown under Output.

Sort optionalsort

Results order, such as newest.

price_low_to_high

One of best_match, newest, price_low_to_high, price_high_to_low. Default best_match.

Query, requiredquery

Words to search for, such as Nintendo Switch OLED.

Coach purse

Condition optionalcondition

Item condition, such as good.

good

One of any, new, like_new, good, fair, poor. Default any.

Max Price optionalmax_price

Highest item price in USD, such as 200.

200

Number 0 or more.

Min Price optionalmin_price

Lowest item price in USD, such as 50.

20

Number 0 or more.

Sold Only optionalsold_only

Show only sold listings, such as true.

true

True or false. Default false.

Max Results optionalmax_results

Maximum listings to return, such as 30 (up to 120).

6

Whole number from 1 to 120. Default 30.

Output

From a run on Oct 31, 2026, shortened for this page.
{  "listings": [    {      "size": null,      "sold": true,      "brand": "Coach",      "price": 20,      "title": "Coach multi colored purse",      "item_id": "m87446295908",      "currency": "USD",      "condition": "Good",      "image_link": "https://u-mercari-images.mercdn.net/photos/m87446295908_1.jpg?1740096780",      "seller_name": "Lupita's Chancla",      "listing_link": "https://www.mercari.com/us/item/m87446295908/",      "free_shipping": false,      "seller_rating": 5    },    {      "size": null,      "sold": true,      "brand": "Coach",      "price": 20,      "title": "Coach Leather purse",      "item_id": "m85070668676",      "currency": "USD",      "condition": "Good",      "image_link": "https://u-mercari-images.mercdn.net/photos/m85070668676_1.jpg?1740096939",      "seller_name": "Lupita's Chancla",      "listing_link": "https://www.mercari.com/us/item/m85070668676/",      "free_shipping": false,      "seller_rating": 5    },    {      "size": null,      "sold": true,      "brand": "Coach",      "price": 20,      "title": "Coach grey purse",      "item_id": "m29393594445",      "currency": "USD",      "condition": "Good",      "image_link": "https://u-mercari-images.mercdn.net/photos/m29393594445_1.jpg?1740096082",      "seller_name": "Lupita's Chancla",      "listing_link": "https://www.mercari.com/us/item/m29393594445/",      "free_shipping": false,      "seller_rating": 5    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
mercari.com/search_listings
Returns
title, price, condition, brand, size, sold, seller name and rating, free shipping, image, link, item id

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method mercari.com/search_listings with the inputs above.

Ask your agent

  • Find sold Mercari listings for Lululemon Align leggings so I can see what they actually went for
  • What are the cheapest like-new AirPods Pro 2 for sale right now under $150? Sort lowest price first.
  • Show me the newest listings for vintage Pyrex bowls between $20 and $80, include seller ratings and whether shipping is free
  • On mercari.com, pull up to 60 sold Pokemon Charizard cards in good condition, highest price first
  • I'm looking for a used Canon AE-1 film camera, any condition, max $250. List title, price, seller and link.

See more

  • 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.

    offerup.com/search_listings
  • Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price.

    macys.com/search_products
  • Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.

    aliexpress.com/search_products
  • Searches public Vinted listings in one country with brand, size, condition, price and sorting filters. Returns up to 96 available items with seller usernames when the public profile is available.

    vinted.com/search_listings
  • Searches Rakuten Ichiba products by keyword, price range, free shipping and sort order. Returns up to 45 regular listings in the order shown; sponsored placements are excluded. Prices are listed starting prices when an item has variants.

    rakuten.co.jp/search_products
  • Search Nordstrom products by words, price, sale status and sort order. Prices are the lowest listed price. Available sizes may be empty when a product page is unavailable.

    nordstrom.com/search_products
  • Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.

    bestbuy.com/search_products
  • 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.

    carmax.com/search_cars