# ASUS Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/asus/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/asus-search |

## Description

Search ASUS products and retrieve real-time prices, specs, availability, and promotions across laptops, GPUs, monitors, and more.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/asus/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'ROG Strix G16' in France

```json
{
  "meta": {
    "query": "ROG Strix G16",
    "country": "fr",
    "total_pages": 1,
    "current_page": 1,
    "has_next_page": false,
    "total_results": 14
  },
  "results": [
    {
      "id": "90NR0D51-M004A0",
      "model": "G614JU-N3130W",
      "price": "1 099,00 €",
      "title": "ASUS ROG Strix G16 (2023) G614JU - Intel Core i7-13650HX - RTX 4050 - 16 Go RAM - 512 Go SSD",
      "rating": 4.6,
      "series": "ROG Strix",
      "category": "Laptops",
      "currency": "EUR",
      "key_specs": {
        "CPU": "Intel Core i7-13650HX",
        "GPU": "NVIDIA GeForce RTX 4050 6 Go",
        "RAM": "16 Go DDR5",
        "Display": "16 pouces FHD 165 Hz",
        "Storage": "512 Go SSD NVMe PCIe 4.0"
      },
      "price_float": 1099,
      "product_url": "https://www.asus.com/fr/laptops/for-gaming/rog-strix/rog-strix-g16-2023-g614ju/techspec/",
      "availability": "in_stock",
      "is_promotion": true,
      "sub_category": "Gaming Laptops",
      "reviews_count": 284,
      "thumbnail_url": "https://www.asus.com/media/global/gallery/r3lqcXlmvGqBdBOc_setting_fff_1_90_end_500.png",
      "original_price": "1 299,00 €"
    },
    {
      "id": "90NR0D51-M01280",
      "model": "G614JVR-N4118W",
      "price": "1 499,00 €",
      "title": "ASUS ROG Strix G16 (2024) G614JVR - Intel Core i9-14900HX - RTX 4060 - 32 Go RAM - 1 To SSD",
      "rating": 4.7,
      "series": "ROG Strix",
      "category": "Laptops",
      "currency": "EUR",
      "key_specs": {
        "CPU": "Intel Core i9-14900HX",
        "GPU": "NVIDIA GeForce RTX 4060 8 Go",
        "RAM": "32 Go DDR5",
        "Display": "16 pouces QHD+ 240 Hz",
        "Storage": "1 To SSD NVMe PCIe 4.0"
      },
      "price_float": 1499,
      "product_url": "https://www.asus.com/fr/laptops/for-gaming/rog-strix/rog-strix-g16-2024-g614jvr/techspec/",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "Gaming Laptops",
      "reviews_count": 127,
      "thumbnail_url": "https://www.asus.com/media/global/gallery/ROGStrixG16-2024_setting_fff_1_90_end_500.png",
      "original_price": null
    }
  ]
}
```

## Documentation

## Overview
The ASUS Search API provides structured access to the full ASUS product catalogue across multiple country storefronts. Search by keyword, model number, or series to retrieve live prices, promotions, ratings, specs, and availability.

## Quickstart
```
GET https://api.piloterr.com/v2/asus/search?query=ROG+Strix+G16&country=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, model number, or product series |
| `country` | string | no | Storefront: `fr`, `de`, `us`, `gb`, `es`, `it` |
| `category` | string | no | Category filter |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 40) |

## Main use cases
- Monitor ASUS laptop and GPU prices across multiple countries
- Track promotional campaigns for electronics retail intelligence
- Build product comparison tools using live ASUS data
- Enrich catalogues with real-time ASUS specs and pricing
- Feed price-alert systems for B2B hardware procurement teams