> ## Documentation Index
> Fetch the complete documentation index at: https://pricepirate.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Use the Price Data API through RapidAPI for marketplace data, EAN searches, and asynchronous jobs.

The Price Data API provides price and offer data for multiple marketplace sources. You subscribe through RapidAPI and send requests with your RapidAPI key.

## Access through RapidAPI

Subscribe to the API product you need on RapidAPI:

<Card title="PricePirate on RapidAPI" icon="external-link" href="https://rapidapi.com/organization/pricepirate" cta="Subscribe on RapidAPI" arrow="true">
  Choose the Global product. It contains the universal search and the source-specific endpoints.
</Card>

## Authentication

RapidAPI requires these headers for requests:

```text theme={null}
x-rapidapi-key: <rapidapi-key>
x-rapidapi-host: <rapidapi-host>
```

Copy the values from your RapidAPI dashboard. Treat the key like a password.

## Search pattern

The universal endpoint searches products by GTIN, EAN, or UPC. Set `source` to the marketplace source you need.

```bash theme={null}
curl --request POST \
  --url https://<rapidapi-host>.p.rapidapi.com/universal/search-by-gtin \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-host: <rapidapi-host>' \
  --header 'x-rapidapi-key: ...' \
  --data '{"source":"idealo","country":"de","values":["4013474101469"]}'
```

## Synchronous and asynchronous results

Some sources return results directly. Other sources start a job and return the result later.

For asynchronous endpoints, you usually follow these steps:

1. Start a `jobs` request.
2. Store the returned job ID.
3. Fetch the status or result.
4. Use `ping` when the API offers a simple availability check.

## Sources

The Global product bundles **Klarna**, **PriceRunner**, **Idealo**, **Google Shopping**, and **Allegro**. The reference shows only the Global API because it contains all endpoints.

## Reference

Open **Global** in the navigation to see all Price Data API endpoints.