API Documentation - AI-Optimized Firearms Pricing API

Quick Start

Get started with our AI-optimized API in minutes. Perfect for chatbots (ChatGPT, Claude, etc.), price comparison tools, and inventory systems.

1. Get Your API Key

Sign up for a free account at firearmdistributors.com/register and generate your API key from your dashboard under "API Keys".

2. Make Your First Request

curl -X GET "https://www.firearmdistributors.com/api/ai/search?query=glock+19&limit=5" \
     -H "X-API-Key: your_api_key_here"
        

3. Example Response

{
  "success": true,
  "query": "glock 19",
  "results_count": 5,
  "results": [
    {
      "upc": "764503000171",
      "manufacturer": "Glock",
      "model": "G19 GEN5",
      "title": "Glock 19 Gen 5 9mm 15rd 4.02\" Fixed Sights",
      "pricing": {
        "cost": 449.99,
        "retail": 599.99
      },
      "stock": {
        "available": true,
        "quantity": 25
      }
    }
  ],
  "meta": {
    "response_time_ms": 125,
    "rate_limit": {
      "remaining_daily": 95,
      "remaining_minute": 9
    }
  }
}
        

Available Endpoints

GET

Search Products

/api/ai/search

Search across 354,000+ products by UPC, SKU, name, or brand. Returns AI-optimized results perfect for chatbot responses.

GET

Get Product Details

/api/ai/product

Get detailed product information including specifications, AI-enhanced descriptions, and pricing across all distributors.

GET

Compare Prices

/api/ai/compare

Compare prices across all distributors for a specific product. Find the best deals and availability instantly.

Rate Limits

Tier	Daily Limit	Per Minute	Price
Free	100 calls	10 calls	Free
Basic	1,000 calls	50 calls	$29/month
Pro	10,000 calls	200 calls	$99/month
Enterprise	100,000 calls	1,000 calls	Contact us

Full API Reference

Explore the complete API documentation below with interactive examples. Try it out directly in your browser!

FirearmDistributors.com API