PolandMarketplace

Otomoto API

Otomoto listings from Poland as JSON: price, mileage, equipment and photos.

On otomoto.pl

otomoto.pl

In your code

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"price": {…}"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Field names from the real record; values are types, not data.

What is Otomoto?

01/ 06About

About Otomoto

Otomoto is Poland's best-known car marketplace. Dealers and private sellers list cars with price, mileage, equipment and photos. MotorAPIs reads them into JSON next to OLX Poland and the other European sites.

Country
Poland
Type
Marketplace
API
api.motorapis.com
Website
otomoto.pl

What data do I get?

02/ 06Fields

What you get from Otomoto

Every listing, in the shared car record. Fields are filled when Otomoto shows them.

Vehicle

  • VIN, when the site shows it
  • Make, model and generation from one shared catalog
  • Year, fuel, transmission, engine, power
  • Mileage in km

Listing

  • Site and listing ID, link to the ad
  • Price and currency
  • Seller type and location
  • Photo gallery
  • Equipment options

Reports

  • Inspections, when published
  • History reports, when published

One car, many sites

  • The same car on several sites is one car
  • Sold cars stay readable for about a month

How do I ask for it?

03/ 06Requests

Three requests to start

Site IDs differ per key: read them from /domains once, then filter by them.

  1. 01Find the site ID of Otomoto

    GET https://api.motorapis.com/domains
      x-api-key: YOUR_API_KEY
  2. 02Search its cars

    GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
      x-api-key: YOUR_API_KEY
  3. 03Export everything and keep it in sync

    GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
      x-api-key: YOUR_API_KEY

Anything else to know?

04/ 06FAQ

Questions about the Otomoto API

What Otomoto data does the API return?
Each listing as a standard car record: make, model and generation from a shared catalog, year, mileage, price and currency, location, photos and equipment, plus inspections and history reports when Otomoto publishes them.
How do I select Otomoto in the API?
Call /domains once to read the site ID of Otomoto for your key, then pass it as domains[] to /search or /cars.
What if the same car is on several sites?
It is one car with several listings. Each listing keeps its own site, ID, price and link, so you see every place the car is offered.
How do I keep a copy in sync?
Use the /cars export: start without a cursor and follow next_url until it ends. Run it again to refresh your copy.
How can I try it?
Ask for a free demo key and tell us which sites you need. It returns real data in the same JSON as the paid plans.

What else is connected?

Ready to try it?

06/ 06Start

Get Otomoto data in your product

Tell us which sources you need. We reply in writing with a free demo key.

Get a free demo key

MotorAPIs is an independent data provider and is not affiliated with Otomoto. Names and trademarks belong to their owners.