SubitoMotori

get/subito-motori/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/subito-motori/search
  • Auth: API key in header X-API-KEY

Query parameters

cinteger

Category id. 2 = Auto.

qstring nullable

Free text search, e.g. panda.

qsoboolean

Restrict the free text search to ad titles.

cbstring nullable

6-digit brand key from the makes endpoint, e.g. 000008 = FIAT.

cm[]string[]

Repeatable 6-digit model key from the models endpoint, e.g. 003415.

t's' | 'k' | 'g' | 'u' | 'h'

s = In vendita, k = Cercasi, g, u, h.

sort'datedesc' | 'relevance' | 'priceasc' | 'pricedesc' | 'yearasc' | 'yeardesc' | 'mileageasc' | 'mileagedesc' | 'hpasc' | 'hpdesc' | 'vlenasc' | 'vlendesc'

datedesc, relevance, priceasc, pricedesc, yearasc, yeardesc, mileageasc, mileagedesc, hpasc, hpdesc, vlenasc or vlendesc.

psinteger nullable

Minimum price bucket in EUR from the filters endpoint.

peinteger nullable

Maximum price bucket in EUR from the filters endpoint.

msinteger nullable

Minimum mileage bucket in km from the filters endpoint.

meinteger nullable

Maximum mileage bucket in km from the filters endpoint.

ysinteger nullable

Minimum first-registration year.

yeinteger nullable

Maximum first-registration year.

hpsinteger nullable

Minimum power in CV.

hpeinteger nullable

Maximum power in CV.

epsinteger nullable

Minimum power in kW.

epeinteger nullable

Maximum power in kW.

fl[]integer[]

Repeatable fuel code: 1 petrol, 2 diesel, 3 lpg, 4 electric, 6 hybrid, 7 methane.

grinteger

1 manual, 2 automatic, 3 sequential, 4 other.

ct[]integer[]

Repeatable body code: 1 utilitaria, 2 berlina, 3 wagon, 4 minivan, 5 SUV, 6 cabrio, 7 coupé, 8 microcar.

pl[]integer[]

Repeatable emission class 1-13 (13 = euro6e).

cl[]integer[]

Repeatable color code 1-10.

cvs[]integer[]

Repeatable condition: 1 usato, 2 km0, 3 nuovo.

drinteger

1 = 2/3, 2 = 4/5, 3 = 6/7.

ssinteger

Minimum seat count.

seinteger

Maximum seat count.

advt[]string[]

Repeatable seller type: 0,2 = privato, 1 = rivenditore (dealer).

eq[]string[]

Repeatable equipment key from the filters endpoint.

ic[]integer[]

Repeatable condition code 10-50 (subitopy).

rinteger nullable

Region key 1-20, e.g. 15 = Campania.

ciinteger nullable

Province/city key from the geo taxonomy, e.g. 4 = Napoli.

tostring nullable

6-digit ISTAT municipality code, e.g. 063049.

ndoboolean

Only listings for new drivers.

urgboolean

Only urgent listings.

shpboolean

Only shippable listings.

vatdboolean

Only VAT-deductible listings.

qltsfboolean

Only quality-certified listings.

qsms[]string[]

Repeatable quality seal key from the filters endpoint.

liminteger

Listings per page, 1-100. Defaults to 30.

startinteger

Zero-based result offset. The upstream caps at 10 000.

Response

string required

Changes

No recorded changes to this operation across all 3 revisions of this API.