Placecast™ Profiles API

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