# Social Fetch API - Gumtree endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 11 documented Gumtree operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/gumtree/search Search Gumtree listings Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/search/get.mdx SDK: client.gumtree.searchListings({ query: "road bike", category: "bicycles", location: "london", distance: 10, minPrice: 100, maxPrice: 500, sort: "date" }) Parameters: - query (optional, string) - Search text, e.g. `road bike`. Leave it out to browse a whole category. - category (optional, string) - Category slug, e.g. `cars`, `bicycles` or `property-to-rent` (the `slug` from the categories endpoint). Default: all categories. - location (optional, string) - Where to search: a place slug such as `london` or `manchester`, a postcode district such as `M1`, or a full postcode. Default: the whole UK. - distance (optional, integer) - Radius in miles around `location`: 1, 3, 5, 10, 15, 30, 50, 75, 100 or 1000 (nationwide). - minPrice (optional, integer) - Lowest price in whole pounds, e.g. `100`. - maxPrice (optional, integer) - Highest price in whole pounds, e.g. `500`. - sort (optional, string, enum: relevance | date | price_lowest_first | price_highest_first | distance) - `relevance`, `date` (newest first), `price_lowest_first`, `price_highest_first` or `distance` (nearest first). Default: `relevance`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/search?query=road%20bike&category=bicycles&location=london&distance=10&minPrice=100&maxPrice=500&sort=date" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/listings/{listingId} Get Gumtree listing Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/listings/listingid/get.mdx SDK: client.gumtree.getListing({ listingId: "1495075116" }) Parameters: - listingId (required, string) - Gumtree listing id, the number at the end of the listing URL (e.g. `1510635374`), or the full listing URL. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/listings/1495075116" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/listings/{listingId}/similar List Gumtree similar listings Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/listings/listingid/similar/get.mdx SDK: client.gumtree.listSimilarListings({ listingId: "1495075116" }) Parameters: - listingId (required, string) - Gumtree listing id, the number at the end of the listing URL (e.g. `1510635374`), or the full listing URL. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/listings/1495075116/similar" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/sellers/{sellerId} Get Gumtree seller Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/sellers/sellerid/get.mdx SDK: client.gumtree.getSeller({ sellerId: "025e99f5bb366d130f2e02f5b7adab9a" }) Parameters: - sellerId (required, string) - Gumtree seller id: the 32-character id in the seller's profile URL (`gumtree.com/profile/account/`), also returned as `seller.sellerId` on a listing and as `sellerId` on a seller's listings. Not the numeric `sellerUserId`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/sellers/025e99f5bb366d130f2e02f5b7adab9a" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/sellers/{sellerId}/listings List Gumtree seller listings Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/sellers/sellerid/listings/get.mdx SDK: client.gumtree.listSellerListings({ sellerId: "025e99f5bb366d130f2e02f5b7adab9a" }) Parameters: - sellerId (required, string) - Gumtree seller id: the 32-character id in the seller's profile URL (`gumtree.com/profile/account/`), also returned as `seller.sellerId` on a listing and as `sellerId` on a seller's listings. Not the numeric `sellerUserId`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/sellers/025e99f5bb366d130f2e02f5b7adab9a/listings" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/search/suggestions List Gumtree search suggestions Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/search/suggestions/get.mdx SDK: client.gumtree.suggestSearches({ query: "bik" }) Parameters: - query (required, string) - What the user has typed so far, e.g. `bik`. curl "https://api.socialfetch.dev/v1/gumtree/search/suggestions?query=bik" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/trending List Gumtree trending searches Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/trending/get.mdx SDK: client.gumtree.listTrendingSearches({ locationId: "10000352" }) Parameters: - locationId (optional, string) - Location id from the locations endpoint, e.g. `10000352` for Manchester. Default: `10000392`, the whole UK. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/trending?locationId=10000352" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/categories List Gumtree categories Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/categories/get.mdx SDK: client.gumtree.listCategories({ categoryId: "2549" }) Parameters: - categoryId (optional, string) - Category whose subcategories to list, e.g. `2549` (For Sale). Default: `1`, the top level. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/categories?categoryId=2549" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/filters Get Gumtree category filters Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/filters/get.mdx SDK: client.gumtree.getFilters({ category: "cars" }) Parameters: - category (required, string) - Category slug, e.g. `cars`, `bicycles` or `property-to-rent` (the `slug` from the categories endpoint). Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/filters?category=cars" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/locations Search Gumtree locations Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/locations/get.mdx SDK: client.gumtree.searchLocations({ query: "manch" }) Parameters: - query (required, string) - Start of a place name or postcode, e.g. `manch`, `M1` or `SW1A 1AA`. curl "https://api.socialfetch.dev/v1/gumtree/locations?query=manch" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/gumtree/locations/children List Gumtree location areas Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/gumtree/locations/children/get.mdx SDK: client.gumtree.listLocationAreas({ locationId: "10000393" }) Parameters: - locationId (optional, string) - Location whose areas to list, e.g. `10000393` (England). Default: `10000392`, the whole UK. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/gumtree/locations/children?locationId=10000393" \ -H "x-api-key: YOUR_API_KEY"