webmotors.com.br APIwebmotors.com.br ↗
Search Brazilian car listings, get automotive news, and find city-level location data from Webmotors via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/a4251061-6060-452a-8e77-528773754408/get_news?limit=3&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract news articles from the Webmotors news section. Returns a list of articles with titles, full text content, author, publication date, and URL.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of articles to return. |
| offset | integer | Offset for pagination (number of articles to skip). |
{
"type": "object",
"fields": {
"articles": "array of article objects with id, title, text, author, date, url",
"pagination": "object with offset, total_pages, page_size, current_page"
},
"sample": {
"data": {
"articles": [
{
"id": "847671",
"url": "https://www.webmotors.com.br/wm1/noticias/conectores-de-carros-eletricos",
"date": "2026-05-14 11:42:38",
"text": "O universo dos carros elétricos começou...",
"title": "Veja os tipos de conectores para carros elétricos",
"author": "André Deliberato"
}
],
"pagination": {
"offset": 0,
"page_size": 12666,
"total_pages": 4222,
"current_page": 1
}
},
"status": "success"
}
}About the webmotors.com.br API
This API gives programmatic access to Webmotors, Brazil's largest automotive marketplace, across 3 endpoints. search_cars returns vehicle listings filterable by make, model, year range, mileage, price, and geographic coordinates. get_news delivers paginated editorial articles with full text and author metadata. get_locations maps every Brazilian city where listings exist to a latitude/longitude pair and a live car count.
Car Search
search_cars accepts filters including make, model, year_to, km_min, km_max, and a lat/lng pair for proximity sorting. Results come back as an array of car objects carrying id, title, make, model, version, year_fabrication, year_model, price, mileage, location, and transmission. The response also includes a total integer and a page counter for walking through large result sets. Note that promoted/sponsored (zero-km) listings appear alongside regular used-car listings and carry limited metadata compared to full used-car records.
News Articles
get_news returns articles from the Webmotors editorial section. Each article object includes id, title, text (full body content), author, date, and url. The endpoint supports limit and offset parameters for pagination, and the response includes a pagination object with current_page, total_pages, page_size, and offset so you can page through the full article archive.
Locations
get_locations requires no input parameters and returns a flat list of all Brazilian cities represented in Webmotors listings. Each entry includes city, state, abbr (two-letter state code), lat, lng, and count — the number of active listings in that city. This endpoint is the practical companion to search_cars: use it to discover valid lat/lng values before issuing location-filtered car queries.
- Build a Brazilian used-car price tracker using
price,make,model, andyear_modelfields fromsearch_cars. - Generate city-level heatmaps of car inventory density using
lat,lng, andcountfromget_locations. - Feed an automotive news aggregator with full article text, author, and publication date from
get_news. - Filter high-mileage vehicles out of results by setting
km_maxinsearch_carsand monitoringmileagein returned records. - Compare listing volumes across Brazilian states by aggregating the
countandabbrfields fromget_locations. - Alert users when a specific make/model drops below a target price by polling
search_carswithmakeandmodelfilters. - Paginate through the full Webmotors news archive using
offsetandtotal_pagesfromget_newsfor content analysis.
| 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 Webmotors have an official developer API?+
What is the difference between promoted and regular listings returned by search_cars?+
cars array. Regular used-car listings carry the full set of fields including mileage, transmission, version, year_fabrication, and year_model. Promoted/sponsored (zero-km) listings are present but carry limited metadata — some detail fields may be absent or null for those records.Does search_cars support filtering by price range?+
km_min, km_max, year_to, make, model, and lat/lng filters but does not expose a dedicated price-range parameter. You can fork this API on Parse and revise it to add price_min and price_max query filters.Does the API return seller contact details or VIN numbers for listings?+
search_cars response covers listing attributes such as price, mileage, location, transmission, and version, but does not include seller phone numbers, email addresses, or VIN identifiers. You can fork the API on Parse and revise it to add the missing endpoint if individual listing detail pages expose that data.