> ## Documentation Index
> Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites & rate limits de l'API Fluximmo

> Limites payload (size, keywords, geo), quotas (clé test vs prod), comportement en cas de dépassement.

Cette page rassemble toutes les bornes — payload, quotas, rate limits — utiles pour dimensionner votre intégration.

## Limites payload

Bornes statiques validées côté API. Un dépassement renvoie `400` avec `error.code = 10002` ou `10003`.

| Limite                       | Valeur                                                                  |
| ---------------------------- | ----------------------------------------------------------------------- |
| `search.size` (full search)  | **1 à 100**                                                             |
| `search.size` (lite search)  | **1 à 25**                                                              |
| `search.keywords[]`          | max **20 items**                                                        |
| `search.fullTexts[]`         | max **20 items**                                                        |
| `geoDistance.distanceKm`     | **> 0** (sinon erreur)                                                  |
| `geoBoundingBox.topLeft.lat` | doit être **> `bottomRight.lat`**                                       |
| `geoBoundingBox.topLeft.lon` | doit être **\< `bottomRight.lon`**                                      |
| `location[]`                 | combinable (postalCode + insee + department + bbox/distance dans un OR) |

<Warning>
  Le filtre `location[].city` est **ignoré** par le moteur. Utilisez `postalCode`, `inseeCode` ou `department`. Voir [Recherche géographique](/concepts/recherche-geographique).
</Warning>

## Rate limits

| Type de clé                | Cadence indicative               |
| -------------------------- | -------------------------------- |
| **Clé test**               | \~5 req/s                        |
| **Clé production starter** | \~15 req/s                       |
| **Clé production custom**  | 50+ req/s sur devis selon volume |

Comportement en cas de dépassement :

* HTTP **`429 Too Many Requests`**
* Header **`Retry-After`** (en secondes) lorsque applicable — à respecter
* En l'absence de `Retry-After`, appliquer un **backoff exponentiel + jitter** (voir [Bonnes pratiques](/ressources/bonnes-pratiques#retry-cote-client-request))

<Note>
  Pour ajuster votre cadence (gros batch, montée en charge, contrainte temps réel), écrivez à [contact@fluximmo.com](mailto:contact@fluximmo.com) avec votre `clientId` et votre besoin.
</Note>

## Quotas par type de clé

| Type de clé        | Validité      | Périmètre                                                                                                                                                                                                                                                         |
| ------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clé test**       | 1 semaine     | Quotas réduits, suffisants pour découverte, POC et validation d'intégration. Accès complet aux modules Analytics, IA, Géocodage. Seule restriction : **création d'alertes webhook sur demande** (par mail à [contact@fluximmo.com](mailto:contact@fluximmo.com)). |
| **Clé production** | Selon contrat | Activée depuis l'espace client [my.fluximmo.io](https://my.fluximmo.io). Pas d'engagement initial, pas de paiement avant validation de votre intégration. Pricing au volume.                                                                                      |

<Card title="Clé test gratuite — 1 semaine" icon="key" href="https://my.fluximmo.io">
  Créez un compte sur **my.fluximmo.io** pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.
</Card>

## Endpoints non publics par défaut

Certains endpoints de niche ne sont pas exposés publiquement par défaut. Ils peuvent être ajoutés à votre clé sur demande, ou faire l'objet d'un sur-mesure (devis).

Détails : [Capabilities sur demande](/api-reference/capabilities-sur-demande).

## Suivi de consommation

L'endpoint dédié donne votre consommation en temps réel :

[`GET /v2/protected/admin/consumption`](/api-v2-reference/consumption/get-your-credit-consumption)

Le dashboard [my.fluximmo.io](https://my.fluximmo.io) affiche également un récapitulatif (jour, mois, par endpoint).

<Tip>
  Branchez l'endpoint `consumption` à votre monitoring pour lever une alerte avant d'atteindre 80% du quota mensuel.
</Tip>

## Que faire en cas de dépassement ?

1. **`429`** : appliquer le backoff, ralentir la cadence.
2. **Quota mensuel atteint** : les requêtes peuvent être rejetées. Contacter le support pour augmenter le quota.
3. **Endpoint non activé** (`403`) : demander l'activation via [contact@fluximmo.com](mailto:contact@fluximmo.com).

Voir [Codes d'erreur](/ressources/codes-erreur) pour la gestion fine.