Help Desk/Black Magic API (Beta)
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
 
👋
We are a 99% self-service company. You can do almost everything things by yourself without contacting a human, including cancel and refund payments! Please check the FAQs below for more info.

FAQs

Account & Subscription

📅
Can I pay monthly instead of yearly?
🔃
How to switch from annual to monthly subscription (or vice versa)
🔼
How to upgrade/downgrade my subscription?
🆕
How to restart my free trial
💸
Can I get a refund?
👋
How to cancel your Black Magic subscription
💳
How to self-refund your BlackMagic.so subscription
How to delete your BlackMagic.so account
How to remove API access to your Twitter account

Black Magic Features

💊
How do I make the Magic Sidebar not overlap with Twitter UI?
📊
Why does Black Magic not show stats of my old tweets?
🏙️
Why does Black Magic not reflect my latest stats?
🛑
How to stop the banner/profile progress bar?
🔃
How to force update the engagement tracking
📅
Why my Scheduled Tasks in the sidebar failed?
📅
How to draft and schedule tweets with Black Magic
🗄️
How to import your tweets archive to Black Magic
🌘
How to use Black Magic's integration with Zapier
🔑
How to Re-authorize Twitter Permissions

Manage multiple Twitter accounts (Team)

🎛️
What is Black Magic for Business?
⛓️
How to access multiple accounts in Black Magic
👥
How to add multiple accounts to Black Magic with Team feature
👥
How to view analytics from multiple accounts for Team

Get Data from Black Magic

🔗
Is there an API to get data from Black Magic?
🧩
Black Magic API (Beta)
🔐
How to get the API key
🥋
How to export (CSV) Top Interactions
🌤️
How to export (CSV) tweet engagements of a specific tweet
💽
Data Exports & Sync

Mobile Apps

🔑
How to create login code
⤴️
How to use Black Magic Mobile app: Share Popup

Referral & Discount

🌱
Referral Program – BlackMagic.so
🌊
Influencers Discount
🏷️
How to apply discount code

Troubleshooting

🔍
How to collect debug information to investigate browser extension issues
 

Contact Us via Email

For feedback and feature suggestions: feedback@blackmagic.so
If you have questions or need help: support@blackmagic.so