# Chartbeat integrations: historical queries

> Submit a one-time query and submit a recurring query in Chartbeat. Connect Chartbeat to the rest of your data and analytics stack with Tray.ai.

**Canonical page:** https://tray.ai/connectors/chartbeat-integrations/
**Categories:** Data and analytics
**Connects through:** HTTP Connector

## Overview

Chartbeat is an audience analytics tool for publishers and newsrooms that tracks real-time and historical reader engagement with articles and video. Tray.ai connects to Chartbeat through the HTTP Connector, so your workflows can call the Chartbeat API alongside the rest of your stack.

## Use cases

### Historical queries

Read and create historical queries in Chartbeat from any Tray.ai workflow. The Chartbeat API covers calls such as submit a one-time query and check query status.

- Submit a one-time query
- Check query status
- Fetch query results

### Recurring queries

Read, create, and delete recurring queries in Chartbeat from any Tray.ai workflow. The Chartbeat API covers calls such as submit a recurring query and list recurring queries.

- Submit a recurring query
- List recurring queries
- Fetch recurring results

### Real-time traffic

Read real-time traffic in Chartbeat from any Tray.ai workflow. The Chartbeat API covers calls such as get top pages and get quick stats.

- Get top pages
- Get quick stats
- Get referrers

## Challenges Tray.ai solves

### Keeping Chartbeat credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store Chartbeat credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the Chartbeat API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the Chartbeat API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to Chartbeat?

Yes. Tray.ai connects to Chartbeat through the HTTP Connector, which calls the Chartbeat API directly. Any call the Chartbeat API documents can run as a step in a Tray.ai workflow.

### How does Tray.ai authenticate with Chartbeat?

The Chartbeat API uses an API key in a request header. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated Chartbeat connector?

Chartbeat runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Chartbeat connector from the Chartbeat API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/