Gumtree

List Gumtree search suggestions

List Gumtree search suggestions for partial text, with suggested categories.

GET/v1/gumtree/search/suggestions
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

What the user has typed so far, e.g. `bik`.

min 1 chars · max 100 chars

Response fields
14

Endpoint-specific response payload.

dataquery
string

Text the suggestions complete.

Suggested searches, best first, up to 10. Empty when none.

datasuggestions[]text
string

Suggested search, e.g. `bike rack`.

Categories the site proposes for this search, when it proposes any.

datasuggestions[]categories[]id
string

Category id.

datasuggestions[]categories[]name
stringnullable

Category name.

datasuggestions[]categories[]slug
stringnullable

Category slug.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/gumtree/search/suggestions?query=bik" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree search suggestions.