Endpoint

POST /measures/placecast/report

Allows a user to obtain a Motionworks Placecast™ Profile report for a specific place or places.

Type

POST

Limitations

Rate Limit - A maximum of 10 requests per minute

The rate limit is evenly distributed — clients should avoid sending bursts of traffic within a short time window.
Maximum Size - Up to 20 placeIds per request may be added. Requests with more placeIds will return with an error (HTTP 400—Bad Request).

Caching Policy

The data in Placecast™ Profiles is updated once a month. Clients should implement caching strategies to avoid redundant requests.

Cache responses locally based on the placeId
Only refresh data after 30 days, or based on your own update schedules
Avoid requesting profiles that have already been retrieved unless you know the data has changed

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
        }
    ]  
}