{
  "info": {
    "name": "Realty237 Data API — v1",
    "description": "Collection Postman officielle pour la Data API Realty237 (immobilier Cameroun). Documentation complète : https://realty237.com/developers",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "realty237-data-api-v1",
    "version": "1.0.0"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "X-API-Key", "type": "string" },
      { "key": "value", "value": "{{apiKey}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://realty237.com",
      "type": "string",
      "description": "Base URL de l'API. Remplacer par votre URL preview si besoin."
    },
    {
      "key": "apiKey",
      "value": "rlty_pub_REPLACE_WITH_YOUR_KEY",
      "type": "string",
      "description": "Votre clé API Realty237 (obtenue depuis /dashboard?tab=data-api)"
    }
  ],
  "item": [
    {
      "name": "Ping — Vérifier ma clé + quota restant",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/ping",
          "host": ["{{baseUrl}}"],
          "path": ["api", "v1", "ping"]
        },
        "description": "Endpoint de vérification. Renvoie `quota_remaining` dans meta. Utilisable pour un health check consommant 1 appel."
      }
    },
    {
      "name": "Listings — Recherche paginée",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/listings?city=Douala&purpose=sale&limit=50&skip=0",
          "host": ["{{baseUrl}}"],
          "path": ["api", "v1", "listings"],
          "query": [
            { "key": "city",      "value": "Douala",  "description": "Ville (Douala, Yaoundé, Bafoussam, Kribi…)" },
            { "key": "purpose",   "value": "sale",    "description": "'sale' ou 'rent'" },
            { "key": "type",      "value": "villa",   "description": "villa | appartement | terrain | studio | …", "disabled": true },
            { "key": "min_price", "value": "50000000","description": "Prix minimum FCFA", "disabled": true },
            { "key": "max_price", "value": "300000000","description": "Prix maximum FCFA", "disabled": true },
            { "key": "limit",     "value": "50",      "description": "1-200" },
            { "key": "skip",      "value": "0",       "description": "Pagination offset" }
          ]
        }
      }
    },
    {
      "name": "Listings — Détail par ID",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/listings/REPLACE_LISTING_ID",
          "host": ["{{baseUrl}}"],
          "path": ["api", "v1", "listings", "REPLACE_LISTING_ID"]
        }
      }
    },
    {
      "name": "Market — Stats agrégées par ville",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/market/stats?city=Douala&purpose=sale",
          "host": ["{{baseUrl}}"],
          "path": ["api", "v1", "market", "stats"],
          "query": [
            { "key": "city",    "value": "Douala", "description": "Filtrer par ville (optionnel)" },
            { "key": "purpose", "value": "sale",   "description": "'sale' ou 'rent' (optionnel)" }
          ]
        },
        "description": "Retourne prix moyen/min/max et volume par ville. Idéal pour dashboards et rapports."
      }
    },
    {
      "name": "Market — Tendances par quartier & type",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/market/trends?city=Douala",
          "host": ["{{baseUrl}}"],
          "path": ["api", "v1", "market", "trends"],
          "query": [
            { "key": "city",    "value": "Douala", "description": "Focus ville (optionnel)" },
            { "key": "purpose", "value": "sale",   "description": "'sale' ou 'rent' (optionnel)", "disabled": true }
          ]
        }
      }
    }
  ]
}