{ "openapi": "3.0.1", "info": { "title": "Land.com Rural Land & Farm Scraper (US)", "description": "Scrapes rural land, farms, ranches and acreage for sale from Land.com, the largest US rural-property marketplace. Search any state and property type; returns price, full address, description and seller contact, with an optional detail pass for acreage and lot specs.", "version": "0.1", "x-build-id": "H7gjKIOhAyGNmTtKz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~land-com-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-land-com-properties-scraper", "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/scrapyx~land-com-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-land-com-properties-scraper", "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/scrapyx~land-com-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-land-com-properties-scraper", "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": { "queries": { "title": "Searches (state + property type)", "type": "array", "description": "One search per entry, each with its own SEARCH_SUMMARY row. 'state' is a full US state name (e.g. 'Texas', 'New Mexico') -- multi-word state slugs are unverified against Land.com's own URL grammar this session, see README. 'propertyType' defaults to 'all-land' if omitted; other verified values are 'cheap-land', 'undeveloped-land', 'farms', 'ranches', 'houses-with-land'. Example: [{\"state\": \"Texas\", \"propertyType\": \"ranches\"}, {\"state\": \"Montana\"}]", "default": [] }, "includePropertyDetails": { "title": "Fetch listing detail pages", "type": "boolean", "description": "Also fetch each listing's detail page for fields not present in search results (acreage, lot description, terrain, utilities, additional photos). Costs one extra request per listing. On by default because these fields are the main reason to use a rural-land actor over a generic listing scraper.", "default": true }, "maxItems": { "title": "Max properties per search", "minimum": 0, "type": "integer", "description": "Stop paginating a search after this many properties. Set to 0 for unlimited (still bounded by Max pages and Land.com's own hard ceiling of 20 pages / 500 listings per state+propertyType combination -- query more property types for the same state to reach more of a large state's inventory).", "default": 100 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Hard cap on pagination depth, independent of maxItems. Land.com clamps every (state, propertyType) search to 20 pages (500 listings) regardless of the true total -- confirmed live, pages past that re-serve page 20's content forever -- so this actor never pages past 20 even if set higher.", "default": 20 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Upper bound on requests in flight at once, across searches and detail fetches. Kept low by default -- this target is behind an active, IP-reputation-sensitive Akamai bot-mitigation gate (see README) with only 3 confirmed-working TLS profiles.", "default": 3 }, "minRequestInterval": { "title": "Minimum seconds between request starts", "minimum": 0, "type": "integer", "description": "Paces request starts (not held inside a concurrency slot) rather than raw concurrency. Recon evidence this session is that this target's Akamai gate degrades under request-burst velocity from one IP -- this is the honest speed control once the rate cap binds, extra maxConcurrency buys nothing.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Land.com is behind Akamai Bot Manager, which serves a disguised HTTP 200 'behavioral content' challenge. This session's recon found the block IP-reputation sensitive (a clean TLS-profile ladder degraded to fully blocked after sustained unpaced requests from one IP and did not recover on its own) -- Apify Residential proxy, which rotates exit IPs, is the default for cloud runs.", "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 } } } } } } } } } }