# Liste des annonces

**GET** `/v1/listings`

Recherche et renvoie des annonces avec filtres, tri et pagination.

Recherche et liste les annonces du catalogue avec filtres, tri et pagination.

## Paramètres de requête

- `page` (number, facultatif) : numéro de page, à partir de 1.
- `per_page` (number, facultatif) : nombre d’enregistrements par page. Valeur par défaut : 30 ; maximum : 100.
- `price_from` (number, facultatif) : prix minimum.
- `price_to` (number, facultatif) : prix maximum.
- `search_key` (string, facultatif) : mot-clé recherché dans le titre ou la description de l’annonce.
- `sort` (string, facultatif) : ordre de tri. Valeurs acceptées : `relevance`, `price_high_to_low`, `price_low_to_high`, `newest_first`, `oldest_first`.
- `category_id` (number, facultatif) : identifiant de catégorie pour filtrer les annonces.
- `account_id` (number, facultatif) : identifiant du compte propriétaire.
- `attribute_value_id` (string, facultatif) : identifiants de valeurs d’attribut séparés par des virgules.