{ "openapi": "3.0.1", "info": { "title": "LocalHarvest Scraper - Farms, Farmers Markets & CSAs", "description": "Scrape LocalHarvest.org: farms, farmers markets, CSAs, U-Pick, and farm stands. Search by location and type, or fetch listings by URL. Get addresses, coordinates, products, contact info, and ratings.", "version": "1.0", "x-build-id": "1uKk3hSKEFD6ng4hW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~localharvest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-localharvest-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/crawlerbros~localharvest-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-localharvest-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/crawlerbros~localharvest-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-localharvest-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "What to fetch: search by location/type/keyword, or fetch full listing profiles from direct LocalHarvest listing URLs.", "default": "search" }, "location": { "title": "Location", "type": "string", "description": "Where to search: a US zip code (e.g. '50010'), a city and state (e.g. 'Austin, TX'), or a full state name (e.g. 'California'). Overridden by 'US state' below when that is set (mode=search).", "default": "California" }, "state": { "title": "US state (overrides Location above)", "enum": [ "", "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "District of Columbia" ], "type": "string", "description": "Pick a US state to search statewide instead of typing a location. Takes priority over 'Location' when set (mode=search).", "default": "" }, "listingType": { "title": "Listing type", "enum": [ "all", "farms", "farmersMarkets", "csa", "upick", "farmStands", "wholesale", "restaurants", "groceries", "others" ], "type": "string", "description": "Which kind of local-food listing to search for (mode=search).", "default": "farms" }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text keyword to search for, e.g. a product ('honey', 'organic strawberries'), farm name, or practice ('grass-fed'). Combined with location and listing type when set (mode=search)." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only return listings rated at least this many stars, 1-5 (mode=search). 0 means no minimum. Applied client-side; listings with no reviews yet are excluded once this is set above 0.", "default": 0 }, "snapEbtOnly": { "title": "SNAP/EBT accepted only", "type": "boolean", "description": "Only return listings that display LocalHarvest's SNAP/EBT-accepted badge (mode=search).", "default": false }, "organicOnly": { "title": "Certified Organic only", "type": "boolean", "description": "Only return listings that display LocalHarvest's Certified Organic badge (mode=search).", "default": false }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "rating", "name" ], "type": "string", "description": "How to order search results after fetching (mode=search). LocalHarvest itself returns results ordered by distance/relevance; 'rating' and 'name' are applied client-side across the fetched batch.", "default": "relevance" }, "fetchDetails": { "title": "Fetch full listing profiles", "type": "boolean", "description": "For each search result, also visit its listing profile page to collect phone, website, social links, full description, products/crops, farming practices, associations, and market channel details (CSA share info, market schedule). Slower -- one extra request per result (mode=search).", "default": false }, "listingUrls": { "title": "Listing profile URLs (mode=byUrl)", "type": "array", "description": "Direct LocalHarvest listing URLs to fetch, e.g. https://www.localharvest.org/blue-gate-farm-M11943. Use the 'sourceUrl' field from search results.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "LocalHarvest listing profile URL." } } }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on the number of listing records to return.", "default": 20 } } }, "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 } } } } } } } } } }