{
  "info": {
    "name": "TexasGunFinder API",
    "description": "Read-only JSON search over the TX firearms corpus.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://texasgunfinder.com/api/v1"
    },
    {
      "key": "api_key",
      "value": "",
      "description": "Optional; contact for higher limits."
    }
  ],
  "item": [
    {
      "name": "Search listings",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/search?q=glock%2019&city=fort-worth&limit=20&api_key={{api_key}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "search"
          ],
          "query": [
            {
              "key": "q",
              "value": "glock 19",
              "description": "Full-text query"
            },
            {
              "key": "city",
              "value": "fort-worth",
              "description": "City slug (repeatable)"
            },
            {
              "key": "limit",
              "value": "20"
            },
            {
              "key": "api_key",
              "value": "{{api_key}}"
            }
          ]
        }
      }
    },
    {
      "name": "Search by brand + category",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/search?brand=sig-sauer&category=handguns&condition=used&api_key={{api_key}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "search"
          ],
          "query": [
            {
              "key": "brand",
              "value": "sig-sauer"
            },
            {
              "key": "category",
              "value": "handguns"
            },
            {
              "key": "condition",
              "value": "used"
            },
            {
              "key": "api_key",
              "value": "{{api_key}}"
            }
          ]
        }
      }
    },
    {
      "name": "Corpus stats",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/stats?api_key={{api_key}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "stats"
          ],
          "query": [
            {
              "key": "api_key",
              "value": "{{api_key}}"
            }
          ]
        }
      }
    },
    {
      "name": "List dealers",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/dealers?limit=50&api_key={{api_key}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "dealers"
          ],
          "query": [
            {
              "key": "limit",
              "value": "50"
            },
            {
              "key": "api_key",
              "value": "{{api_key}}"
            }
          ]
        }
      }
    }
  ]
}