Skip to main content
Socialift
uzruen
Get a token
Documentation sections
Documentation

Socialift documentation

Socialift is an async Python SDK and web dashboard for the Instagram, Facebook, LinkedIn, TikTok, Telegram and Meta Marketing APIs. This is where you'll find installation and your first request, how to get developer app keys on each platform, errors and webhooks, plus the signature, description and example of every SDK method.

as of socialift 1.3.0 · Updated:

Installation

Python 3.11+. Install the extra for Telegram user accounts (MTProto).

terminal
pip install socialift

# For Telegram user accounts (MTProto)
pip install "socialift[telegram]"

export SOCIALIFT_LICENSE_KEY="slk_..."

Getting started

Installation, licence key and the web dashboard.

Get started with the Socialift SDKInstall the Socialift Python SDK, set your license key and make a first call: a Telegram bot in minutes, Facebook and Instagram via OAuth. For Python 3.11+.Authentication: license keys, seats and platform tokensHow the Socialift SDK license works: SOCIALIFT_LICENSE_KEY, Ed25519 checks, a 12-hour lease, 7-day offline grace, seats and SOCIALIFT_INSTANCE_ID in Docker.The Socialift dashboard: what each section doesA guide to the Socialift dashboard: license tokens, the 191-method Playground, connecting accounts, your own app keys, usage statistics and topping up billing.

Platform app keys

Create apps and get keys on Meta, Instagram, LinkedIn, TikTok and Telegram.

Setting up a Meta app for the Facebook and Instagram APIsSet up a Meta app for Facebook Pages, Instagram via Page, Lead Ads and the Marketing API: App ID, App Secret, config_id, redirect URI, webhooks and App Review.Setting up Instagram Login: Instagram app ID and secretInstagram API without a Facebook Page: where to find the Instagram app ID and secret, OAuth redirect URI, instagram_business_* permissions, webhooks and Socialift.Setting up a LinkedIn developer app for the APICreate a LinkedIn Developer Portal app: Company Page association, OpenID Connect and Share on LinkedIn products, redirect URLs, Client ID, secret and Socialift.Setting up a TikTok developer appCreate a TikTok for Developers app: Login Kit, Content Posting API (Direct Post), scopes, redirect URI rules, domain verification, sandbox, review and webhooks.Telegram setup: bot token and account api_id/api_hashTwo ways to connect Telegram: a BotFather bot token with privacy mode and webhooks, or a user account with api_id/api_hash from my.telegram.org. When to use which.

Core concepts

Errors, retries and receiving webhooks.

Error handling and automatic retriesSocialift SDK errors: how Meta, LinkedIn, TikTok and Telegram errors map to exception classes, what is retried automatically and how to configure RetryPolicy.Receiving webhooks with the SDKReceive Meta, TikTok and Telegram webhooks with socialift.webhooks: signature checks, event parsing, a FastAPI example, fast 200 responses and deduplication.

SDK reference

Every client and method: signature, description, permissions and example.

Facebook25 methodsfrom socialift import FacebookPython client for Facebook Graph API: Facebook Login, Page tokens, posts, stories, comments, webhook subscriptions and Lead Ads leads. Methods with examples.Instagram25 methodsfrom socialift import InstagramPython client for the Instagram Graph API: connect with Instagram Login or a Facebook Page, publish posts, carousels, stories, moderate comments, Direct, insights.LinkedIn10 methodsfrom socialift import LinkedInPython client for the LinkedIn API: OpenID Connect sign-in, token introspection and refresh, member profile and posting on a member's behalf. Methods with notes.TikTok26 methodsfrom socialift import TikTokEvery TikTok client method in the Socialift Python SDK: Login Kit OAuth, video and photo posting, post status and Business API comments, with signatures.Telegram bot76 methodsfrom socialift import TelegramBuild a Telegram bot in Python: send messages and media, set webhooks, moderate groups, manage invite links. 76 async SDK methods with Bot API limits explained.Telegram account90 methodsfrom socialift import TelegramAccountAsync Python SDK for Telegram user accounts over MTProto (Telethon): chat history, group members, stories, moderation and channels. 90 methods with examples.Meta Ads35 methodsfrom socialift import AdsPython reference for the Meta Marketing API client: campaigns, ad sets, ads, targeting, audiences and insights. Everything is created PAUSED. See all methods.

Frequently asked questions

Which programming language is the Socialift SDK for?

It's an async package for Python 3.11 and newer: pip install socialift. The dashboard Playground also shows cURL and JavaScript fetch snippets for each method, but the official SDK is Python only.

Which SDK version do these docs describe?

The method lists and signatures in the reference are generated straight from the SDK source, and each page shows the version. If a method is added without documentation, the test suite fails.

Can I try methods without writing code?

Yes. In the dashboard Playground you connect an account, call any method with a real request and inspect the response. Deletions and ad-budget actions ask for confirmation.

Do I need my own developer app keys?

If you run the SDK on your own server, yes — each platform needs your own app (a Telegram bot only needs a BotFather token). When connecting through the dashboard you can add your keys under “Kalitlar” (Keys) or, where available, use Socialift's shared app.