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
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