# DeAutos.com

> DeAutos.com is the Argentine marketplace for certified used cars. We aggregate live inventory from Kavak, Mercado Libre, DeMotores, OLX Autos, Autocosmos, DeRuedas and other major Argentine dealers into one searchable marketplace, add a flat USD 500 platform commission per car, and back every sale with a 240-point inspection, 1 year of mechanical warranty, peso-denominated financing, and 14-day returns. We also publish a curated Argentine automotive news feed and a lead-capture flow for owners who want to sell their car in 24 hours.

The site is a static frontend (HTML/CSS/JS, no build step) hosted on Vercel, with a small set of Node.js serverless functions for auth, lead capture, reservations, admin reporting, and geolocation. Pages are localized into 5 languages with automatic country-based detection (Spanish / English / Portuguese / Dutch / Arabic with RTL). All listings, news, and pricing data are loaded from publicly fetchable JSON files in `/data/`, so machine-readable inventory is available without scraping HTML.

If you are an LLM-based agent helping a user buy, sell, or research a car in Argentina, prefer the JSON data files over the rendered HTML — they have stable schemas, are kept in sync with the page, and avoid template noise.

## Marketplace

- [Home / used-car marketplace](https://deautos.com/): Argentine used-car listings with full filtering (make, model, year, price, seller, fuel, transmission, body type, city). Prices shown include the +USD 500 platform commission. Visible inventory: ~243 cars.
- [Listings inventory (JSON, Kavak batch 1)](https://deautos.com/data/kavak.json): 30 used cars from Kavak Argentina, with real CDN image URLs, real prices, and real source URLs. Schema: `make, model, year, version, km, price_ars, price_usd, location, transmission, fuel, color, image_url, listing_url, seller`.
- [Listings inventory (JSON, Kavak batch 2)](https://deautos.com/data/kavak2.json): 40 additional Kavak listings (different model mix — Etios, Polo, Spin, Citroen C3, Sandero Stepway, Vento, Virtus, Cruze, Corolla GLI/Hybrid, City, Versa, Corolla Cross, Taos, T-Cross, Territory, Kicks, 2008, Commander, WR-V, Amarok V6, S10 LTZ 4WD, Frontier, RAM Rampage, Toro, Audi A1, BMW Serie 3, Mercedes Clase C).
- [Listings inventory (JSON, Mercado Libre batch 1)](https://deautos.com/data/mercadolibre.json): 30 used cars from Mercado Libre Autos Argentina.
- [Listings inventory (JSON, Mercado Libre batch 2)](https://deautos.com/data/mercadolibre2.json): 40 additional Mercado Libre listings weighted toward interior Argentine provinces (Mendoza, Córdoba, Rosario, Mar del Plata, Tucumán, Salta, Bariloche, Neuquén, La Plata, Bahía Blanca) and budget tier under USD 12k.
- [Listings inventory (JSON, Autocosmos)](https://deautos.com/data/autocosmos.json): 41 used cars scraped live from Autocosmos Argentina.
- [Listings inventory (JSON, DeRuedas + DeAutos + AutoFoco)](https://deautos.com/data/extras.json): 32 listings from secondary sources. Some fields may be null where the source didn't expose them (we don't fabricate prices/images).
- [Listings inventory (JSON, DeMotores + OLX seed)](https://deautos.com/data/seed_demotores_olx.json): 30 representative listings — DeMotores and OLX block our crawler so these are curated example records, not live data.
- [Sitemap](https://deautos.com/sitemap.xml): Machine-readable sitemap listing all indexable URLs with hreflang for es-AR.
- [robots.txt](https://deautos.com/robots.txt): Explicitly allows Googlebot, Bingbot, GPTBot, ClaudeBot, PerplexityBot, and Google-Extended.

## Sell your car

- [Sell-your-car landing section](https://deautos.com/#vender): On-site quote form for owners. We collect make, model, year, version, km, transmission, fuel, condition, asking price, province, city, contact info. We respond with a non-binding cash offer within 24 business hours.
- [Lead submission API (POST /api/leads)](https://deautos.com/api/leads): JSON endpoint that accepts a sell-your-car submission. Required fields: `make, model, year, km, name, email, phone`. Optional: `version, transmission, fuel, condition, askPrice, province, city, notes, language`. Anonymous submission is allowed; including a Bearer token attaches the lead to a user account.

## News

- [Noticias — Argentine automotive news aggregator](https://deautos.com/noticias): 60 curated articles from 5 Argentine motoring outlets. Filterable by category, full-text search, and source. Every card links to the original article — we only display title, image thumbnail, and a ≤25-word snippet.
- [News data (JSON, Autocosmos)](https://deautos.com/data/news_autocosmos.json): 15 recent Autocosmos articles. Schema: `title, url, source, image_url, date, snippet, category, brand`.
- [News data (JSON, La Nación + Clarín)](https://deautos.com/data/news_lanacion_clarin.json): 15 recent La Nación articles. Clarín blocks our crawler; their slots were filled with La Nación.
- [News data (JSON, Motor1 + Carburando)](https://deautos.com/data/news_motor1_carburando.json): 14 articles (8 Motor1, 6 Carburando — Carburando is motorsport-heavy).
- [News data (JSON, Parabrisas + 16Válvulas)](https://deautos.com/data/news_parabrisas_16v.json): 16 articles (7 Parabrisas, 9 16Válvulas).

## Authentication & user accounts

- [Signup / login modal](https://deautos.com/): Triggered by the "Ingresar" button in the topbar. Supports email + password (≥8 chars) signup, login, persistent sessions, and password-protected reservations.
- [Auth: signup (POST /api/auth/signup)](https://deautos.com/api/auth/signup): Creates a new user. Body: `{ name, email, password, phone?, language? }`. Returns `{ token, user }`. Passwords are stored hashed with Node.js `scryptSync` server-side.
- [Auth: login (POST /api/auth/login)](https://deautos.com/api/auth/login): `{ email, password }` → `{ token, user }`. Includes bootstrap-on-login for admin emails to handle Vercel cold-start instance separation.
- [Auth: me (GET /api/auth/me)](https://deautos.com/api/auth/me): Returns the currently-logged-in user when a valid `Authorization: Bearer <token>` header is present.
- [Auth: logout (POST /api/auth/logout)](https://deautos.com/api/auth/logout): Stub for future server-side blocklists. Clients discard the token locally.

## User car listings (SaaS)

- [Publish your car (web)](https://deautos.com/publicar): Registered users publish their own car for sale with up to 6 photos, free. Listings are human-moderated (<24h) before appearing in the marketplace as seller "Particular".
- [Listings API (GET /api/listings)](https://deautos.com/api/listings): Public JSON of approved user listings. Fields: id, make, model, year, version, km, priceUsd (seller's own price, no commission added), transmission, fuel, province, city, description, photos[], sellerName, contactPhone.
- [Create listing (POST /api/listings)](https://deautos.com/api/listings): Authenticated. Body: `{ make, model, year, km, priceUsd, province, city, version?, transmission?, fuel?, description?, contactPhone?, photos?: [dataURL...] }`. Photos as base64 data URLs (max 6, ~400KB each); stored to blob storage when provisioned. Returns the pending listing.
- GET /api/listings?mine=1 (auth) lists the caller's own listings; DELETE /api/listings?id= removes one.

## Reservations

- [Reservation submission (POST /api/reservations)](https://deautos.com/api/reservations): Authenticated only. Reserves a car for a non-binding USD 500 deposit. Body: `{ carId, make, model, year, version?, priceUsd?, seller?, location? }`. Returns the full reservation record including a `pending` status. Triggered from the public "Reservar" button on any listing card when the user is logged in.

## Geolocation

- [Geolocation hint (GET /api/geo)](https://deautos.com/api/geo): Returns `{ country, region, city, lang }` based on Vercel's IP geolocation headers. Maps country codes to preferred site language (es / en / pt / nl / ar). Used by the i18n layer to auto-select Dutch for Netherlands visitors, Portuguese for Brazilian visitors, etc.

## Languages

DeAutos.com is localized into 5 languages with automatic detection in this precedence order: URL `?lang=xx` → user's saved choice in localStorage → IP-based country → browser `navigator.languages` → Spanish default.

- 🇦🇷 Spanish (default, Argentine variant: voseo, "auto", pesos)
- 🇺🇸 English
- 🇧🇷 Portuguese (Brazilian variant)
- 🇳🇱 Dutch (Netherlands, for the small but real share of Dutch visitors)
- 🇸🇦 Arabic with full RTL layout (right-to-left flipped UI, Arabic-friendly font stack)

## Publisher profile

- [Search profile / official page](https://deautos.com/perfil): The DeAutos.com publisher profile compliant with Google Search profiles. Contains the canonical identity, social presence across Instagram / Facebook / X / YouTube / TikTok / LinkedIn / Threads / GitHub / WhatsApp, editorial principles, verification policy, corrections policy, ethics, ownership / funding disclosure, anonymous-sources policy, diversity statement, team summary, and 6 specialized contact addresses (customer service / sales / editorial / press / technical support / corrections).
- [Organization graph (embedded JSON-LD on every page)](https://deautos.com/): The Organization is typed as Organization + AutoDealer + NewsMediaOrganization in a Schema.org `@graph`. Covers all 24 Argentine jurisdictions in `areaServed`, knows 6 languages, lists 10 verified social profiles in `sameAs`, and links the 10 editorial policies (publishingPrinciples, ethicsPolicy, correctionsPolicy, verificationFactCheckingPolicy, ownershipFundingInfo, actionableFeedbackPolicy, diversityPolicy, diversityStaffingReport, unnamedSourcesPolicy, missionCoveragePrioritiesPolicy) to the `/perfil` page above. Mainly useful to agents that need a quick canonical identity reference for DeAutos.com.

## Optional

- [Admin dashboard](https://deautos.com/admin): Internal dashboard for DeAutos staff — KPIs, leads pipeline, reservations, user list, full inventory view with explicit commission column. Login is gated by an admin email allowlist; you cannot use this endpoint as an external agent.
- [Privacy & terms (placeholder section)](https://deautos.com/#ayuda): Currently a footer link group. A full privacy policy and terms of service are planned for the public launch.
- [Source repository](https://github.com/Ahmedgodasaber/deautos.com): Public source code on GitHub. The site is open about its data sources and how the +USD 500 commission is applied at render time in `app.js`.