---
title: "Recherche filtrée et triée, avec explication."
method: GET
path: "/api/v1/search"
tags: ["Recherche"]
---

# Recherche filtrée et triée, avec explication.

`GET /api/v1/search`

## Request

- Base URL: `https://chaletiste.fr`
- URL: `https://chaletiste.fr/api/v1/search`
- Auth: none required

## Query parameters

- `q` string
- `category` 'abri' | 'abris' | 'abris-de-jardin-bois' | 'bureau' | 'bureau-de-jardin' | 'chalet-bureau' | 'chalet-habitable' | 'chalet-jardin' | 'chalet-loisirs' | 'chalets-de-jardin' | 'chalets-habitables' | 'fuste' | 'fuste-rondins' | 'habitable' | 'lodge' | 'maison' | 'maison-bois-kit' | 'pool-house' | 'pool-house-bois' | 'rondins' | 'studio' | 'studio-jardin' | 'studios-de-jardin' | 'tiny' | 'tiny-house' | 'tiny-houses'
- `brand` string
- `max_price` number
- `min_price` number
- `min_surface` number
- `max_surface` number
- `min_wall_mm` number
- `max_delivery_days` number
- `max_assembly_hours` number
- `habitable` boolean
- `sort` 'price' | 'price_per_m2' | 'surface' | 'delivery' | 'assembly' | 'wall' | 'relevance'
- `limit` integer

## Response `200`

Résultats

- SearchResponse
  - `ok` boolean
  - `query` object
  - `sort` string
  - `total` integer
  - `count` integer
  - `explanation` string
  - `results` ProductSummary[]
    - `id` union
      - string
      - number
      - boolean
    - `title` union
      - string
      - number
      - boolean
    - `brand` union
      - string
      - number
      - boolean
    - `category` union
      - string
      - number
      - boolean
    - `price_eur` union
      - string
      - number
      - boolean
    - `price_per_m2_eur` union
      - string
      - number
      - boolean
    - `surface_m2` union
      - string
      - number
      - boolean
    - `wall_thickness_mm` union
      - string
      - number
      - boolean
    - `assembly_hours` union
      - string
      - number
      - boolean
    - `assembly_estimated` union
      - string
      - number
      - boolean
    - `delivery_days_max` union
      - string
      - number
      - boolean
    - `permit` union
      - string
      - number
      - boolean
    - `retailer` union
      - string
      - number
      - boolean
    - `price_date` union
      - string
      - number
      - boolean
    - `url` union
      - string
      - number
      - boolean
    - `api_url` union
      - string
      - number
      - boolean
    - `md_url` union
      - string
      - number
      - boolean
    - `photo` union
      - string
      - number
      - boolean
  - `data_updated` string
  - `license` string
  - `attribution` string

## Other responses

- `400`: Erreur

---

[API](https://skmtc.dev/chaletiste/apis/chaletiste-api.md) · [All operations](https://skmtc.dev/chaletiste/apis/chaletiste-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chaletiste/apis/chaletiste-api/revisions/16c87adadc05?raw)