Sign in Get API key
Otomoto API

Polish Vehicle Listings and Dealer Data via REST API

Search vehicle listings, retrieve rich listing details, resolve dealer profiles and read the make/model taxonomy from Otomoto, Poland's largest car marketplace. Scrappa turns Otomoto data into a structured API for building Polish vehicle search, price benchmarking and dealer-discovery tools.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
4
Endpoints
Poland's largest
Car marketplace
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/otomoto/search?make_id=volvo&page=1" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "6151011578",
        "url": "https://www.otomoto.pl/osobowe/oferta/volvo-xc-60-ID6Ih16a.html",
        "title": "Volvo XC 60",
        "price": {"value": 66000, "currency": "PLN"},
        "location": {"city": "Warszawa", "region": "Mazowieckie"},
        "make": "volvo",
        "model": "xc-60",
        "year": 2019,
        "mileage": 49153,
        "fuel": "petrol",
        "transmission": "automatic"
      }
    ],
    "pagination": {"page": 1, "page_size": 32, "current_offset": 0, "total": 9338, "has_more": true, "live_snapshot": true},
    "facets": {"make": "volvo", "model": null, "sort": "relevance_web"}
  },
  "meta": {"endpoint_family": "search"}
}

What you can build

Structured data for real applications. Here are some ideas.

Polish Vehicle Search

Build search experiences for used and new cars across Warsaw, Kraków, Wrocław, Gdańsk and every other covered Polish location.

Price Benchmarking

Compare asking prices and listing supply by make, model, year, mileage and fuel using repeatable Otomoto search queries.

Dealer Discovery

Resolve the dealer behind any listing and read its public profile, opening hours and inventory categories.

Listing Enrichment

Enrich a matching Otomoto search result with its full description, equipment, parameters, images and seller data.

Available endpoints

Everything you need in one API.

GET

Vehicle Search

/api/otomoto/search

Search Otomoto listings by make, model, price, year, mileage, fuel, gearbox, body type, location and sort

Try in Playground View docs
GET

Listing Details

/api/otomoto/listing

Get a listing description, equipment, parameters, location, images and seller by numeric id or URL

Try in Playground View docs
GET

Dealer Profile

/api/otomoto/dealer

Retrieve a dealer profile with address, opening hours, logo and inventory categories

Try in Playground View docs

Scrappa vs Otomoto (no public developer API)

See how Scrappa compares to the official API.

API available
Scrappa: Yes (4 endpoints)
Otomoto (no public developer API): No public developer API
Vehicle search
Scrappa: Programmatic filters
Otomoto (no public developer API): Website interface
Listing details
Scrappa: Structured JSON
Otomoto (no public developer API): Individual listing pages
Dealer profiles
Scrappa: Structured JSON
Otomoto (no public developer API): Individual dealer pages
Make/model taxonomy
Scrappa: Ready-to-use slugs
Otomoto (no public developer API): Website filter dropdowns
Price benchmarking
Scrappa: Filterable search
Otomoto (no public developer API): Manual browsing
Free tier
Scrappa: 500 credits/month
Otomoto (no public developer API): N/A
Integration ready
Scrappa: REST API
Otomoto (no public developer API): No public API

Key features

Search Polish vehicle listings by make, model, price, year, mileage, fuel, gearbox and body type
Filter by city and radius, sort by price or mileage, and page through results with a real has-more signal
Full listing detail with description, equipment, parameters, images and seller
Dealer profiles with address, opening hours, logo and inventory categories
Make/model taxonomy and filter values behind the search filters
Prices in PLN with card-level price evaluation indicators
Structured JSON responses and one Scrappa API key
No public Otomoto developer API is required

Frequently asked questions

Call the taxonomy endpoint and use the id of the make you want. The search endpoint also validates make and model slugs itself.

make_id, model_id, generation, price_min and price_max, year_min and year_max, mileage_min and mileage_max, engine_power_max, fuel, transmission, body_type, city_id, dist, sort and page.

Send your Scrappa API key in the X-API-KEY header. No Otomoto partner agreement or separate upstream API credentials are needed.

No. Failed requests return a non-success HTTP response with an error object and are not charged.

Start using the Otomoto API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation