{ "openapi": "3.0.1", "info": { "title": "Gumtree Scraper — UK Classifieds, Cars & Property, No Phones", "description": "UK listings from gumtree.com: stuff for sale, cars and vans, property to rent and for sale, pets. Price, area, category, car and property details. No phones; private sellers stay anonymous. Unofficial Gumtree API.", "version": "0.1", "x-build-id": "LgzFmlpA8je8KA6ZU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~gumtree-uk-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-gumtree-uk-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/highbrow_fame~gumtree-uk-listings/runs": { "post": { "operationId": "runs-sync-highbrow_fame-gumtree-uk-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/highbrow_fame~gumtree-uk-listings/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-gumtree-uk-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Search links", "type": "array", "description": "Set up a search on gumtree.com — for sale, cars and motors, property or pets — with all the filters you want, and paste the address of the results page. One per line.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Or search here without a link: one search per line — e.g. \"sofa\", \"iphone 15\", \"golf gti\". The place and filters below apply.", "items": { "type": "string" } }, "location": { "title": "Place", "type": "string", "description": "Optional: a town, a city or an area (Leeds, Bristol, Kings Cross) for the keywords. Empty = the whole UK. With no keywords, the whole category in this place is listed." }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 1500, "type": "integer", "description": "Stops each search after this many listings. Gumtree shows up to 50 pages — about 1,400 listings — per search.", "default": 200 }, "category": { "title": "Category", "enum": [ "all", "for-sale", "motors", "cars", "motorbikes", "vans", "property-for-sale", "property-to-rent", "property-to-share", "pets" ], "type": "string", "description": "For the keywords and place above.", "default": "all" }, "minPrice": { "title": "Min price (GBP)", "minimum": 0, "type": "integer", "description": "Optional. For rent and rooms: per week, as Gumtree filters rents (£1,300 a month is £300 a week)." }, "maxPrice": { "title": "Max price (GBP)", "minimum": 0, "type": "integer", "description": "Optional. For rent and rooms: per week, as Gumtree filters rents." }, "distanceMiles": { "title": "Distance", "enum": [ "1", "3", "5", "10", "15", "30", "50", "75", "100" ], "type": "string", "description": "Optional: include this many miles around the place." }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "trade" ], "type": "string", "description": "Optional.", "default": "all" }, "sortBy": { "title": "Sort", "enum": [ "newest", "cheapest", "dearest" ], "type": "string", "description": "For the keywords and place above.", "default": "newest" }, "onlyNewListings": { "title": "Only new listings (feed mode)", "type": "boolean", "description": "Return only items not seen by your previous runs with the same search inputs. Seen keys are kept in a key-value store in your account (named feed--) for 60 days. The first run returns everything.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "When new items appear, POST a JSON summary {actor, newCount, sampleItems (max 5), datasetUrl, runId} to this URL. Works with Slack/Discord incoming webhooks (sends a `text` field too) and any HTTPS endpoint." }, "includeDetails": { "title": "Open every listing for its details", "type": "boolean", "description": "Adds the full description (the search only has its first 250 characters), every attribute, the posting and update dates, and the business name for dealers and agencies. One more page per listing, so slower.", "default": false }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to work on at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used only to try again after a network error: the first try goes out directly.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }