Skip to main content
The Data API lets you pull your brand’s views, placements, and creator stats into dashboards, spreadsheets, or a data warehouse. The numbers match your client hub. The API is read only.

​
Get a key

If you are a client admin, open the client portal and select Settings > Developers > Data API > Create key. You can also ask your EVO team to create one from your brand’s Client Hub tab in the EVO team workspace. Copy the key when it appears. You will see it only once. A key starts with evo_live_. You can revoke a key at any time and keep up to 10 active keys for your brand.

​
Make a request

The base URL is https://dialedapi.evomarketing.co/api/v1. Send your key as a Bearer token when your tool supports headers:
You can also send X-EVO-API-Key: YOUR_API_KEY. Use api_key in the URL only when a spreadsheet tool cannot send headers. Headers are safer because URLs can appear in browser history and logs.

​
Read a response

JSON responses contain data and meta. List responses for /posts and /creators also contain pagination. Numbers refresh with EVO’s daily sync. Allow time for new activity to appear.

​
Limits and errors

You can make 120 requests per minute per key. If you exceed that limit, the API returns HTTP 429 with a Retry-After header. Wait that many seconds before you retry. Errors use {"error":{"code":"invalid_parameter","message":"..."}}.

​
Next steps

Endpoints

Find filters, fields, and request examples.

Spreadsheets

Bring CSV data into Google Sheets, Looker Studio, or Excel.

Examples

Copy recipes for curl, Python, and JavaScript.