Twitter sharing

Automatically post to Twitter when you rate something or marked as watched.

Set up a custom Twitter API Key with Simkl in a few simple steps

Since Twitter introduced a paid API with a "small plan" starting at $42,000 for Apps like Simkl if we were to use our own key. So the best way to share your watched shows and movies after you rate or mark them as watched through Simkl is by creating your own free personal API key. Don't worry, it allows up to 1,500 requests per month, so you can still share your favorites with friends! 😊

How to add your own Twitter API key

In order to use Twitter with Simkl you need to bring your own API Key. In this article, we'll go through how to set it up.

Create a Twitter Developer account

If you don't already have a Twitter Developer account, you need to set one up. It only takes a few minutes.
Go to this page and sign up for a free account:
Twitter will ask you to briefly describe the use case of Twitter's API. You can put something like this:
I will use Twitter's API to schedule and publish tweets, as well as replying to comments on my tweets. I will use data coming from Twitter's API to display analytics in regard to performance of my tweets, including impressions, engagement rate, link clicks, and similar metrics.
Click Submit. In most cases, you will get access to Twitter's Developer portal immediately.

Setting up an app + API Keys

If you click the "Twitter API v2" project, you should see that you are on a Free account. You will be able to publish up to 1500 tweets per month.
This covers watch history and review posting for most users.
If you watch and review more than 1500 episodes, and movies in a month, you will need to upgrade to their Basic plan, which cost $100/month.
You can read more about what's included in the different plans here:
Next, click the Projects & Apps menu. You will see that a default project and a default app has been created for you. This is all we need.
Under User authentication settings, click the Set up button.
Set up user authentication as follows:
Under App permissions choose Read and write.
Under Type of App choose Web App, Automated App or Bot.
Finally, under App info add this URL in Callback URI / Redirect URL:
Under Website URL you can add a link to your own website or Twitter profile URL (do not use as your website).
Then click Save.
You will now have a Client ID and a Client Secret. Note these down (this is important!)

Setting up Twitter with Simkl

Go to Simkl and click Settings > Sharing.
Click "Add Twitter API Key"
Insert the Client ID and the Client Secret here and click Connect a new Twitter profile
Twitter will now ask you to authorize your new app. And that's it!
Congratulations 🥳 You can now use Twitter with Simkl.