API Coming Soon

# pip install firearmdistributors-api
from firearmdistributors import FirearmAPI

# Initialize with your API key
api = FirearmAPI(api_key='your_api_key_here')

# Search for products with filters
products = api.products.search(
    query='AR-15',
    category='rifles',
    max_price=1200,
    in_stock=True
)

# Get the best prices
for product in products['products']:
    best_price = min(product['distributors'], key=lambda x: x['price'])
    print(f"{product['name']}: ${best_price['price']} from {best_price['distributor']}")

# Set up price alerts
api.alerts.create(
    product_id=products['products'][0]['id'],
    target_price=900,
    webhook_url='https://yoursite.com/webhook'
)

<?php
// composer require firearmdistributors/api-client
require_once 'vendor/autoload.php';

use FirearmDistributors\Client;

$client = new Client([
    'api_key' => 'your_api_key_here',
    'timeout' => 30
]);

// Search products
$results = $client->products()->search([
    'query' => 'Smith Wesson M&P',
    'category' => 'handguns',
    'limit' => 20
]);

// Display results with pricing
foreach ($results['products'] as $product) {
    echo "<h3>{$product['name']}</h3>";
    echo "<ul>";
    
    foreach ($product['distributors'] as $dist) {
        if ($dist['in_stock']) {
            echo "<li>{$dist['name']}: \${$dist['price']}</li>";
        }
    }
    echo "</ul>";
}
?>

# Search for products
curl -X GET \
  'https://api.firearmdistributors.com/v1/products?query=ruger&category=rifles&in_stock=true' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

# Get specific product pricing
curl -X GET \
  'https://api.firearmdistributors.com/v1/products/12345/pricing' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# Create price alert
curl -X POST \
  'https://api.firearmdistributors.com/v1/alerts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "12345",
    "target_price": 450.00,
    "webhook_url": "https://yoursite.com/webhook"
  }'