FoodTruckQC API
Read-only HTTPS GET endpoints with live Quad Cities food truck data. Only approved trucks are returned and no personal user data is exposed. All responses are JSON.
Authentication
Chat agent endpoints use the header x-api-key: YOUR_KEY (key issued by FoodTruckQC). Personal endpoints use Authorization: Bearer ftqc_… — create a key in your profile under Connected accounts → API keys. Missing or wrong keys return 401 {"error":"unauthorized"}.
Endpoints
GET /api/public/chat-search-trucks— trucks (x-api-key)GET /api/public/chat-upcoming-stops— upcoming stops, times in Central (x-api-key)GET /api/public/v1/trucks— trucks (Bearer ftqc_)GET /api/public/v1/stops— upcoming stops, times in UTC (Bearer ftqc_)GET /api/public/v1/favorites— the key owner's favorites (Bearer ftqc_)
Search parameters
Smart behavior is shared by the two chat endpoints and MCP search_trucks / upcoming_stops; combine filters freely. Personal endpoints retain their existing response fields.
| Parameter | Description |
|---|---|
| location | Smart city, typo, QC alias, address or landmark. Empty defaults to Quad Cities: 15 miles around Davenport (41.5236, -90.5776). Cities use 5 miles plus saved-city matches; addresses use 5 miles. Berendorf IA resolves to Bettendorf. State suffixes and downtown are ignored. |
| city / near / address / lat + lng | Backwards-compatible aliases for location. Precedence: location, city, near, address, then coordinate pair. QC, QCA, quad cities, around here and anywhere mean the whole region. |
| radius_miles | Override radius: 1–100 miles. Defaults: region 15; city/address 5. |
| cuisine | Cuisine plus synonyms: tacos/taqueria/Mexican, BBQ/barbecue/smoked, burgers, Asian, dessert and more. |
| dish / menu_item | Fuzzy, plural-insensitive published item names/descriptions; quesabirria matches Birria Tacos. Description fallback only without a menu. |
| query | Fuzzy truck name, cuisine, description and published menu; exact truck names first. |
| open_now | true = a real stop happening now; base locations never count as open. |
| when | now, today, tomorrow, this_week (through Sunday), or YYYY-MM-DD. Chicago time; search defaults today. |
| days | Upcoming window: 1–14 days, default 3; when overrides days. |
| truck_id | Only one truck (IDs may contain letters/numbers/hyphens). |
| limit | 1–50, default 10; count is the number returned, not total matches. |
Response
Both chat endpoints and MCP tools return resolved_location, filters, count, results, message and next_available. Each result has truck_id, name, cuisine, open_now, is_base_location, distance_miles, stop, base_address, matched_on, matched_items, menu_highlights and app_url. Stops use Central time. Legacy trucks, stops, current_or_next_stop and origin remain available.
{
"resolved_location": {
"input": "",
"type": "default",
"name": "Quad Cities",
"lat": 41.5236,
"lng": -90.5776,
"radius_miles": 15
},
"filters": {
"query": null,
"cuisine": null,
"dish": null,
"open_now": true,
"when": "today"
},
"count": 2,
"results": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.2,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq"
}
],
"message": "2 trucks open now within 15 mi of Quad Cities",
"next_available": null,
"origin": "Quad Cities",
"radius_miles": 15,
"trucks": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.2,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
}
],
"stops": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 1.2,
"is_base_location": false,
"open_now": true,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "mi-oaxaca-wekgq",
"truck_name": "MI Oaxaca",
"cuisine": "Mexican",
"distance_miles": 3.2,
"is_base_location": false,
"open_now": true,
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
]
}Verified example requests
Real responses captured October 17, 2026. Opening hours and results change over time; no menu or schedule is invented.
1. chat-search-trucks?open_now=true
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-search-trucks?open_now=true"HTTP 200 · 2 results
Real JSON response
{
"resolved_location": {
"input": "",
"type": "default",
"name": "Quad Cities",
"lat": 41.5236,
"lng": -90.5776,
"radius_miles": 15
},
"filters": {
"query": null,
"cuisine": null,
"dish": null,
"open_now": true,
"when": "today"
},
"count": 2,
"results": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.2,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq"
}
],
"message": "2 trucks open now within 15 mi of Quad Cities",
"next_available": null,
"origin": "Quad Cities",
"radius_miles": 15,
"trucks": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.2,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
}
],
"stops": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 1.2,
"is_base_location": false,
"open_now": true,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "mi-oaxaca-wekgq",
"truck_name": "MI Oaxaca",
"cuisine": "Mexican",
"distance_miles": 3.2,
"is_base_location": false,
"open_now": true,
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
]
}2. chat-search-trucks?location=Berendorf%20IA&open_now=true
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-search-trucks?location=Berendorf%20IA&open_now=true"HTTP 200 · 2 results
Real JSON response
{
"resolved_location": {
"input": "Berendorf IA",
"type": "city",
"name": "Bettendorf",
"lat": 41.525,
"lng": -90.5151,
"radius_miles": 5
},
"filters": {
"query": null,
"cuisine": null,
"dish": null,
"open_now": true,
"when": "today"
},
"count": 2,
"results": [
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.4,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq"
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 2.9,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
}
],
"message": "2 trucks open now in Bettendorf",
"next_available": null,
"origin": "Bettendorf",
"radius_miles": 5,
"trucks": [
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.4,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 2.9,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
}
],
"stops": [
{
"truck_id": "mi-oaxaca-wekgq",
"truck_name": "MI Oaxaca",
"cuisine": "Mexican",
"distance_miles": 1.4,
"is_base_location": false,
"open_now": true,
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 2.9,
"is_base_location": false,
"open_now": true,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
]
}3. chat-search-trucks?location=QC&cuisine=tacos&open_now=true
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-search-trucks?location=QC&cuisine=tacos&open_now=true"HTTP 200 · 1 results
Real JSON response
{
"resolved_location": {
"input": "QC",
"type": "region",
"name": "Quad Cities",
"lat": 41.5236,
"lng": -90.5776,
"radius_miles": 15
},
"filters": {
"query": null,
"cuisine": "tacos",
"dish": null,
"open_now": true,
"when": "today"
},
"count": 1,
"results": [
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [
"cuisine"
],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq"
}
],
"message": "1 tacos trucks open now within 15 mi of Quad Cities",
"next_available": null,
"origin": "Quad Cities",
"radius_miles": 15,
"trucks": [
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3.2,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [
"cuisine"
],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
}
],
"stops": [
{
"truck_id": "mi-oaxaca-wekgq",
"truck_name": "MI Oaxaca",
"cuisine": "Mexican",
"distance_miles": 3.2,
"is_base_location": false,
"open_now": true,
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
]
}4. chat-search-trucks?dish=birria%20tacos&when=today
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-search-trucks?dish=birria%20tacos&when=today"HTTP 200 · 0 results
Real JSON response
{
"resolved_location": {
"input": "",
"type": "default",
"name": "Quad Cities",
"lat": 41.5236,
"lng": -90.5776,
"radius_miles": 15
},
"filters": {
"query": null,
"cuisine": null,
"dish": "birria tacos",
"open_now": false,
"when": "today"
},
"count": 0,
"results": [],
"message": "No birria tacos trucks with matching locations for today within 15 mi of Quad Cities.",
"next_available": null,
"origin": "Quad Cities",
"radius_miles": 15,
"trucks": [],
"stops": []
}5. chat-upcoming-stops?location=Rock%20Island&days=7
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-upcoming-stops?location=Rock%20Island&days=7"HTTP 200 · 10 results
Real JSON response
{
"resolved_location": {
"input": "Rock Island",
"type": "city",
"name": "Rock Island",
"lat": 41.5095,
"lng": -90.5787,
"radius_miles": 5
},
"filters": {
"query": null,
"cuisine": null,
"dish": null,
"open_now": false,
"when": "7_days"
},
"count": 10,
"results": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 0.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq"
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": false,
"is_base_location": false,
"distance_miles": 0.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sun, Oct 18, 11:00 AM",
"ends_at": "Sun, Oct 18, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
},
{
"truck_id": "las-salsas-dona-mary-zqbe4",
"name": "Las Salsas Dona Mary",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": false,
"distance_miles": 3,
"stop": {
"venue": "Mercado on 5th",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/las-salsas-dona-mary-zqbe4"
},
{
"truck_id": "bragg-bbq-egpri",
"name": "Bragg BBQ",
"cuisine": "BBQ",
"open_now": false,
"is_base_location": false,
"distance_miles": 3.4,
"stop": {
"venue": "Mercado on 5th",
"address": "1630 5th Ave",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bragg-bbq-egpri"
},
{
"truck_id": "chick-n-dips-8uajs",
"name": "Chick N’Dips",
"cuisine": "Chicken",
"open_now": false,
"is_base_location": true,
"distance_miles": 0.7,
"stop": null,
"base_address": "421 W River Dr, Davenport, IA 52801",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/chick-n-dips-8uajs"
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.6,
"stop": null,
"base_address": "1218 N Brady St, Davenport, IA 52803",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bonbon-s-tacos-yp_1i"
},
{
"truck_id": "justin-s-tacos-5iq6k",
"name": "Justin’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 2,
"stop": null,
"base_address": "1817 38th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/justin-s-tacos-5iq6k"
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"open_now": false,
"is_base_location": true,
"distance_miles": 2,
"stop": null,
"base_address": "500 44th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/new-york-style-hot-dog-3lzvs"
},
{
"truck_id": "luna-kitchen-liggw",
"name": "Luna Kitchen",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.2,
"stop": null,
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/luna-kitchen-liggw"
}
],
"message": "10 trucks in Rock Island",
"next_available": null,
"origin": "Rock Island",
"radius_miles": 5,
"trucks": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 0.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "mi-oaxaca-wekgq",
"name": "MI Oaxaca",
"cuisine": "Mexican",
"open_now": true,
"is_base_location": false,
"distance_miles": 3,
"stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mi-oaxaca-wekgq",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": false,
"is_base_location": false,
"distance_miles": 0.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sun, Oct 18, 11:00 AM",
"ends_at": "Sun, Oct 18, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sun, Oct 18, 11:00 AM",
"ends_at": "Sun, Oct 18, 2:00 PM"
}
},
{
"truck_id": "las-salsas-dona-mary-zqbe4",
"name": "Las Salsas Dona Mary",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": false,
"distance_miles": 3,
"stop": {
"venue": "Mercado on 5th",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/las-salsas-dona-mary-zqbe4",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado on 5th",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
}
},
{
"truck_id": "bragg-bbq-egpri",
"name": "Bragg BBQ",
"cuisine": "BBQ",
"open_now": false,
"is_base_location": false,
"distance_miles": 3.4,
"stop": {
"venue": "Mercado on 5th",
"address": "1630 5th Ave",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bragg-bbq-egpri",
"city": "Moline",
"current_or_next_stop": {
"venue": "Mercado on 5th",
"address": "1630 5th Ave",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
}
},
{
"truck_id": "chick-n-dips-8uajs",
"name": "Chick N’Dips",
"cuisine": "Chicken",
"open_now": false,
"is_base_location": true,
"distance_miles": 0.7,
"stop": null,
"base_address": "421 W River Dr, Davenport, IA 52801",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/chick-n-dips-8uajs",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.6,
"stop": null,
"base_address": "1218 N Brady St, Davenport, IA 52803",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bonbon-s-tacos-yp_1i",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "justin-s-tacos-5iq6k",
"name": "Justin’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 2,
"stop": null,
"base_address": "1817 38th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/justin-s-tacos-5iq6k",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"open_now": false,
"is_base_location": true,
"distance_miles": 2,
"stop": null,
"base_address": "500 44th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/new-york-style-hot-dog-3lzvs",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "luna-kitchen-liggw",
"name": "Luna Kitchen",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.2,
"stop": null,
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/luna-kitchen-liggw",
"city": null,
"current_or_next_stop": null
}
],
"stops": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 0.6,
"is_base_location": false,
"open_now": true,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "mi-oaxaca-wekgq",
"truck_name": "MI Oaxaca",
"cuisine": "Mexican",
"distance_miles": 3,
"is_base_location": false,
"open_now": true,
"venue": "Mercado On Fifth",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 0.6,
"is_base_location": false,
"open_now": false,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sun, Oct 18, 11:00 AM",
"ends_at": "Sun, Oct 18, 2:00 PM"
},
{
"truck_id": "las-salsas-dona-mary-zqbe4",
"truck_name": "Las Salsas Dona Mary",
"cuisine": "Mexican",
"distance_miles": 3,
"is_base_location": false,
"open_now": false,
"venue": "Mercado on 5th",
"address": "423 12th St, Moline, IL 61265, USA",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
{
"truck_id": "bragg-bbq-egpri",
"truck_name": "Bragg BBQ",
"cuisine": "BBQ",
"distance_miles": 3.4,
"is_base_location": false,
"open_now": false,
"venue": "Mercado on 5th",
"address": "1630 5th Ave",
"city": "Moline",
"starts_at": "Tue, Oct 20, 5:00 PM",
"ends_at": "Tue, Oct 20, 7:00 PM"
},
{
"truck_id": "chick-n-dips-8uajs",
"truck_name": "Chick N’Dips",
"cuisine": "Chicken",
"distance_miles": 0.7,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "421 W River Dr, Davenport, IA 52801",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"truck_name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"distance_miles": 1.6,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "1218 N Brady St, Davenport, IA 52803",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "justin-s-tacos-5iq6k",
"truck_name": "Justin’s Tacos",
"cuisine": "Mexican",
"distance_miles": 2,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "1817 38th St, Rock Island, IL 61201",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"truck_name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"distance_miles": 2,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "500 44th St, Rock Island, IL 61201",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "luna-kitchen-liggw",
"truck_name": "Luna Kitchen",
"cuisine": "Other",
"distance_miles": 2.2,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": null,
"city": null,
"starts_at": null,
"ends_at": null
}
]
}6. chat-search-trucks?location=2nd%20St%20Davenport&radius_miles=3
curl -H "x-api-key: YOUR_KEY" "https://app.foodtruckqc.com/api/public/chat-search-trucks?location=2nd%20St%20Davenport&radius_miles=3"HTTP 200 · 6 results
Real JSON response
{
"resolved_location": {
"input": "2nd St Davenport",
"type": "address",
"name": "West 2nd Street, Davenport, Rockingham Township, Scott County, Iowa, 52802, United States",
"lat": 41.5212961,
"lng": -90.5920349,
"radius_miles": 3
},
"filters": {
"query": null,
"cuisine": null,
"dish": null,
"open_now": false,
"when": "today"
},
"count": 6,
"results": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk"
},
{
"truck_id": "chick-n-dips-8uajs",
"name": "Chick N’Dips",
"cuisine": "Chicken",
"open_now": false,
"is_base_location": true,
"distance_miles": 0.6,
"stop": null,
"base_address": "421 W River Dr, Davenport, IA 52801",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/chick-n-dips-8uajs"
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.2,
"stop": null,
"base_address": "1218 N Brady St, Davenport, IA 52803",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bonbon-s-tacos-yp_1i"
},
{
"truck_id": "luna-kitchen-liggw",
"name": "Luna Kitchen",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.4,
"stop": null,
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/luna-kitchen-liggw"
},
{
"truck_id": "mo-flava-hdsqo",
"name": "Mo Flava",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.7,
"stop": null,
"base_address": "3622 N Brady St, Davenport, IA 52806",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mo-flava-hdsqo"
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.9,
"stop": null,
"base_address": "500 44th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/new-york-style-hot-dog-3lzvs"
}
],
"message": "6 trucks within 3 mi of West 2nd Street, Davenport, Rockingham Township, Scott County, Iowa, 52802, United States",
"next_available": null,
"origin": "West 2nd Street, Davenport, Rockingham Township, Scott County, Iowa, 52802, United States",
"radius_miles": 3,
"trucks": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"name": "Toni's Smokin' Grill",
"cuisine": "Other",
"open_now": true,
"is_base_location": false,
"distance_miles": 1.6,
"stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/toni-s-smokin-grill-e8mrk",
"city": "Rock Island",
"current_or_next_stop": {
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
}
},
{
"truck_id": "chick-n-dips-8uajs",
"name": "Chick N’Dips",
"cuisine": "Chicken",
"open_now": false,
"is_base_location": true,
"distance_miles": 0.6,
"stop": null,
"base_address": "421 W River Dr, Davenport, IA 52801",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/chick-n-dips-8uajs",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.2,
"stop": null,
"base_address": "1218 N Brady St, Davenport, IA 52803",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/bonbon-s-tacos-yp_1i",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "luna-kitchen-liggw",
"name": "Luna Kitchen",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 1.4,
"stop": null,
"base_address": null,
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/luna-kitchen-liggw",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "mo-flava-hdsqo",
"name": "Mo Flava",
"cuisine": "Other",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.7,
"stop": null,
"base_address": "3622 N Brady St, Davenport, IA 52806",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/mo-flava-hdsqo",
"city": null,
"current_or_next_stop": null
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"open_now": false,
"is_base_location": true,
"distance_miles": 2.9,
"stop": null,
"base_address": "500 44th St, Rock Island, IL 61201",
"matched_on": [],
"matched_items": [],
"menu_highlights": [],
"app_url": "https://app.foodtruckqc.com/truck/new-york-style-hot-dog-3lzvs",
"city": null,
"current_or_next_stop": null
}
],
"stops": [
{
"truck_id": "toni-s-smokin-grill-e8mrk",
"truck_name": "Toni's Smokin' Grill",
"cuisine": "Other",
"distance_miles": 1.6,
"is_base_location": false,
"open_now": true,
"venue": "Bent River Brewing Company",
"address": "512 24th St, Rock Island, IL 61201, USA",
"city": "Rock Island",
"starts_at": "Sat, Oct 17, 11:00 AM",
"ends_at": "Sat, Oct 17, 2:00 PM"
},
{
"truck_id": "chick-n-dips-8uajs",
"truck_name": "Chick N’Dips",
"cuisine": "Chicken",
"distance_miles": 0.6,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "421 W River Dr, Davenport, IA 52801",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "bonbon-s-tacos-yp_1i",
"truck_name": "Bonbon’s Tacos",
"cuisine": "Mexican",
"distance_miles": 1.2,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "1218 N Brady St, Davenport, IA 52803",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "luna-kitchen-liggw",
"truck_name": "Luna Kitchen",
"cuisine": "Other",
"distance_miles": 1.4,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": null,
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "mo-flava-hdsqo",
"truck_name": "Mo Flava",
"cuisine": "Other",
"distance_miles": 2.7,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "3622 N Brady St, Davenport, IA 52806",
"city": null,
"starts_at": null,
"ends_at": null
},
{
"truck_id": "new-york-style-hot-dog-3lzvs",
"truck_name": "New York Style Hot Dog",
"cuisine": "Hot Dogs",
"distance_miles": 2.9,
"is_base_location": true,
"open_now": null,
"venue": null,
"address": "500 44th St, Rock Island, IL 61201",
"city": null,
"starts_at": null,
"ends_at": null
}
]
}Notes
- Fixed-location trucks without a scheduled stop appear with
is_base_location: trueand no hours. - Weekly/biweekly/monthly schedules expand into real Chicago-time stops. Duplicate announcements of the same outing are merged.
- An unresolved location returns HTTP 400 with error "location not found" and hint "try a city like Davenport or a nearby street".
- Restaurants and chains are excluded; Admin can change the food truck classification. Zero results include the next matching stop within 7 days when known.
- Results sort open now, soonest stop, then distance; an exact truck-name search takes priority.
- CORS is enabled on the chat agent endpoints. An MCP server is also available at
https://app.foodtruckqc.com/mcp(sign-in required).