The Ion Data API provides Ion Core Data which encompasses comprehensive, behind-the-scenes audience data that is automatically gathered during a respondent’s interaction with an Ion experience. Data API allows our customers access to their audience’s global raw data, based on specified date ranges and delivers the requested data in a structured JSON format, ensuring easy integration with various applications. Below is the detailed documentation of Data API.

What data is accessible with the Ion Data API?


  • Respondent’s country location (with 99% accuracy)
  • Respondent’s city (with 70% accuracy BOSTON)
  • Respondent’s domain name (with 75% accuracy COMCAST.NET)
  • Respondent’s region/state (with 75% accuracy MASSACHUSETTS)

Portfolio, campaign and creative

  • Portfolio, Campaign, Creative  ID and Name to help aggregate data based on the level desired. 

Traffic source

  • Traffic SourceID
  • Traffic Source: The category selected when adding a traffic source, Email
  • Traffic Source Medium: The sub-category selected when adding a traffic source such as newsletter
  • Traffic Source URL: The URL the respondent clicked on to visit an Ion creative
  • TrafficSourceDescription: A description that can optionally be added when opening or editing a traffic source

Core engagement

  • Visitor’s first contact timestamp
  • Visitor’s last contact timestamp
  • If the Visitor converted and the converted timestamp
  • Tags Related Data with FirstEngagedTag, SecondEngagedTag, AllTagsClicked, TagsClickedCount, VisitCount
  • Declared Data provided on forms, quizzes, assessment, etc 

Other Information 

  • Visitor IP Address
  • Referrer URL: URL that referred the respondent to your traffic source URL
  • UserAgent: Client software originating the request
  • Respondent Grade (if enabled)
  • Sell Side (if enabled)

How can you use this API?

Seamless Integration

The API can integrate with existing systems, platforms, and applications. Users can easily incorporate the retrieved data into their preferred tools and workflows. For instance, CRM systems can leverage this data to enrich customer profiles and improve personalization.

Data is delivered in a structured JSON format, ensuring ease of integration with various applications. This standardized format simplifies the parsing and utilization of the data for developers and analysts.

Automated Data Retrieval

The API automates the data retrieval process, saving time and effort in collecting and organizing data manually. This automation enhances efficiency and enables timely and up-to-date data analysis.

Custom Reporting and Visualization

Analysts can use the API to retrieve data and create custom reports or dashboards tailored to specific organizational needs. This enables a more personalized and detailed view of the data for decision-making.

Granular Audience Insights for Targeted Marketing

Access to a broad range of audience data, including geolocation, engagement metrics, declared data, and more, allowing for a comprehensive understanding of user interactions and providing valuable audience segmentation information. 

Easy Aggregation and Analysis

Portfolio, campaign, and creative ID and name provided, aiding in easy aggregation and analysis of data at desired levels.

Content Strategy Refinement

Use tag-related data to identify popular topics and optimize content strategy, enabling organizations to align their content with audience preferences and interests. 

Share this: