> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/gumtree/search-suggestions>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumtree/search-suggestions.mdx>

---

# Gumtree Search Suggestions API

What the search box suggests as someone types, best first.

`GET /v1/gumtree/search/suggestions?query=bik` returns `data.suggestions`, up to ten, each with `text` and the `categories` the site proposes for it (id, name and slug). Pass a suggestion's text as `query` and a category slug as `category` to `GET /v1/gumtree/search`.

Text with nothing to suggest returns an empty list.

## Request

- **Endpoint:** `GET /v1/gumtree/search/suggestions`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by partial text
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumtree/search/suggestions/get)
- **Platform page:** [/platforms/gumtree](https://www.socialfetch.dev/platforms/gumtree)

## FAQ

### How many suggestions come back?

Up to ten, best first.

### What are the categories on a suggestion?

Categories the site proposes for that search, for example Bike Racks for bike rack. Use the slug as the category of a search.

### Is the list the same for everyone?

Yes; suggestions do not depend on a user or a place.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
