# Allopneus Search

## Overview

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

## Description

Access real-time tire data from Allopneus for informed decisions, market analysis, and operational efficiency.

## 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/allopneus/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "products": [
    {
      "name": "DUNLOP SPORT MAXX RT2",
      "price": "139.90",
      "rating": "4.5",
      "details_url": "https://www.allopneus.com/produit/dunlop-sport-maxx-rt2-225-40r18-92-y-81160",
      "availability": "In Stock"
    },
    {
      "name": "MICHELIN PILOT SPORT 4",
      "price": "159.90",
      "rating": "4.7",
      "details_url": "https://www.allopneus.com/produit/michelin-pilot-sport-4-225-40r18-92-y-76152",
      "availability": "In Stock"
    },
    {
      "name": "BRIDGESTONE POTENZA RE050A",
      "price": "129.90",
      "rating": "4.3",
      "details_url": "https://www.allopneus.com/produit/bridgestone-potenza-re050a-225-40r18-92-y-71235",
      "availability": "In Stock"
    },
    {
      "name": "Pirelli P ZERO",
      "price": "149.90",
      "rating": "4.6",
      "details_url": "https://www.allopneus.com/produit/pirelli-p-zero-225-40r18-92-y-81441",
      "availability": "Limited Stock"
    }
  ]
}
```

## Documentation

## Overview
Access real-time tire data from Allopneus for informed decisions, market analysis, and operational efficiency.

## Quickstart
```
GET https://api.piloterr.com/v2/allopneus/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Allopneus Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Allopneus without maintaining scrapers
- Power internal dashboards and workflow automations with live Allopneus data