Twitter sharing
Automatically post to Twitter when you rate something or marked as watched.
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! 😊
If you don't already have a Twitter Developer account, you need to set one up.
It only takes a few minutes.
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.
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:
https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api
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:
https://simkl.com/apps/twitter/authenticate-twitter
Under Website URL you can add a link to your own website or Twitter profile URL (do not use simkl.com as your website).
Then click Save.
You will now have a Client ID and a Client Secret.
Note these down (this is important!)
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!