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 MetricsEndpointURL ParametersQuery ParametersResponse🧩 Followers ChangeEndpointURL ParametersResponse🧩 List UsersEndpointURL ParametersResponse
📮 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