Getting Started with our Conversion API
Get familiar with our Conversion API to fetch the top articles that drove a given event.
This section contains information on how to make requests to Chartbeat’s Top Converting Articles API endpoint, allowing you to fetch the top articles that drove a given event (e.g. subscriptions) for a specific time range. Counts are assigned per attributed path.
For example, you can ask, "What were my top 10 articles over the last 3 hours that drove subscriptions?"
The Top Converting Articles API only provides Last Touch attribution for event categories that include a
Shownevent. For categories that do not include a
Shownevent, all conversions have a null attribution path; this means that you will see a count of total conversions for the selected event category, where conversions includes the total number of
Completeevents for the event category specified.
To query for all events received on May 11, 2023 from 20:00:00 to 22:59:59 (i.e. not including events received at 23:00:00 or later), you would set
To query data for a single day, you would set