mercadodecavalos.com.br APImercadodecavalos.com.br ↗
Access horse listings, stallion coverings, embryos, featured animals, seller contacts, and news from Mercado de Cavalos via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/e7c3184a-65f6-46b6-be86-6d5c467d2bd1/search_horses_for_sale?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for horses for sale with various filters and pagination. Returns a list of horse listings. The breed and coat_color filters use numeric IDs from the site's internal catalog. The state filter is currently broken upstream (returns HTTP 500) and should not be used.
| Param | Type | Description |
|---|---|---|
| male | string | Filter for males only. Set to '1' to include. |
| page | string | Page number for pagination. |
| breed | string | Breed filter as numeric ID from site catalog. Known IDs: 6=Appaloosa, 7=Árabe, 9=Crioulo, 10=Quarto de Milha, 11=Paint Horse, 12=Lusitano, 16=Mangalarga Marchador, 17=Mangalarga, 21=Campolina, 24=Sem Raça Definida. |
| state | string | Brazilian state abbreviation filter (e.g. BA, MG, SP, RJ, PR, RS, GO, MT, DF, PE). Note: this filter currently causes upstream HTTP 500 errors on the site and may not work. |
| female | string | Filter for females only. Set to '1' to include. |
| max_age | string | Maximum age filter as integer string (e.g. '10' for 10 years, '0' for up to 30 years). |
| min_age | string | Minimum age filter as integer string (e.g. '2' for 2 years, '0' for newborn). |
| max_price | string | Maximum price filter as decimal string (e.g. '50000.00'). |
| min_price | string | Minimum price filter as decimal string (e.g. '5000.00'). |
| coat_color | string | Coat color filter as numeric ID from site catalog (e.g. '1'=Alazã, '0'=all). |
| homozygous | string | Filter for homozygous horses. Set to '1' to include. |
| registered | string | Filter for registered horses. Set to '1' to include. |
| sort_order | string | Sort order: '1'=newest first, '2'=oldest first, '3'=lowest price, '4'=highest price. |
| with_video | string | Filter for listings with video. Set to '1' to include. |
{
"type": "object",
"fields": {
"data": "array of horse listing objects",
"status": "string indicating success"
},
"sample": {
"data": [
{
"age": "7 ano(s)",
"url": "https://mercadodecavalos.com.br/31741/unico-let-dash",
"name": "Único let dash",
"breed": "Quarto de Milha",
"price": "R$ 25.000,00",
"gender": "Macho"
}
],
"status": "success"
}
}About the mercadodecavalos.com.br API
This API exposes 8 endpoints covering Brazil's primary horse trading marketplace, mercadodecavalos.com.br. You can search active for-sale listings by breed, price, age, and sex using search_horses_for_sale, retrieve full listing profiles via get_horse_details — including pedigree, photos, and seller location — and fetch seller phone and WhatsApp numbers through get_contact_info. Stallion coverings, embryo offerings, and editorial news articles are also accessible.
Horse Listing Search and Detail
search_horses_for_sale accepts filters for male, female, min_age, max_age, max_price, breed (numeric catalog ID — e.g. 9 for Crioulo, 10 for Quarto de Milha), and page. Note that the state filter is currently broken upstream and returns an HTTP 500 error; do not pass it. Each result object in the data array links to a listing via a ref_id and slug pair. Pass both to get_horse_details to retrieve the full record: name, price, seller, location, description, pedigree/lineage, and photos array.
Breeding and Genetic Listings
list_stallions_and_coverings returns paginated stallion records for breeders seeking coverage options. list_embryos_and_mares covers embryo and mare offerings; this endpoint may return an empty array when no listings are currently active on the source site, so callers should handle zero-result responses gracefully. Both endpoints accept a page parameter.
Featured Animals, Contact Info, and News
get_featured_animals returns the homepage spotlight animals — useful for tracking promoted listings over time. get_contact_info takes a ref_id from any listing and returns a contacts array containing the seller's phone and WhatsApp numbers. The list_news_articles endpoint paginates the site's editorial section ('Fique por Dentro'), returning article title, date, and url per item. Full article body, title, date, and URL are available via get_news_article using the ref_id and slug extracted from a news article URL.
- Build a price-tracking dashboard for Quarto de Milha and Crioulo horses using breed IDs in
search_horses_for_sale. - Aggregate seller contact details across multiple listings with
get_contact_infoto build a breeder directory. - Monitor homepage featured animals via
get_featured_animalsto detect listing promotion patterns. - Compile pedigree and lineage data from
get_horse_detailsfor bloodline research tools. - Track stallion availability for breeding season planning using
list_stallions_and_coverings. - Ingest news content from
list_news_articlesandget_news_articleinto a Brazilian equestrian industry feed. - Compare listing prices by age bracket using
min_age,max_age, andmax_pricefilters in bulk search jobs.
| 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 Mercado de Cavalos offer an official developer API?+
How does the breed filter work in `search_horses_for_sale`?+
breed parameter accepts a numeric ID from the site's internal catalog. Documented values include 6 (Appaloosa), 7 (Árabe), 9 (Crioulo), and 10 (Quarto de Milha). Other breeds likely have IDs but are not currently enumerated in the endpoint spec.Can I filter horse listings by Brazilian state?+
state parameter is documented (e.g. 'SP', 'MG', 'RS') but is currently broken upstream — passing it causes an HTTP 500 error from the source. Omit it from requests. Regional filtering is not reliably available at this time. You can fork the API on Parse and revise it to re-enable the state filter once the upstream issue is resolved.Does the API cover auction listings or sold/expired horses?+
What data does `get_horse_details` return beyond the search listing summary?+
search_horses_for_sale result objects.