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

Get API postman collection.

🔑 Authentication

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

The 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

Query Parameters

Response

Sample response:

{
  "data": [
    {
      "created_at": "2022-05-02T03:40:15.000Z",
      "tweet_id": "1520971403813478111",
      "text": "@tdinh_me Love it 🔥",
      "username": "tdinh_me",
      "replied_to_username": "blackmagic_so",
      "replied_to_tweet_id": "152094884642322222",
      "like_count": 120,
      "retweet_count": 30,
      "reply_count": 10,
      "impression_count": 38412,
      "user_profile_clicks": 1351,
      "url_link_clicks": 412
    },
    // ...
	]
}

🧩 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

Response

Sample response:

{
    "data": [
        {
            "twitter_id": "331379561",
            "followers_count": 14531,
            "created_at": "2021-10-18T22:11:34.000Z"
        },
        {
            "twitter_id": "331379561",
            "followers_count": 14531,
            "created_at": "2021-10-18T22:26:35.000Z"
        },
        {
            "twitter_id": "331379561",
            "followers_count": 14531,
            "created_at": "2021-10-18T22:41:35.000Z"
        }
    ]
}

🧩 List Users

Return all members of your team.

Endpoint

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

URL Parameters

Response

Sample response:

{
    "data": [
        {
            "twitter_id": "331379561",
            "username": "tdinh_me",
            "name": "tdinh_me"
        },
        {
            "twitter_id": "1418194615010689027",
            "username": "blackmagic_so",
            "name": "blackmagic_so"
        },
        {
            "twitter_id": "1311458634254020608",
            "username": "devutils_app",
            "name": "devutils_app"
        }
    ]
}

Last Updated: 04 May 2022