POST/eventimpact/

Get Event Impact

This API returns complete details of all events and their impact from the EVENTS database. Event Impact - Fetches the impact of a specific event on a given date on a scale of 0 to 100, based on multiple parameters of an event that have a corresponding impact within a specific geolocation.

In case the event you search for is not displayed in our database, please send a request to events@aggregateintelligence.in. We will try to make it available within the next 24 hours.

POST/eventimpact/

Important Notes

Search Criteria:

Any parameter (single or in combination).
If lat and lng are chosen, proximity is required.

Field Formats:

category
Type: string
Format: Can be a number, range, or a combination of both.
You can review the category codes in the reference method: /category/
subCategory
Type: string
Format: Can be a number, range, or a combination of both.
You can review the subcategory codes in the reference method: /subcategory/
Note: For a combination of both, refer to: /categorysubcategorygroup/
date
Format: "2021-10-02"
Change the date if the search is related to the date.
proximity
Type: string
Format: Should be numeric and in miles.
estimatedAttendee - Attendee count range or value.
Format:
- Range value - 100-500
- Min value - <500
- Max value - >500
- Exact value - 500
eventStatusCode
- 0 : All Events
- 1 : Scheduled
- 2 : Rescheduled
- 3 : Postponed
- 4 : Holiday Events
- 5 : Cancelled

Parameter Details

Name	In	Type	Required	Description
`eventsImpactPerPage`	query	`integer`	Optional	The number of items to display in a page
`pageNumber`	query	`integer`	Optional	Indicates the current page number
`body`	body		Required	none

Responses

Status	Meaning	Description	Schema
200	OK	OK
400	Bad Request	Bad Request	None
401	Unauthorized	Unauthorized	None
429	Too Many Requests	Too Many Requests	None
500	Internal Server Error	Internal Server Error	None

Example Request

# You can also use wget
curl -X POST /eventimpact/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Body parameter

{
  "eventId": 0,
  "eventName": "",
  "category": "0",
  "subCategory": "0",
  "startDate": "2025-05-06",
  "estimatedAttendee": "",
  "venue": "",
  "address": "",
  "city": "",
  "state": "",
  "zip": "",
  "country": "",
  "region": "",
  "lat": "",
  "lng": "",
  "proximity": 0,
  "horizon": 30,
  "impactEventType": "",
  "eventStatusCode": 1
}

Example responses

200 Response

{
  "pageInfo": {
    "totalRecords": 39652,
    "fetchedRecords": 1,
    "totalPages": 39652,
    "currentPage": 1,
    "pageSize": 1
  },
  "events": [
    {
      "id": 20439038,
      "eventId": 3456081,
      "venueId": 609634,
      "eventName": "Some Like it Hot",
      "category": "Entertainment events",
      "subCategory": "Theater",
      "description": "The meeting aims to provide educational topics, facilitate professional networking.",
      "startDate": "2025-04-10 00:00:00",
      "endDate": "2025-04-10 00:00:00",
      "estimatedAttendees": 574,
      "impactEventType": "Low",
      "venue": "William H. Mortensen Hall",
      "address": "166 Capitol Ave",
      "city": "Hartford",
      "state": "Connecticut",
      "zip": "06106",
      "country": "United States",
      "countryCode": "USA",
      "region": "North_America",
      "latitude": "41.7628413",
      "longitude": "-72.6806411",
      "impactScore": 25,
      "eventStatus": "Scheduled"
    }
  ]
}

Example 1,

{
  "eventId": 12,
  "eventName": "The Simon and Garfunkel Story",
  "category": "1-5",
  "subCategory": "7-10",
  "startDate": "2025-10-02",
  "estimatedAttendee": "100-500",
  "venue": "Wilson Center at Cape Fear Community College",
  "address": "703 N 3rd St",
  "city": "Barcelona",
  "state": "North Carolina",
  "zip": "28401",
  "country": "United States",
  "region": "North_America",
  "lat": "34.2435937",
  "lng": "-77.9472972",
  "proximity": 2,
  "horizon": 5,
  "impactEventType": "Very Low",
  "eventStatusCode": 5
}

Example 2

{
  "eventId": 12,
  "eventName": "The Simon and Garfunkel Story",
  "category": "2,4-5",
  "subCategory": "2,7,10-15",
  "startDate": "2026-04-02",
  "estimatedAttendee": "<1000",
  "venue": "Wilson Center at Cape Fear Community College",
  "address": "703 N 3rd St",
  "city": "Barcelona",
  "state": "North Carolina",
  "zip": "28401",
  "country": "United States",
  "region": "North_America",
  "lat": "34.2435937",
  "lng": "-7.9472972",
  "proximity": 1,
  "horizon": 5,
  "impactEventType": "High",
  "eventStatusCode": 3
}

PreviousGet Hotel Demand Data

NextCreate Shop Info