---
updatedAt: 2026-06-23T15:07:09.000Z
agentTools:
  projectIndex: https://readme.priceapi.com/llms.txt
---

# Make your first request

Use the web app to request a product and download the results.

This guide takes you through the basic functionality of Price API. If at any point you have questions, please contact us via our chat system (lower right corner).

# Prerequisites

This guide assumes that you have a free account at Price API and that you are currently logged in to it. If you don't have an account yet, [start your free trial](https://www.priceapi.com/) now.

# Let's request some product data!

Make sure you are logged and navigate to the **[new request tool](https://priceapi.metoda.com/request?)**.

<Image align="center" border={true} width="600% " src="https://files.readme.io/37838b37536ac271ac5b09c891501a3ede0b4b4dcfa235c2790fb25611a7ac25-image.png" className="border" />

## Step 1: Select country & source

From the dropdown, select the country and source you want Price API to collect data from. The available sources per country varies.

## Step 2: Select the kind of information

The so-called "topic" specifies which kind of information you are interested in. For repricing, choose "Product And Offers.". Topic names are pretty similar to the page you'd see on the source. Following is a short information about what basic topics mean:

* Search Results:  It will return information from [search\_results page](https://www.google.de/search?q=iphone\&tbm=shop)( page you get when you use "search bar" to search a product on the main page).
* Offers: It return information from the [offer's page](https://www.google.de/search?ibp=oshop\&q=Apple+iPhone+12+mini\&prds=catalogid:12326960644742689735\&gl=de\&hl=de) that has a list all offers.
* Product: It will return information available on the [product page](https://www.google.de/search?ibp=oshop\&q=Apple+iPhone+12+mini\&prds=catalogid:12326960644742689735\&gl=de\&hl=de) of the source that has all the selected product's information.
* Product And Offers: This is a topic that will have combination of all three topics mentioned above. It picks the first product from search result's page, returns information about the picked product and offers related to it.

<Image align="center" border={true} width="600% " src="https://files.readme.io/8531693ba5ea188c37d5fc1e79755b1f19818e4b8a90c27793b6f5802e62c691-image.png" className="border" />

## Step 3: Identify the products

With Price API, you can specify the products you are searching for by. You set this in the "Key" dropdown.

> 📘 Barcodes, GTIN, EAN, UPC and JAN
>
> See article [Barcodes, GTIN, EAN, UPC and JAN](https://readme.priceapi.com/docs/barcodes-gtin-upc-ean-and-jan) to find out what these are and where to find them for your products.
>
> **Pros:** Will give you a high matching rate, works across sources\
> **Cons:** Requires you to have these identifiers in your data
>
> **Example:** `00190198791757`

> 📘 Source's own identifiers
>
> All sources assign their own identifiers to well-known products. On Amazon, for example, this is the ASIN.
>
> **Pros:** Will give you a perfect matching rate with the source\
> **Cons:** Requires you to collect these identifiers, only works for one source
>
> **Example:** `B07HBD26C7` for Amazon sources, `3396285766542281019` for Google Shopping Belgium

> 📘 Keyword search terms
>
> Any search term that leads to the results you are interested on the source. For a good matching rate, include more words, such as brand name, product name, model, and variant.
>
> **Pros:** Easy to use, works across sources\
> **Cons:** Can have a lower matching rate
>
> **Example:** `apple iphone xs 64 gb gold`

In "Values," you can identify up to 1,000 products. Write (or paste in) one value per line. E.g. if you selected "GTIN" from the "Key" dropdown, write one GTIN per line. If you selected "Term" from the "Key" dropdown, write one search term per line.

Then hit the "Create Request" button.

<Image align="center" border={true} width="800px" src="https://files.readme.io/40521660bf53b62796d13ac802d04325981c58ffbfab13c4b799285aaa0f1abb-image.png" className="border" />

# Wait for the results & view or download

After pressing the "request" button, Price API will collect data from the source you selected. Depending on your settings, this information is likely collected fresh (and not taken from cache), so expect this to take a few moments. If you identified a single product, it will likely take a few seconds. If you identified a thousand products, it will likely take a few minutes.

As soon as the download icon appears, you can view the results as JSON or XML in the browser.

<Image align="center" border={true} src="https://files.readme.io/7beda9c36e5f2bd454668101329b5ae8dfa366b2ffba342e104ecf885a4dad3b-image.png" className="border" />

<br />

You can also download them as Excel, CSV, JSON, or XML.

<Image align="center" border={true} src="https://files.readme.io/6c301cf75e8ee3d3fe26014f6624a0c1caa43cdd07e6fde041c686a4da43b0e2-image.png" className="border" />

# Mark jobs as favorites

The Favourites feature lets users bookmark up to 5 jobs for quick access. You can mark them as favorites from the option below

<Image align="center" border={true} src="https://files.readme.io/d7ae18647cb27b61838714b647dc011be1e87ee1218ae83a60208f0ba5b1b984-image.png" className="border" />

Marked jobs appear in the Favourites tab, giving a focused view of important or frequently used jobs without having to search through the full list. From there, you can easily review and rerun them at any time.

<Image align="center" border={true} src="https://files.readme.io/19ce28f8fd76dd4157ed79dbe54a7ee9194f686813cc2d3e271d32c921734925-image.png" className="border" />

# Summary

That's it. We've covered all the steps you needs to take to access millions of products on hundreds of data sources, all in the same standardised format.

Of course, if you want to, you can integrate Price API into your system, so a program can do these steps on your behalf.