Chicago Food Truck Finder

blogging the Chicago food truck scene

Chicago Food Truck Finder API

This page details the Chicago Food Truck Finder REST API, which you can use to build your own application off of the data in the Chicago Food Truck Finder. To get started, you will need an APP key which will allow my app to identify the app that makes those requests (email me to get one).

All services are accessed from the http://www.chicagofoodtruckfinder.com URL

Schedule

Get a schedule (locations + times + trucks) for a day

GET /services/daily_schedule

Parameters

Name Description
from (optional) gets the schedule from that point to the next day boundary
appKey the app key

Response

The response has four sections ‘date’, ‘locations’, ‘stops’, and ‘trucks’. They should be self-explanatory. However, please note that each stop has a reference to a location. The location number refers to the index in the location array (with an index starting at 1). Not sure why I coded it that way, but that’s just the way it is.

Keep in mind that this schedule is cached by up to 8 minutes.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
{
    "date": "20140125",
    "locations": [
        {
            "description": "",
            "id": 2,
            "key": 8260018,
            "latitude": 41.880421,
            "longitude": -87.650818,
            "name": "Sangamon and Monroe, Chicago, IL",
            "radius": 0,
            "url": ""
        },
        {
            "description": "",
            "id": 3,
            "key": 5101001,
            "latitude": 42.050568999999996,
            "longitude": -88.03541,
            "name": "1755 E Golf Road, Schaumburg, IL",
            "radius": 0,
            "url": ""
        },
        {
            "id": 4,
            "key": 14321014,
            "latitude": 41.58585,
            "longitude": -88.17424799999999,
            "name": "22921 W Lincoln Hwy, Plainfield, IL",
            "radius": 0
        },
        {
            "description": "",
            "id": 5,
            "key": 941053,
            "latitude": 42.051406,
            "longitude": -88.044547,
            "name": "Golf and Meacham, Schaumburg, IL",
            "radius": 0,
            "url": ""
        },
        {
            "description": "",
            "id": 6,
            "key": 1455281,
            "latitude": 41.609201999999996,
            "longitude": -88.20326399999999,
            "name": "Plainfield Library",
            "radius": 0,
            "url": ""
        },
        {
            "id": 7,
            "key": 10831037,
            "latitude": 41.60103,
            "longitude": -87.852853,
            "name": "15911 S. LaGrange Road, Orland Park, IL",
            "radius": 0
        },
        {
            "description": "",
            "id": 8,
            "key": 64006,
            "latitude": 41.865783,
            "longitude": -87.62413099999999,
            "name": "13th and Michigan, Chicago, IL",
            "radius": 0,
            "url": ""
        }
    ],
    "stops": [
        {
            "endMillis": 1390669200000,
            "endTime": "11:00 AM",
            "fromBeacon": false,
            "location": 1,
            "startMillis": 1390662000000,
            "startTime": "09:00 AM",
            "truckId": "eastmanegg"
        },
        {
            "endMillis": 1390680000000,
            "endTime": "02:00 PM",
            "fromBeacon": false,
            "location": 2,
            "startMillis": 1390669200000,
            "startTime": "11:00 AM",
            "truckId": "mytoastycheese"
        },
        {
            "endMillis": 1390701600000,
            "endTime": "08:00 PM",
            "fromBeacon": false,
            "location": 3,
            "startMillis": 1390669200000,
            "startTime": "11:00 AM",
            "truckId": "chicagosdawgs"
        },
        {
            "endMillis": 1390680000000,
            "endTime": "02:00 PM",
            "fromBeacon": false,
            "location": 4,
            "startMillis": 1390669200000,
            "startTime": "11:00 AM",
            "truckId": "giaviasweets"
        },
        {
            "endMillis": 1390676400000,
            "endTime": "01:00 PM",
            "fromBeacon": false,
            "location": 5,
            "startMillis": 1390672800000,
            "startTime": "12:00 PM",
            "truckId": "flirtycupcakes"
        },
        {
            "endMillis": 1390683600000,
            "endTime": "03:00 PM",
            "fromBeacon": false,
            "location": 6,
            "startMillis": 1390680000000,
            "startTime": "02:00 PM",
            "truckId": "flirtycupcakes"
        },
        {
            "endMillis": 1390692600000,
            "endTime": "05:30 PM",
            "fromBeacon": false,
            "location": 7,
            "startMillis": 1390689000000,
            "startTime": "04:30 PM",
            "truckId": "flirtycupcakes"
        }
    ],
    "trucks": [
        {
            "description": "",
            "facebook": "/eastmanegg",
            "facebookPageId": "497230390300804",
            "foursquare": "51b72dd0498e81a1504dd86c",
            "iconUrl": "http://pbs.twimg.com/profile_images/3650371313/e80111cbb5cc855dfdd7db942b485684_normal.jpeg",
            "id": "eastmanegg",
            "inactive": false,
            "name": "The Eastman Egg Co.",
            "twitterHandle": "eastmanegg",
            "url": "http://eastmanegg.com/",
            "yelp": ""
        },
        {
            "description": "<blockquote>Mobile Eatery serving the best damn Toasty Cheese, Fresh Cut Fries and Soups</blockquote>",
            "facebook": "/ToastyCheese",
            "facebookPageId": "510881955606690",
            "foursquare": "50bf9392e4b04bfd7cd83d1f",
            "iconUrl": "http://pbs.twimg.com/profile_images/2813225430/b7b81180e3f5cc550b0acf6f9562d02d_normal.png",
            "id": "mytoastycheese",
            "inactive": false,
            "name": "Toasty Cheese",
            "twitterHandle": "mytoastycheese",
            "url": "http://toastycheese.com",
            "yelp": "toasty-cheese-schaumburg"
        },
        {
            "description": "",
            "facebook": "/pages/Chicago-Dawgs/291365737650014",
            "facebookPageId": "291365737650014",
            "foursquare": "",
            "iconUrl": "http://pbs.twimg.com/profile_images/378800000511819997/98860d76e7518782e4ea53a97a8ff9bf_normal.jpeg",
            "id": "chicagosdawgs",
            "inactive": false,
            "name": "Chicago's Dawgs",
            "twitterHandle": "chicagosdawgs",
            "url": "",
            "yelp": ""
        },
        {
            "description": "<blockquote>Making the world a better place, one cupcake at a time.</blockquote>",
            "facebook": "/GiaViaSweets",
            "facebookPageId": "115162101896257",
            "foursquare": "4fc122c0e4b0c1dd09c4fb72",
            "iconUrl": "http://pbs.twimg.com/profile_images/1558342471/GiaVia_Sweets_normal.png",
            "id": "giaviasweets",
            "inactive": false,
            "name": "Gia Via Sweets",
            "twitterHandle": "giaviasweets",
            "url": "http://www.giaviasweets.com/",
            "yelp": "giavia-sweets-carol-stream"
        },
        {
            "description": "<blockquote>Visit us at our new Dessert Garage! 1030 W. Taylor. Stop by and hang out. Monday-Saturday, 9am-8pm and Sunday 12-5</blockquote>",
            "facebook": "/flirtycupcakes",
            "facebookPageId": "289449927022",
            "foursquare": "4b990b1cf964a520975d35e3",
            "iconUrl": "http://pbs.twimg.com/profile_images/720492263/small_logo_normal.jpg",
            "id": "flirtycupcakes",
            "inactive": false,
            "name": "Flirty Cupcakes",
            "twitterHandle": "flirtycupcakes",
            "url": "http://www.flirtycupcakes.com/",
            "yelp": "flirty-cupcakes-chicago"
        }
    ]
}

Truck List

Returns a collection of all the trucks. By default returns JSON, but if Accept header is text/csv (or if .csv is appended on the end of the URL) the data will be returned in CSV format.

GET /services/trucks

Response

Same as the ‘trucks’ section above, except this will contain an array of all the trucks.

Truck Information

GET /services/trucks/<truckId>

Response

200 – Returns the individual truck data

404 – Truck ID is not found

Geolocation

Returns the geocoded address.

GET /services/locations/<uri_encoded_string>

Response

1
2
3
4
5
6
7
8
9
{
    "description": "",
    "key": 51101,
    "latitude": 41.880731,
    "longitude": -87.630836,
    "name": "Clark and Monroe, Chicago, IL",
    "radius": 0,
    "url": ""
}

200 – success

404 – not found