{ "openapi": "3.0.1", "info": { "title": "RoamingHunger Food Truck & Catering Scraper", "description": "Scrape RoamingHunger.com's directory of 24,000+ food trucks, trailers, carts and caterers across the US, Canada and beyond. Browse by city, state/province, or cuisine, search by name, or look up vendors by slug. Get cuisine tags, menu highlights, ratings, images and booking URLs.", "version": "1.0", "x-build-id": "IXeKPfwdfatdIRmsb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~roaminghunger-food-truck-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-roaminghunger-food-truck-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~roaminghunger-food-truck-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-roaminghunger-food-truck-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~roaminghunger-food-truck-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-roaminghunger-food-truck-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": { "mode": { "title": "Mode", "enum": [ "byCity", "byState", "search", "byCuisine", "byVendorSlugs" ], "type": "string", "description": "Choose how to browse RoamingHunger's directory: by city, by US state/Canadian province, free-text vendor search, cuisine-only browse (all locations), or direct lookup of specific vendors by profile slug.", "default": "byCity" }, "citySlug": { "title": "City (mode=byCity)", "enum": [ "abilene-tx", "albuquerque-nm", "anchorage-ak", "ann-arbor-mi", "asheville-nc", "atlanta-ga", "austin-tx", "baltimore-md", "bangor-me", "baton-rouge-la", "bellingham-wa", "bend-or", "bentonville-ar", "billings-mt", "birmingham-al", "bismarck-nd", "bloomington-in", "boise-id", "boston-ma", "boulder-co", "bozeman-mt", "branson-mo", "buffalo-ny", "calgary-ab-canada", "cape-coral-fl", "cedar-rapids-ia", "champaign-il", "charleston-sc", "charleston-wv", "charlotte-nc", "charlottesville-va", "chattanooga-tn", "chicago-il", "cincinnati-oh", "cleveland-oh", "college-station-tx", "colorado-springs-co", "columbia-mo", "columbia-sc", "columbus-oh", "concord-nh", "corpus-christi-tx", "dallas-tx", "davenport-ia", "dayton-oh", "del-rio-tx", "denver-co", "des-moines-ia", "detroit-mi", "dubai-united-arab-emirates", "dublin-ireland", "edmonton-ab-canada", "el-paso-tx", "eugene-or", "evansville-in", "fargo-nd", "fayetteville-ar", "flagstaff-az", "fort-collins-co", "fort-myers-fl", "fort-wayne-in", "fresno-ca", "grand-junction-co", "grand-rapids-mi", "greensboro-nc", "greenville-sc", "halifax-ns-canada", "hamilton-on-canada", "harrisburg-pa", "hartford-ct", "holdrege-ne", "hong-kong-china", "honolulu-hi", "houston-tx", "huntsville-al", "indianapolis-in", "iowa-city-ia", "jackson-ms", "jacksonville-fl", "jersey-city-nj", "kansas-city-mo", "kauai-hi", "kelowna-bc-canada", "knoxville-tn", "lancaster-pa", "las-vegas-nv", "lexington-ky", "lincoln-ne", "little-rock-ar", "london-united-kingdom", "los-angeles-ca", "louisville-ky", "lubbock-tx", "lynchburg-va", "madison-wi", "maui-hi", "medford-or", "memphis-tn", "miami-fl", "midland-tx", "milwaukee-wi", "minneapolis-mn", "missoula-mt", "mobile-al", "montgomery-al", "montreal-qc-canada", "naples-fl", "nashville-tn", "new-haven-ct", "new-orleans-la", "new-york-ny", "niagara-falls-ny", "norwalk-ct", "oklahoma-city-ok", "omaha-ne", "orange-county-ca", "orlando-fl", "ottawa-on-canada", "palm-springs-ca", "panama-city-fl", "pensacola-fl", "philadelphia-pa", "phoenix-az", "pittsburgh-pa", "portland-me", "portland-or", "providence-ri", "provo-ut", "raleigh-durham-nc", "regina-sk-canada", "reno-nv", "richland-wa", "richmond-va", "riverside-ca", "rochester-ny", "rome-ny", "sacramento-ca", "salem-or", "salina-ks", "salt-lake-city-ut", "san-antonio-tx", "san-diego-ca", "san-francisco-ca", "san-jose-ca", "san-juan-pr", "santa-barbara-ca", "santa-fe-nm", "sarasota-fl", "saskatoon-sk-canada", "seattle-wa", "shreveport-la", "sioux-falls-sd", "spokane-wa", "springfield-mo", "st-george-ut", "st-louis-mo", "syracuse-ny", "tallahassee-fl", "tampa-fl", "thunder-bay-on-canada", "toledo-oh", "topeka-ks", "toronto-on-canada", "traverse-city-mi", "tucson-az", "tulsa-ok", "tuscaloosa-al", "vancouver-bc-canada", "victoria-bc-canada", "virginia-beach-va", "washington-dc", "west-palm-beach-fl", "whitefish-mt", "whitehorse-yt-canada", "wichita-falls-tx", "wichita-ks", "wilmington-de", "wilmington-nc", "winnipeg-mb-canada", "york-pa" ], "type": "string", "description": "Market city to browse food trucks/caterers in. Required for mode=byCity.", "default": "austin-tx" }, "state": { "title": "State / Province (mode=byState)", "enum": [ "alabama", "alaska", "alberta-canada", "arizona", "arkansas", "british-columbia-canada", "california", "colorado", "connecticut", "delaware", "district-of-columbia", "florida", "georgia", "hawaii", "idaho", "illinois", "indiana", "iowa", "kansas", "kentucky", "louisiana", "maine", "manitoba-canada", "maryland", "massachusetts", "michigan", "minnesota", "mississippi", "missouri", "montana", "nebraska", "nevada", "new-brunswick-canada", "new-hampshire", "new-jersey", "new-mexico", "new-york", "newfoundland-and-labrador-canada", "north-carolina", "north-dakota", "nova-scotia-canada", "ohio", "oklahoma", "ontario-canada", "oregon", "pennsylvania", "puerto-rico", "quebec-canada", "rhode-island", "saskatchewan-canada", "south-carolina", "south-dakota", "tennessee", "texas", "utah", "vermont", "virginia", "washington", "west-virginia", "wisconsin", "wyoming", "yukon-canada" ], "type": "string", "description": "US state or Canadian province to browse food trucks/caterers in. Required for mode=byState.", "default": "texas" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword to search vendor names/descriptions (e.g. \"taco\", \"BBQ\", \"Kona Ice\"). Required for mode=search.", "default": "taco" }, "vendorSlugs": { "title": "Vendor profile slugs (mode=byVendorSlugs)", "type": "array", "description": "Exact RoamingHunger profile slugs to fetch directly, e.g. \"bohemian-burger-q\" from https://roaminghunger.com/bohemian-burger-q/. Required for mode=byVendorSlugs.", "default": [ "bohemian-burger-q" ], "items": { "type": "string" } }, "cuisineTag": { "title": "Cuisine / specialty filter", "enum": [ "acai", "afghan", "african", "alcohol", "american-classics", "argentinian", "asian", "asian-fusion", "bbq", "bacon", "bagels", "belgian", "beverages", "boba", "bowls", "brazilian", "breakfast", "brunch", "burgers", "burritos", "cajun", "cakes", "california-cuisine", "candy", "caribbean", "carnival-food", "cheesesteaks", "chicken-and-waffles", "chili", "chinese", "churros", "coffee", "colombian", "comfort-food", "cookies", "corn", "corn-dogs", "country-french", "craft-services", "creole", "crepes", "cuban", "cupcakes", "curry", "custom-catering", "czech", "dessert", "donuts", "dumplings", "east-coast", "eastern-european", "eclectic", "eggrolls", "empanadas", "ethiopian", "falafel", "farm-to-table", "filipino", "fish-and-chips", "flatbread", "fondue", "french", "fried-chicken", "fries", "frozen-treats", "frozen-yogurt", "fruit", "funnel-cakes", "gastropub", "gelato", "german", "gluten-free-friendly", "greek", "grilled-cheese", "guatemalan", "halal", "hawaiian", "healthy-food", "hot-dogs", "hungarian", "ice-cream", "ice-cream-sandwiches", "ice-pops", "indian", "indonesian", "irish", "italian", "italian-ice", "jamaican", "japanese", "juice", "kebabs", "kenyan", "korean", "korean-bbq", "kosher", "latin-fusion", "lobster-rolls", "locally-sourced", "mac-n-cheese", "malaysian", "meatballs", "mediterranean", "mexican", "middle-eastern", "native-american", "noodles", "nuts", "organic", "pakistani", "paleo", "paninis", "pasta", "pastries", "peruvian", "pies", "pizza", "poke", "polish", "popcorn", "portuguese", "poutine", "puerto-rican", "ramen", "rotisserie", "salads", "salvadoran", "sandwiches", "sausages", "savory", "scandinavian", "seafood", "shaved-ice", "singaporean", "sliders", "smoothies", "snacks", "soda", "somalian", "soul-food", "soup", "southern", "southwestern", "spanish", "stationary", "surf-and-turf", "sushi", "sweet", "tacos", "taiwanese", "tater-tots", "tea", "tex-mex", "thai", "tibetan", "turkish", "vegan", "vegetarian", "venezuelan", "vietnamese", "waffles", "wings", "world-fare", "wraps" ], "type": "string", "description": "Restrict results to a single cuisine or specialty tag. Required for mode=byCuisine; optional filter for byCity/byState/search." }, "eventType": { "title": "Event type filter", "enum": [ "corporate-catering", "custom-menus", "family-events", "fancy-affairs", "fundraisers", "huge-events", "indoor-events", "on-set-catering", "smaller-spaces", "vegans-vegetarians", "vegetarians", "weddings" ], "type": "string", "description": "Only include vendors RoamingHunger tags as suited for this event type (optional, all modes)." }, "sortBy": { "title": "Sort order", "enum": [ "ranking", "newest", "name", "level", "rating", "mostReviewed", "mostBooked" ], "type": "string", "description": "How to order results before maxItems is applied.", "default": "ranking" }, "verifiedOnly": { "title": "Verified vendors only", "type": "boolean", "description": "Only include vendors RoamingHunger has manually verified.", "default": false }, "instantBookOnly": { "title": "Instant-book vendors only", "type": "boolean", "description": "Only include vendors that support instant online booking.", "default": false }, "includeClosedVendors": { "title": "Include permanently closed vendors", "type": "boolean", "description": "By default, permanently closed food trucks are excluded. Enable to include them anyway (useful for historical market research).", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of vendor records to return.", "default": 30 } } }, "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 } } } } } } } } } }