Gumtree

get/gumtree/search

Request

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

Query parameters

querystring nullable

Search keywords, e.g. bike. Provide query or category_id.

category_idstring nullable

Numeric Gumtree category id from the categories endpoint, e.g. 86 for other bikes, 151 for sofas, 2551 for cars, vans and motorbikes, 10201 for flats and houses. Provide query or category_id.

pageinteger

1-based page number, 1 to 1000. Defaults to 1.

sizeinteger

Results per page, 1 to 20. Defaults to 20.

min_priceinteger nullable

Minimum price in GBP.

max_priceinteger nullable

Maximum price in GBP. Must be at least min_price.

location_idstring nullable

Numeric location id from the location endpoint, e.g. 895643. Use together with location_type.

location_type'LOCATION' | 'POSTCODE' | 'null' nullable

LOCATION or POSTCODE. Required with location_id.

distance'NATIONWIDE' | 'ZERO' | 'ONE' | 'THREE' | 'FIVE' | 'TEN' | 'FIFTEEN' | 'THIRTY' | 'FIFTY' | 'SEVENTY_FIVE' | 'HUNDRED' | 'HUNDRED_FIFTY' | 'TWO_HUNDRED_FIFTY' | 'FIVE_HUNDRED'

Radius around the location: NATIONWIDE, ZERO, ONE, THREE, FIVE, TEN, FIFTEEN, THIRTY, FIFTY, SEVENTY_FIVE, HUNDRED, HUNDRED_FIFTY, TWO_HUNDRED_FIFTY or FIVE_HUNDRED miles. Defaults to NATIONWIDE.

sort'DATE_DESCENDING' | 'PRICE_ASCENDING' | 'PRICE_DESCENDING' | 'RELEVANCE_DESCENDING'

DATE_DESCENDING, PRICE_ASCENDING, PRICE_DESCENDING or RELEVANCE_DESCENDING. Defaults to DATE_DESCENDING.

Response

string required

Changes

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