List APIlist.am ↗
Access List.am vehicle listings, parts, and accessories data via 6 endpoints. Filter by brand, model, year, price, and category across the Armenian marketplace.
What is the List API?
The List.am API exposes 6 endpoints for browsing and searching vehicle and parts listings on Armenia's List.am marketplace. get_listing_detail returns over a dozen typed vehicle fields including make, model, year, engine type, horsepower, transmission, drive type, mileage, VIN, color, and seller contact information. get_car_listings_filtered lets you narrow results by brand, model, year range, price range, and currency, while crawl_car_listings covers all five leaf car categories in a single call.
curl -X GET 'https://api.parse.bot/scraper/2f767f08-e4c0-4261-8441-79aab74876c4/get_category_listings?page=1&query=Toyota&category_id=687' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch one page of listing summaries (about 100 per page plus a rotating block of promoted 'top' ads flagged is_promoted=true, one page fetch per call) from a category, optionally filtered by a search query within that category. Summaries carry the listing ID, source URL, title, price, geographic location, the card's specs line parsed into year, mileage (with km/miles unit), horsepower and transmission where the card shows them, badges, thumbnail, and the date label the site shows for the ad resolved to an ISO date (null for promoted ads). Omitting page returns page 1; has_more says whether a next page exists.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Optional search query to filter results within the category. |
| category_idrequired | string | Category ID (e.g. 687 for all cars, 1472 for cars with mileage, 530 for Car Parts, 238 for Rims and Hub Caps). |
{
"type": "object",
"fields": {
"page": "string, the current page number",
"has_more": "boolean, whether the site offers a next page",
"listings": "array of listing summary objects with id, url, is_promoted, title, price, location, category_path, summary, year, mileage, horsepower, transmission, listed_date_label, listed_date, badges, thumbnail (same shape as get_car_listings_filtered.listings)",
"category_id": "string, the requested category ID"
},
"sample": {
"data": {
"page": "1",
"has_more": true,
"listings": [
{
"id": "24176441",
"url": "https://www.list.am/en/item/24176441?ld_src=2",
"year": 2011,
"price": "$10,200",
"title": "2011 Toyota Corolla, 1.8L, gas",
"badges": [
"VIN provided"
],
"mileage": {
"raw": "156,000 miles",
"unit": "miles",
"value": 156000
},
"summary": "156,000 miles · 133 hp · Automatic",
"location": "Kanaker-Zeytun",
"thumbnail": "https://img.list.am/r/991/101360991.webp",
"horsepower": 133,
"listed_date": "2026-09-25",
"transmission": "Automatic",
"category_path": null,
"listed_date_label": "September 25"
}
],
"category_id": "687"
},
"status": "success"
}
}About the List API
Browsing and Searching Listings
get_category_listings returns up to ~100 listing summaries per page for a given category_id, with promoted ads flagged via is_promoted=true. Use category IDs like 687 (all cars), 1472 (cars with mileage), or 530 (car parts). An optional query parameter filters results within that category. search_listings works similarly but accepts a required query keyword and an optional category_id to scope results; on cross-category searches, each listing summary includes a category_path field so you can identify which section it came from. Both endpoints expose the same summary shape: id, url, title, price, location, year, mileage, horsepower, and summary.
Listing Detail and Filtered Car Search
get_listing_detail accepts either an item_id (as returned in listings[*].id) or a full url, and returns the complete listing record: structured vehicle fields (make, model, year, color, vin, engine_type, engine_size, horsepower, transmission, drive_type, mileage with unit, condition), geographic location split into region, city, and country, badge labels (e.g. Dealer, Urgent, VIN provided), an images array, description text, and seller contact details. get_car_listings_filtered adds server-side filtering by brand_id, model_id, year_from, year_to, price_to, currency (AMD or USD), and sort order. The response includes a total_count integer reflecting the site's ad count for the active filter combination.
Crawling the Full Cars Tree
crawl_car_listings fetches page N across all five leaf car categories simultaneously — Cars with Mileage (1472), New Cars (1473), Salvage Cars for Parts (188), Cars from Auctions (124), and Cars from Abroad (399) — ordered newest-first. Pass a single category_id to restrict the crawl to one leaf. Optional year_from and year_to filters are applied to every crawled category. The response includes a top-level total_count (sum across categories), listings_count (deduplicated by id), and per-category has_more flags so you can track pagination independently for each leaf.
Category Tree
get_vehicles_categories returns the full nested category tree with id, name, and children arrays. The tree covers Cars, Motorcycles, Trucks, Buses, Agricultural, Water Transport, and Car Parts subtrees. Use the IDs from this endpoint as inputs to the other listing and search endpoints.
The List API is a managed, monitored endpoint for list.am — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when list.am changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official list.am API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new car listings across all five List.am leaf categories using
crawl_car_listingswith newest-first ordering. - Build a price comparison tool by filtering
get_car_listings_filteredresults bybrand_id,model_id, andcurrencyacross AMD and USD. - Track average asking prices for specific makes and models using
total_countandpricefields from filtered searches. - Aggregate car parts availability by scraping
get_category_listingsfor category 530 (Car Parts) and 238 (Rims and Hub Caps). - Enrich a vehicle database with VIN, engine specs, and transmission data from
get_listing_detailfor listings flagged with the VIN provided badge. - Detect dealer vs. private-seller listings by reading the
badgesarray fromget_listing_detailfor the Dealer label. - Build a year-range inventory dashboard using
year_fromandyear_tofilters oncrawl_car_listingscombined withtotal_countaggregation.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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_listing_detail` return beyond what the summary endpoints provide?+
get_listing_detail returns the full listing record: typed vehicle fields (make, model, year, color, vin, engine_type, engine_size, horsepower, transmission, drive_type, mileage with unit, condition), geographic location split into region, city, and country, badge labels, an images array, a description text field, and seller contact information. Summary endpoints (like get_category_listings) return only id, url, title, price, location, year, mileage, horsepower, and summary.How does pagination work, and is there a way to get a total listing count?+
has_more boolean to indicate whether a next page exists. get_car_listings_filtered and crawl_car_listings additionally return a total_count integer reflecting the site's count for the active filters. crawl_car_listings returns has_more both at the top level (true if any category has more pages) and per-category, so you can paginate each leaf category independently.Does the API cover non-vehicle categories on List.am, such as real estate or electronics?+
Can I filter car listings by transmission type or engine size through the API?+
get_car_listings_filtered supports filtering by brand_id, model_id, year_from, year_to, price_to, and currency. Those vehicle attributes are returned in the detail response from get_listing_detail, but cannot be used as query filters. You can fork this API on Parse and revise it to add those filter parameters if the source supports them.