list.am APIlist.am ↗
Access List.am vehicle, parts, and accessories listings via API. Search, filter by brand/model/year/price, get full listing details, and retrieve seller contacts.
curl -X GET 'https://api.parse.bot/scraper/2f767f08-e4c0-4261-8441-79aab74876c4/get_category_listings?page=1&category_id=687' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch paginated listings from a specific category. Returns listing summaries including title, price, location, and thumbnail image URL.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| query | string | Optional search query to filter results within the category. |
| category_idrequired | string | Category ID (e.g. 687 for Passenger Cars, 530 for Car Parts, 238 for Wheels and Tires) |
{
"type": "object",
"fields": {
"page": "string, the current page number",
"listings": "array of listing summary objects with id, url, title, price, location, and thumbnail",
"category_id": "string, the requested category ID"
},
"sample": {
"data": {
"page": "1",
"listings": [
{
"id": "23690269",
"url": "https://www.list.am/en/item/23690269?ld_src=2",
"price": "$9,900",
"title": "2019 Kia Forte, 2.0L",
"location": "Artashat, 2019 y., 89,000 km, Gasoline",
"thumbnail": "https://s.list.am/g/303/97294303.webp"
}
],
"category_id": "687"
},
"status": "success"
}
}About the list.am API
The List.am API provides 6 endpoints for querying the Armenian List.am marketplace, covering passenger car listings, auto parts, wheels and tires, and other vehicle categories. get_listing_detail returns up to a dozen structured fields per listing including attributes, images, seller name, and posted date, while get_car_listings_filtered lets you narrow passenger car results by brand, model, year range, price range, and currency.
Category and Search Access
Use get_vehicles_categories to retrieve the full category tree with IDs and nested children — no hard-coding required. Pass any category ID into get_category_listings to get paginated listing summaries, each containing id, url, title, price, location, and a thumbnail image URL. For example, category 687 targets Passenger Cars, 530 targets Car Parts, and 238 targets Wheels and Tires. The optional query parameter on get_category_listings filters results within a category without leaving it.
Search and Filtered Browsing
search_listings accepts a required query keyword and an optional category_id to scope results, returning the same listing summary shape with a page and the echoed query field. For passenger cars specifically, get_car_listings_filtered adds structured filters: brand_id (e.g. 49 for Mercedes-Benz), model_id, year_from, year_to, price_from, price_to, and currency (0 for AMD, 1 for USD). The filters array in the response reflects which parameters were applied.
Listing Detail and Seller Contact
get_listing_detail accepts either an item_id or a full url and returns the complete record: title, price, currency, location, description, posted_date, seller_name, a full images array, and an attributes object mapping labels such as Make, Model, Year, and Engine Type to their values. To retrieve a seller's phone number, pass the item_id to get_phone_number, which returns the phone string for that listing.
- Monitor price trends for a specific car make and model by polling
get_car_listings_filteredwithbrand_idandmodel_idover time. - Build a cross-listing alert tool that watches
get_category_listingsfor new entries in the Car Parts category (ID 530). - Aggregate seller contact data by combining
get_listing_detailforseller_namewithget_phone_numberfor outreach pipelines. - Populate a vehicle comparison tool using
attributesfields (Make, Model, Year, Engine Type) returned byget_listing_detail. - Sync a local inventory database with current List.am passenger car listings using paginated
get_car_listings_filteredrequests. - Build a currency-aware price dashboard by filtering listings with
currencyset to AMD or USD and tracking thepricefield. - Index List.am listing images for a visual search tool using the
imagesarray fromget_listing_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does List.am have an official developer API?+
What does `get_car_listings_filtered` return compared to `get_category_listings`?+
get_category_listings returns paginated summaries for any category ID you pass in, with no structured filtering beyond an optional text query. get_car_listings_filtered is scoped to the Passenger Cars category and adds typed filter parameters — brand_id, model_id, year_from, year_to, price_from, price_to, and currency. Its response also includes a filters array showing which parameters were applied. Both return the same listing summary shape: id, url, title, price, location, and thumbnail.Are motorcycles, trucks, or boats covered by the filtering endpoint?+
get_car_listings_filtered is scoped to the Passenger Cars category only. You can reach other vehicle types via get_category_listings using their category IDs from get_vehicles_categories, but without the structured brand/model/year filters. You can fork this API on Parse and revise it to add a filtered endpoint for motorcycles or other vehicle types.Does the API return listing creation or expiry dates?+
get_listing_detail returns a posted_date field for individual listings. Listing summaries returned by get_category_listings, search_listings, and get_car_listings_filtered do not include dates — only id, url, title, price, location, and thumbnail. If you need date filtering on summary results, you can fork this API on Parse and revise to add that field to the summary response.Is there a known limitation with phone number retrieval?+
get_phone_number endpoint requires Cloudflare clearance to resolve successfully. Requests may fail or return incomplete data in environments where that clearance cannot be established. Other endpoints do not have this restriction.