Black Magic API (Beta)
🧩

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

notion image

🔑 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