Black Magic API (Beta)

⚠️

Note: Black Magic API is only available for accounts with Business Plan.

All API endpoints are in Beta and subjected to changes. You’ll be notified via your team admin’s email address when incompatible changes are introduced.

📮 Postman Collection 🔑 Authentication 🧩 Tweets Metrics Endpoint URL Parameters Query Parameters Response 🧩 Followers Change Endpoint URL Parameters Response 🧩 List Users Endpoint URL Parameters Response

📮 Postman Collection

Get API postman collection.

🔑 Authentication

All requests must be authenticated with a API key. Your API key. You find or create an API key for your team in Black Magic Dashboard.

API key can be provided via 2 methods:

Use x-api-key header.

Use key in query parameter (i.e. ?key=... in the URL)

🧩 Tweets Metrics

Returns tweet metrics for all managed accounts in a team.

Endpoint

https://api.blackmagic.so/data/teams/{TEAM_ID}/tweets?key={API_KEY}&format=json

URL Parameters

{TEAM_ID}

Your team ID. You can find your team ID in Black Magic Dashboard.

Query Parameters

Field	Required?	Description
`key`	Yes	Your API key. You find or create an API key for your team in Black Magic Dashboard.
`format`	No	Must be `json` or `csv`

Response

Sample response:

🧩 Followers Change

Return followers count by time for one specific user.

Endpoint

https://api.blackmagic.so/data/teams/{TEAM_ID}/users/{USER_ID}/followers_change

URL Parameters

`{TEAM_ID}`	Your team ID. You can find your team ID in Black Magic Dashboard.
`{USER_ID}`	Twitter User ID. You can get Twitter User ID from the List Users API.

Response

Sample response:

🧩 List Users

Return all members of your team.

Endpoint

https://api.blackmagic.so/data/teams/{{TEAM_ID}}/users

URL Parameters

{TEAM_ID}

Your team ID. You can find your team ID in Black Magic Dashboard.

Response

Sample response:

Last Updated: 04 May 2022