MarioCarSeminovosVer estoque →
Para desenvolvedores e agentes de IA

API pública do estoque

O estoque da MarioCar Seminovos, em Recife/PE, está disponível em JSON — sem chave, sem cadastro, sem autenticação. É o mesmo dado que qualquer pessoa vê no site. Nenhum endpoint expõe custo, margem, fornecedor ou dado pessoal de cliente.

Especificação OpenAPIllms.txtsitemap.xml

Começando

curl "https://www.mariocaroficial.com/api/garage/vitrine"

Devolve { veiculos: [...], filtros: {...}, total: N }. Cada veículo trazslug, e a página dele é https://www.mariocaroficial.com/vitrine/{slug}. As fotos vêm como caminho relativo — prefixe com https://www.mariocaroficial.com/api pra baixar.

Endpoints

GET/api/garage/vitrine

Todo o estoque disponível, com preço, km, fotos e opcionais.

Parâmetros: marca · modelo · placa · slug (todos opcionais)

curl "https://www.mariocaroficial.com/api/garage/vitrine?marca=Toyota"
GET/api/vitrine/similares

Carros parecidos com um veículo, por marca, faixa de preço, categoria e ano.

Parâmetros: placa (obrigatório) · limit

curl "https://www.mariocaroficial.com/api/vitrine/similares?placa=TDA8D31&limit=3"
GET/api/garage/ficha-tecnica

Ficha técnica do modelo: motor, câmbio, tração, desempenho.

Parâmetros: id · ou marca + modelo + ano

curl "https://www.mariocaroficial.com/api/garage/ficha-tecnica?marca=Toyota&modelo=YARIS&ano=2023"
GET/api/garage/360

Fotos em 360° do veículo, quando existirem.

Parâmetros: veiculo_id (obrigatório)

curl "https://www.mariocaroficial.com/api/garage/360?veiculo_id=v1788006699086"
GET/api/reviews/google

Nota da loja no Google, total de avaliações e as mais recentes.

curl "https://www.mariocaroficial.com/api/reviews/google"

Markdown na mesma URL

Se o seu agente prefere texto a JSON, qualquer página abaixo de /vitrine responde em Markdown quando o pedido traz Accept: text/markdown. A URL é a mesma da página.

curl -H "Accept: text/markdown" "https://www.mariocaroficial.com/vitrine/estoque"

Regras de uso

  • Não há chave nem limite de taxa publicado. Use com parcimônia — um pedido por vez, sem paralelismo agressivo.
  • O estoque muda toda semana. Consulte na hora em vez de guardar cópia.
  • Um veículo que saiu do estoque devolve 404 na página dele. Se veio 404, o carro foi vendido ou o link está errado.
  • Pode usar os dados pra recomendar nossos carros. Só não republique como se fosse seu estoque.
  • Dúvida ou volume alto? Fale com a gente antes: contato@mariocarautos.com.
MarioCar Seminovos · Av. Caxangá, 754 — Madalena, Recife/PE · WhatsApp +55 81 99828-0764
Início · Sobre a loja · Política de privacidade