{ "openapi": "3.0.1", "info": { "title": "Barnstormers Aircraft Classifieds Scraper", "description": "Scrape aircraft and aircraft-parts classified listings from barnstormers.com - search by keyword/make/model, browse by real site category, view recent listings, or pull all ads from one seller.", "version": "1.0", "x-build-id": "0lFDlcB1AeUmMkuKA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~barnstormers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-barnstormers-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~barnstormers-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-barnstormers-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~barnstormers-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-barnstormers-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", "browseCategory", "recentListings", "bySeller" ], "type": "string", "description": "What to fetch from Barnstormers.", "default": "search" }, "searchQuery": { "title": "Search query (keyword)", "type": "string", "description": "Free-text keyword search across headline, body, part number and model (mode=search). Example: \"Cessna 182\".", "default": "Cessna" }, "headline": { "title": "Headline contains", "type": "string", "description": "Narrow mode=search to listings whose title/headline contains this text." }, "manufacturer": { "title": "Manufacturer", "type": "string", "description": "Filter by aircraft manufacturer (e.g. Cessna, Piper, Beechcraft, Cirrus, Mooney, Piper). Matches listing title/description." }, "model": { "title": "Model", "type": "string", "description": "Filter by aircraft model designator (e.g. 182, R182, PA-28, SR22). Matches listing title/description." }, "partNumber": { "title": "Part number", "type": "string", "description": "Filter by an exact aircraft part number (mode=search). Useful for the parts/avionics categories, e.g. \"O-470-11\"." }, "descriptionContains": { "title": "Description contains", "type": "string", "description": "Narrow mode=search to listings whose ad body/description contains this text (distinct from the broader `searchQuery`, which also matches headline/model/part number)." }, "companyName": { "title": "Seller company name", "type": "string", "description": "Filter by the advertiser's company/business name as registered on Barnstormers (mode=search). Useful for finding all listings from a known dealer or parts house." }, "sellerFirstName": { "title": "Seller first name", "type": "string", "description": "Filter by the advertiser's first name (mode=search)." }, "sellerLastName": { "title": "Seller last name", "type": "string", "description": "Filter by the advertiser's last/family name (mode=search)." }, "wholePhraseMatch": { "title": "Match whole phrase", "type": "boolean", "description": "When true, `searchQuery` must match as an exact phrase instead of matching on individual words (mode=search).", "default": false }, "category": { "title": "Category", "enum": [ "", "15818", "15958", "16008", "16081", "16174", "16268", "16400", "24045", "16581", "16738", "23971", "16857", "16973", "16990", "17092", "17266", "17352", "17501", "17627", "17655", "17804", "17975", "17990", "18085", "18110", "18113", "18132", "18229", "18312", "18422", "18604", "24214", "18671", "19096", "19121", "19185", "24072", "19305", "19333", "19391", "19418", "19439", "19526", "19607", "19627", "19761", "19889", "19935", "20047", "20070", "20143", "20253", "20275", "24403", "20293", "20502", "20515", "20575", "20590", "20618", "20655", "20685", "20719", "20773", "20977", "21012", "21071", "21147", "21263", "21349", "23799", "21360", "21411", "21458", "21549", "21653", "24155", "21686", "21715", "23819", "21766", "21883", "22041", "22152", "22191", "22200", "22576", "22585", "22656", "23940", "22689", "22734", "22800", "22837", "24281", "22987", "23217", "23352", "23375", "23451" ], "type": "string", "description": "Restrict to one of Barnstormers own real listing categories (aircraft type, manufacturer section, parts, or service category). Required for mode=browseCategory.", "default": "" }, "state": { "title": "US State", "enum": [ "", "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "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" ], "type": "string", "description": "Restrict results to sellers located in this US state.", "default": "" }, "country": { "title": "Country contains", "type": "string", "description": "Restrict results to sellers located in a country whose name contains this text (e.g. \"Canada\", \"United Kingdom\", \"Philippines\"). Barnstormers skews heavily US/Canada but does list international sellers." }, "city": { "title": "City contains", "type": "string", "description": "Restrict results to sellers located in a city whose name contains this text." }, "priceMin": { "title": "Price (min, USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only include listings priced at or above this amount. Listings marked \"Make Offer\" or with no listed price always pass through." }, "priceMax": { "title": "Price (max, USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only include listings priced at or below this amount. Listings marked \"Make Offer\" or with no listed price always pass through." }, "yearMin": { "title": "Year (min)", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only include aircraft whose title states a manufacture year at or after this value. Listings without a parseable year always pass through." }, "yearMax": { "title": "Year (max)", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only include aircraft whose title states a manufacture year at or before this value. Listings without a parseable year always pass through." }, "sellerId": { "title": "Seller ID (mode=bySeller)", "minimum": 1, "maximum": 999999999, "type": "integer", "description": "Numeric Barnstormers seller/advertiser ID (found in any listing's \"Show all Ads posted by this Advertiser\" link, e.g. .../listing.php?userid=265709 -> 265709)." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on emitted records. Barnstormers' combined active inventory across all categories is several thousand listings deep, so this can safely go well above the default.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Barnstormers has no anti-bot protection, so this actor works with no proxy at all. The free AUTO datacenter group is supported if you want IP rotation.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }