See the documentation of Placecast™ Profiles for all details of the data provided by this API.
Endpoints
Placecast Report
measures/placecast/report
Allows a user to obtain a Motionworks Placecast™ Profile report for a specific place or places.
Type
POST
Request Parameters
- Required
place_id
- The numeric id of the place, presented as an array. Up to 2000 place ids can be provided in a single request. If more than one place_id is specified, the measurement data presented will represent the aggregate measurement of the places defined.
Responses
-
200 OK
: Successfully retrieved cohort -
404 Not Found
: the specified place_id does not exist
The response is a JSON object with multiple properties and arrays that match Placecast™ Profiles
Example Request
curl --location 'https://intermx-test.apigee.net/v1/measures/placecast/report' \
--header 'apikey: {YOUR API KEY HERE}' \
--header 'Content-Type: application/json' \
--data '{
"place_id": [
5682
]
}'
Example Response
Note that the measurement arrays are truncated in this example to the first items in the array for simplicity.
{
"places": [
{
"name": "John F Kennedy International Airport",
"id": "67ff2de13334487acdfa4971",
"place_id": 5682,
"street_address": "John F Kennedy International Airport",
"city": "Queens",
"state": "New York",
"zip": "11430",
"lat": 40.647488384220736,
"lng": -73.79033375280599,
"county_id": "36081",
"county_name": "Queens",
"cbsa_id": "35620",
"cbsa_name": "New York-Newark-Jersey City, NY-NJ-PA",
"cbsa_type": "cbsa_metro",
"dma_id": "501",
"dma_name": "New York, NY",
"type_id": 26,
"type": "Commercial Airport",
"audit_status": "Reviewed",
"modified_date": "2025-03-03",
"published_date": "2025-03-01",
"imputed": false,
"activities": 2127778,
"visits": 1693268,
"visit_observations": 294012,
"visits_avg_dwell": 184,
"visits_frequency_per_person": 1.45,
"visits_unique_persons": 1169734,
"visits_unique_long_trips": 506506,
"certified": true,
"percentile": 0.00015554255186371965,
"local_radius_visits_local": 960067,
"local_radius_visits_non_local": 733201,
"history": true
}
],
"place_count": 1,
"history_count": 1,
"vintage": "20250412_2_2",
"license": true,
"years": [
{
"year": "2025",
"weeks": 14,
"observations": 461915,
"visits": 1773494
}
],
"weeks": [
{
"week_start": "2025-03-31",
"week_num": "2025-W14",
"observations": 31522,
"visits": 1815383
}
],
"days": [
{
"day": "su",
"percent": 0.1646164883911659,
"visits": 278740,
"hours": [
0.0217036950882101,
0.01973523046171503,
0.02123196628643433,
0.026475470393609868,
0.03419716202975357,
0.04191201493287876,
0.04718421978963829,
0.049352374970120995,
0.04936816080605021,
0.04885890513656515,
0.04889959649100146,
0.04996070602075578,
0.051891408890266895,
0.05398116689199534,
0.05516861094938073,
0.05481921083431741,
0.0530880452834672,
0.050613650336084656,
0.04769428425680147,
0.0442911987987203,
0.040292971679851686,
0.03555116990328186,
0.029917876321382368,
0.02381090344771641
]
}
],
"dwell": [
{
"id": "persons_060_120min",
"description": "1 hour to 1 hour 59 minutes",
"percent": 0.23340796326849314,
"visits": 395222
}
],
"segments": [
{
"type": "consumer",
"category": "commuting and transportation",
"description": "Mode of transportation past 7 days (any purpose) Bus",
"id": "03009",
"percent": 0.113471700876648,
"index": 288,
"motionworks_segment_id": "e5ae87c4-ecac-483b-aa8d-f37f4dc5828a"
}
],
"dma": [
{
"id": "501",
"description": "New York, NY",
"weekly_visits": 1354333,
"daily_visits": 193476
}
],
"county": [
{
"id": "36081",
"description": "Queens, NY",
"weekly_visits": 524113,
"daily_visits": 74873
}
],
"postal_code": [
{
"id": "11430",
"description": "11430",
"weekly_visits": 76890,
"daily_visits": 10984
}
],
"state": [
{
"id": "36",
"description": "New York",
"weekly_visits": 1302138,
"daily_visits": 186020
}
]
}