PHP Integration Tutorial

<?php
// test-connection.php
define('API_KEY', 'sk_live_YOUR_API_KEY_HERE');

// Step 1: Check server health
$healthUrl = 'https://queryra.com/health';
$response = @file_get_contents($healthUrl);
$data = json_decode($response, true);

if ($data && isset($data['status']) && $data['status'] === 'healthy') {
    echo "✓ Server is healthy!\n";
    echo "  Version: " . $data['version'] . "\n";
    echo "  Model: " . $data['embedding_model'] . "\n\n";
} else {
    echo "✗ Server health check failed!\n";
    exit(1);
}

// Step 2: Validate API key
$statsUrl = 'https://queryra.com/api/v1/stats?key=' . API_KEY;
$response = @file_get_contents($statsUrl);
$data = json_decode($response, true);

if (isset($data['email'])) {
    echo "✓ API Key is valid!\n";
    echo "  Email: " . $data['email'] . "\n";
    echo "  Plan: " . strtoupper($data['plan']) . "\n";
    echo "  Records: " . $data['products_indexed'] . " / " . $data['products_limit'] . "\n";
    echo "  Searches this month: " . $data['searches_this_month'] . " / " . $data['searches_limit'] . "\n";
} else {
    echo "✗ API Key validation failed!\n";
    if (isset($data['detail'])) {
        echo "  Error: " . $data['detail'] . "\n";
    }
    exit(1);
}
?>

<?php
// bulk-import.php
define('API_KEY', 'sk_live_YOUR_API_KEY_HERE');

// Prepare your products
$products = [
    [
        'id' => 'prod_001',
        'name' => 'Gaming Laptop',
        'description' => 'High-performance laptop for gaming and programming. RTX 4060, 16GB RAM, 1TB SSD.',
        'price' => 1299.99,
        'url' => 'https://yourstore.com/products/gaming-laptop',
        'image_url' => 'https://yourstore.com/images/laptop.jpg',
        'stock' => 15,
        'margin' => 0.75  // Optional: 0-1 range for PRO/Business product boost
    ],
    [
        'id' => 'prod_002',
        'name' => 'Wireless Headphones',
        'description' => 'Noise-cancelling wireless headphones with 30-hour battery life. Perfect for music and calls.',
        'price' => 199.99,
        'url' => 'https://yourstore.com/products/headphones',
        'image_url' => 'https://yourstore.com/images/headphones.jpg',
        'stock' => 50,
        'margin' => 0.60
    ],
    // Add more products...
];

// Send bulk request
$url = 'https://queryra.com/api/v1/records/bulk?key=' . API_KEY;
$payload = ['products' => $products];  // Important: wrap in 'products' key

$options = [
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => json_encode($payload),
        'ignore_errors' => true
    ]
];

$context = stream_context_create($options);
$response = @file_get_contents($url, false, $context);
$data = json_decode($response, true);

if (isset($data['status']) && $data['status'] === 'success') {
    echo "✓ Bulk import successful!\n";
    echo "  Added: " . $data['added'] . " records\n";
    echo "  Total in account: " . $data['total_records'] . "\n";
} else {
    echo "✗ Import failed!\n";
    if (isset($data['detail'])) {
        echo "  Error: " . $data['detail'] . "\n";
    }
}
?>

<?php
// check-records.php
define('API_KEY', 'sk_live_YOUR_API_KEY_HERE');

$url = 'https://queryra.com/api/v1/records/stats?key=' . API_KEY;
$response = @file_get_contents($url);
$data = json_decode($response, true);

echo "Records: " . $data['total_records'] . " / " . $data['limit'] . "\n";
echo "Synced: " . $data['synced_records'] . "\n";
echo "Pending sync: " . $data['pending_sync'] . "\n";
?>

<?php
define('API_KEY', 'sk_live_YOUR_API_KEY_HERE');

$url = 'https://queryra.com/api/v1/records/stats?key=' . API_KEY;
$response = @file_get_contents($url);
$data = json_decode($response, true);

if ($data['synced_records'] > 0) {
    echo "✓ Sync complete! " . $data['synced_records'] . " records are searchable.\n";
} else {
    echo "⚠ No records synced yet. Please sync in dashboard.\n";
}
?>

<?php
// search.php
define('API_KEY', 'sk_live_YOUR_API_KEY_HERE');
define('QUERY', 'gift for my dad');  // Change this to test different queries

$url = 'https://queryra.com/api/v1/search?' . http_build_query([
    'key' => API_KEY,
    'q' => QUERY,
    'limit' => 5
]);

$response = @file_get_contents($url);
$data = json_decode($response, true);

echo "Search: \"" . QUERY . "\"\n\n";

foreach ($data['results'] as $i => $result) {
    echo ($i + 1) . ". " . $result['name'] . "\n";
    echo "   Score: " . round($result['relevance_score'], 3) . "\n";
    echo "   " . substr($result['description'], 0, 80) . "...\n\n";
}
?>