Skip to main content
Piloterr
Back to library

Mobile Ad API

Mobile Ad API. Fetch full car listing data from a mobile.de ad URL or numeric id. Returns pricing, specs, images and features via webunlocker.

Active3 credits = 1 requestGET/v2/mobile/ad

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Mobile Ad API returns full car listing data from mobile.de. Pass an ad URL or numeric ad id, optionally with locale, and receive structured JSON with pricing, specs, images, ratings, and availability fields.

Piloterr fetches via webunlocker and parses Next.js RSC page-vip data (fallback: DOM h1, price, images).

Use Mobile Search to discover listings, then Mobile Ad for the full record.

Supported hostsLink to Supported hosts

Host Notes
www.mobile.de Primary host
suchen.mobile.de Legacy German subdomain; canonicalized before fetch

Region/locale is auto-detected from full ad URLs.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/mobile/ad?query=455111824&locale=fr
GET https://api.piloterr.com/v2/mobile/ad?query=https://www.mobile.de/fr/voiture/d%C3%A9tails.html?id=455111824
GET https://api.piloterr.com/v2/mobile/ad?query=https://www.mobile.de/es/veh%C3%ADculos/detalles.html?id=382789413

ParametersLink to Parameters

Parameter Type Required Description
query string yes Ad URL or numeric id
locale string no Locale when query is id only (default: fr)
return_page_source boolean no Raw HTML as {\"result\": \"...\"} (default: false)

Response fieldsLink to Response fields

Field Type Description
ad_id string Listing id
title string Listing title
url string Canonical ad URL
locale string Parsed locale
make string | null Brand
model string | null Model
price number | null Current price
currency string ISO currency
image_url string | null Main image
images string[] | null Gallery URLs
mileage string | null Formatted mileage
first_registration string | null First registration
fuel_type string | null Fuel label
power string | null Power label
transmission string | null Transmission label
features string[] | null Equipment list
category string | null Body/category label
description string | null Long description (when exposed)
rating number | null Average rating
review_count integer | null Review count
in_stock boolean | null Availability flag

Mobile workflowLink to Mobile workflow

  1. Mobile Search to discover listings
  2. Mobile Ad for full ad JSON (this endpoint)

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query / locale
404 Unparsable or missing ad page
500 Fetch or parsing error

NotesLink to Notes

  • description, seller and images[] may be partial on some ads (RSC split across chunks).
  • Numeric id alone builds a locale-specific details URL.
  • Costs 3 credits per call (webunlocker).

Main use casesLink to Main use cases

  • PDP enrichment: specs, features, gallery, price rating
  • Price monitoring: track individual ad price changes
  • Lead gen: structured vehicle data for automotive CRM workflows

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included