{
  "openapi": "3.0.1",
  "info": {
    "title": "Gumtree $1.75💰 [AUS-UK-NZ-SA] Search By URL or Keywords",
    "description": "💰$1.75 per 1,000 results, extract detailed listings including pricing history, seller info, vehicle specs (VIN, mileage, condition), electronics details, and furniture dimensions. Get rich media (images, videos), location data, and competitor analysis.",
    "version": "0.0",
    "x-build-id": "zvTMXY5deloT6J127"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~gumtree-cheerio/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-gumtree-cheerio",
        "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/memo23~gumtree-cheerio/runs": {
      "post": {
        "operationId": "runs-sync-memo23-gumtree-cheerio",
        "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/memo23~gumtree-cheerio/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-gumtree-cheerio",
        "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": {
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Power-user mode: exact URLs. Leave empty (or omit) if you use **Search by filters** instead. **If you fill both this and filters, only these URLs are used.**",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "includeListingDetails": {
            "title": "Include listing details",
            "type": "boolean",
            "description": "Whether to include listing details in the output.",
            "default": true
          },
          "includePhoneDetails": {
            "title": "Include phone details",
            "type": "boolean",
            "description": "Whether to include phone details in the output.",
            "default": false
          },
          "monitoringMode": {
            "title": "Run in monitoring mode where only newly listings compared to previous runs will be scraped",
            "type": "boolean",
            "description": "If checked, it will only scrape newly listings compared to what has been scraped in previous runs.",
            "default": false
          },
          "listingStartDate": {
            "title": "Only scrape listings newer than [date]",
            "type": "string",
            "description": "Format should be YYYY-MM-DD, e.g., 2025-02-20"
          },
          "gumtreeSearchRegion": {
            "title": "Gumtree site / region",
            "enum": [
              "UK",
              "AU",
              "NZ",
              "ZA"
            ],
            "type": "string",
            "description": "Which Gumtree site to search. Leave empty if you only use **Start URLs**."
          },
          "gumtreeSearchKeyword": {
            "title": "Search keyword",
            "type": "string",
            "description": "Optional search text."
          },
          "gumtreeSearchLocation": {
            "title": "Location",
            "type": "string",
            "description": "UK: free-text (e.g. Edinburgh). AU/NZ/ZA: optional; AU/NZ still need Category ID + Location ID."
          },
          "gumtreeSearchCategorySlug": {
            "title": "Category slug",
            "type": "string",
            "description": "UK: search_category (e.g. all, property-to-rent). ZA: segment without `s-` (e.g. houses-flats-for-sale)."
          },
          "gumtreeSearchLocationSlug": {
            "title": "Location slug (South Africa only)",
            "type": "string",
            "description": "ZA: middle path segment (e.g. pretoria-tshwane)."
          },
          "gumtreeSearchSort": {
            "title": "Sort order",
            "enum": [
              "most_recent",
              "best_match",
              "nearest"
            ],
            "type": "string",
            "description": "Mapped per site (AU/NZ: sort=date|rank in query where supported).",
            "default": "most_recent"
          },
          "gumtreeSearchCategoryId": {
            "title": "Category ID (AU/NZ/ZA) — e.g. 18320 from …/c18320l3008303… or ZA 9074 from …v1c9074l3100094…",
            "type": "string",
            "description": "<p><strong>Required for Australia &amp; New Zealand</strong> filter mode (with Location ID). Copy the number after <code>c</code> in the path segment that looks like <code>c18320l3008303</code>.</p><p><strong>Examples:</strong> AU cars search <code>…/s-cars-vans-utes/perth/c18320l3008303</code> → category <strong>18320</strong>. ZA <code>…/v1c9074l3100094p1</code> → category <strong>9074</strong>.</p><p>Not used for UK (UK uses category slug + free-text location instead).</p>"
          },
          "gumtreeSearchLocationId": {
            "title": "Location ID (AU/NZ/ZA) — e.g. 3008303 from …/c18320l3008303… or ZA 3100094 from …l3100094…",
            "type": "string",
            "description": "<p><strong>Required for Australia &amp; New Zealand</strong> filter mode (with Category ID). Copy the number after <code>l</code> in the same segment (before any <code>?</code>).</p><p><strong>Examples:</strong> <code>…/c18320l3008303</code> → location <strong>3008303</strong>. ZA <code>…v1c9074l3100094p1</code> → location <strong>3100094</strong>.</p><p>Open any real search on gumtree.com.au / gumtree.co.nz / gumtree.co.za and paste the IDs from the address bar.</p>"
          },
          "maxItems": {
            "title": "Max items per start URL",
            "type": "integer",
            "description": "Maximum listings to collect for each search start URL. If you add several search URLs, each can yield up to this many items (subject to pay-per-result and charge limits).",
            "default": 10000
          },
          "maxConcurrency": {
            "title": "Max Concurrency",
            "type": "integer",
            "description": "Maximum number of pages that can be processed at the same time.",
            "default": 30
          },
          "minConcurrency": {
            "title": "Min Concurrency",
            "type": "integer",
            "description": "Minimum number of pages that will be processed at the same time.",
            "default": 1
          },
          "maxRequestRetries": {
            "title": "Max Request Retries",
            "type": "integer",
            "description": "Number of times the crawler will retry a failed request before giving up.",
            "default": 30
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.<br><br>For details, see <a href='https://apify.com/apify/web-scraper#proxy-configuration' target='_blank' rel='noopener'>Proxy configuration</a> in README.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}