BringATrailer

get/bring-a-trailer/v1/auctions/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/bring-a-trailer/v1/auctions/search
  • Auth: API key in header X-API-KEY

Query parameters

auction_status'active' | 'past'

active (default) or past.

sale_status'sold' | 'unsold' | 'null' nullable

sold or unsold (reserve not met). Past auctions only.

sort'ta' | 'td' | 'ba' | 'bd' | 'vd'

ta (ending soonest), td (recently closed), ba (bid low to high), bd (bid high to low) or vd (popular).

pageinteger

1-based result page.

per_pageinteger

Listings per page, 1 to 32.

make_or_modelstring nullable

Comma-separated term IDs from the filters endpoint, e.g. 1832980 for Ferrari.

categorystring nullable

Comma-separated category term IDs, e.g. 434 for Convertibles.

erastring nullable

Era slug from the filters endpoint, e.g. pre-1900 or 2010s.

originstring nullable

Comma-separated origin term IDs, e.g. 8 for Italian.

location_countrystring nullable

Comma-separated location term IDs, e.g. 89009061 for United States.

minimum_yearinteger nullable

Minimum model year.

maximum_yearinteger nullable

Maximum model year.

minimum_bidinteger nullable

Minimum current bid in USD.

maximum_bidinteger nullable

Maximum current bid in USD.

auction_type'premium' | 'no-reserve' | 'alumni' | 'null' nullable

premium, no-reserve or alumni.

range'7D' | '30D' | '1Y' | '2Y' | '5Y' | 'null' nullable

7D, 30D, 1Y, 2Y or 5Y.

zip_codestring nullable

Zip code for location filtering. Requires user_lat and user_lon.

user_latnumber nullable

Latitude for location filtering.

user_lonnumber nullable

Longitude for location filtering.

maximum_distanceinteger nullable

Maximum distance for location filtering.

sstring nullable

Free-text search query.

Response

string required

Changes

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