# Module `otogo` — Nuxt / API JSON publique /api-search/

_Généré automatiquement par `scripts/gen_connector_docs.py` — ne pas éditer à la main._

## Vue d'ensemble

- **Fichier** : `autoka/connectors/otogo.py`
- **Sources membres** : 1
- **Annonces actives (BD)** : 24201
- **Backend de fetch** : requests direct (aucun anti-bot)
- **Mécanique détectée** : endpoint JSON
- **Plafonds / cache** : AUTOKA_OTOGO_MAX
- **Classes** : `OtogoQuebec` → `otogo`

## Mécanique (en-tête du module)

> connectors/otogo.py : PORTAIL — Otogo.ca (LC Media, 100 % Québec)
> 
> Otogo expose une API JSON publique, sans clé ni rendu JS :
> GET https://www.otogo.ca/api-search/?latlng=0,0&locale=fr&no_facets=
> &rpp=100&page=N&status=Usagé,Certifié,Démo[&price=lo-hi]
> Chaque annonce de la liste est déjà riche : titre/version FR, année,
> prix, kilométrage, VIN (≈100 %), nom du concessionnaire et surtout le
> GPS EXACT du vendeur (latitude/longitude) — parfait pour la recherche
> par rayon et la dédup VIN avec les concessionnaires connectés.
> (Paramètres découverts dans les bundles Nuxt : constantes c.b du module
> 5731047.js — latlng/locale/rpp/page/price/status/no_facets/no_results.)
> 
> Profondeur : l'API plafonne à ~1 000 résultats par requête (rpp=100 →
> meta.pages ≤ 10) pour ~24 000 annonces d'occasion. On PARTITIONNE donc
> par tranches de prix (bissection récursive + tranche ouverte « lo- ») :
> chaque annonce n'est téléchargée qu'une fois, ~250 requêtes directes
> par sync complet, zéro crédit d'API de scraping externe.
> 
> Ville : absente de la liste — déduite du GPS exact via nearest_city()
> (data/villes_gps.json) pour l'affichage et la région administrative.
> Carburant/boîte : absents de la liste ; repli commun finalize() (jetons
> du titre/de la version). Page détail : /auto/{slug_fr} (non visitée —
> économie ; le VIN et le GPS sont déjà dans la liste).
> 
> Plafond : AUTOKA_OTOGO_MAX (défaut 0 = inventaire complet).

## Complétude des champs (annonces actives, N = 24 201)

| Champ | % rempli |
|---|---|
| Marque | 99.9 % |
| Modèle | 100.0 % |
| Année | 100.0 % |
| Kilométrage | 99.3 % |
| Prix | 100.0 % |
| Carburant | 8.0 % |
| Boîte (transmission) | 0.0 % |
| VIN | 99.2 % |
| Photos | 96.7 % |
| Carfax | 0.0 % |
| GPS (lat/lng) | 100.0 % |

## Sources membres (BD live)

| Source | Nom | Ville | Région | Actives | Masquées (dup VIN) | Dernier sync | Statut |
|---|---|---|---|---|---|---|---|
| `otogo` | Otogo.ca | — | — | 24201 | 6766 | 2026-09-13 16:20 | OK (24051 trouvés) |

## Erreurs de synchronisation récentes

Aucune erreur dans le sync_log pour les sources de ce module.