Social platform API
Five platforms. One simple API.
Connect Instagram, Facebook, LinkedIn, TikTok, Telegram and Meta ads to your product.
Social platforms
- TikTok
- Telegram
Your side
- platforms
- 5
- SDK methods
- 287
- client classes
- 7
- days free
- 30
Social media APIs — in one place, made simple
OAuth, content, Instagram Direct, Telegram, ads, Lead Ads and webhooks. We absorbed dozens of undocumented Meta, LinkedIn, TikTok and Telegram details so you can just write code.
import asyncio
from socialift import Facebook
async def main(code: str):
# FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, SOCIALIFT_LICENSE_KEY
async with Facebook.from_env() as fb:
token = await fb.exchange_code(code, redirect_uri="https://you.com/cb")
for page in await fb.pages(token.access_token):
print(page.name, "→ instagram:", page.instagram_username)
asyncio.run(main(code="...")) # ?code= from the OAuth callbackpython quickstart.pySocialift Demo → instagram: socialift.uz
Mahsulot sahifasi → instagram: None
When no Instagram account is linked to the Page, instagram_username is None. Your code checks for it, not the SDK.
What does Socialift do?
Socialift is an async Python SDK plus a web dashboard for the Instagram, Facebook, LinkedIn, TikTok and Telegram APIs and the Meta Marketing API. It covers connections and OAuth, posts, stories and comments, Instagram Direct conversations, Telegram groups and channels, ads and targeting, Lead Ads forms and leads, and webhook signature verification under one interface. Socialift is not a CRM — it is the integration layer between a CRM and social networks.
Why Socialift
We normalise the behaviour each platform never wrote down.
Connections across five platforms
OAuth for Instagram, Facebook, LinkedIn and TikTok; a code or bot token on Telegram. Tokens are encrypted, errors share one model.
Instagram Direct
Conversations with the full profile: name, followers, whether they follow the business — not just an ID.
Stories on three platforms
Instagram and Facebook Page stories, plus 6-to-48-hour ones from a Telegram account. The SDK checks the conditions up front.
TikTok publishing
Video, photo carousels and drafts. The SDK catches TikTok errors hidden inside HTTP 200 responses.
Telegram groups and bots
Create groups and channels, manage members, invite links, scheduled messages; webhooks for bots.
Ads and targeting
Meta Marketing API: targeting search, reach estimates without spending, campaigns and audiences.
Lead Ads → CRM
From the
leadgenwebhook to the lead itself: the event, the lead and normalised fields.Webhooks
Signature checks for Meta, TikTok and Telegram, event parsing, dedupe keys and automatic retries.
Insights and demographics
Instagram and TikTok insights, demographics, Meta ads and Telegram channel statistics.
API Playground
191 methods in the dashboard: docs, a form, a live request and ready-made code.
Live in three steps
Sign in with Google
Create an account in one click — no password, and secure.
Get your token
Press “Yangi token” (New token) in the dashboard. The first month is free.
Drop it into the SDK or try it
pip install socialift, add the key — done. Before writing code you can try methods in the dashboard Playground.
Capability matrix
The table reflects what the platforms' public APIs allow.
| Capability | TikTok | Telegram | |||
|---|---|---|---|---|---|
| Connection — OAuth; code or bot token on Telegram | yes | yes | yes | yes | yes |
| Profile data | yes | yes | yes | yes | yes |
| Posts — read and publish | yes | yes | yes | yes | yes |
| Stories — 24 hours | yes | yes | no | no | yes |
| Comments — reply and hide | yes | yes | no | yes | no |
| Chat and messages | yes | no | no | no | yes |
| Insights and demographics | yes | no | no | yes | yes |
| Group and channel management | no | no | no | no | yes |
| Ads and targeting | yes | yes | no | no | no |
| Lead Ads — forms and leads | yes | yes | no | no | no |
| Webhooks — signature, events, dedupe | yes | yes | no | yes | yes |
yesnoScroll the table sideways
Notes and limits
Stories publish through the API on Instagram and Facebook Pages (an Instagram story takes no caption), and on Telegram only from a Premium account or a channel with enough boosts — a bot cannot post one. LinkedIn removed Stories in 2021 and TikTok's Content Posting API has none. TikTok comments and insights work with Business accounts only. Socialift supports deleting posts on Facebook, LinkedIn and Telegram, and deleting comments on Instagram and TikTok. Reading LinkedIn posts requires Community Management API access. Telegram does not use OAuth: an account connects with a phone number and code, a bot with its BotFather token. Telegram shows channel statistics only for channels above a server-side size threshold (the can_view_stats flag), and webhooks are for bots. Instagram chat means Direct, with its 24-hour window.
Documentation and SDK reference
From installation to the signature and example of every method — in three languages.
as of socialift 1.3.0 · Updated:
Latest guides
Tokens, permissions, rate limits and webhooks — practical articles that link the official docs they rely on.
Frequently asked questions
Is Socialift a CRM?
No. Socialift is not a CRM but an integration layer between a CRM and social networks. Deals and reporting stay in your system.
Which platforms are supported?
Instagram, Facebook, LinkedIn, TikTok and Telegram (account and bot), plus ads and targeting through the Meta Marketing API. The matrix above lists exactly what each platform supports.
Does Socialift send data into my CRM automatically?
No. There is no ready-made CRM connector and Socialift does not forward events to your CRM. Your backend receives platform webhooks, reads messages, comments or leads through the SDK and writes them to the CRM's API.
Can I publish an Instagram or Telegram story through the API?
Yes. On Instagram a story goes through the same two steps as a post but with media_type=STORIES: it takes no caption and disappears after 24 hours. Facebook Pages have their own photo_stories and video_stories edges. On Telegram only an account can post a story over MTProto, it needs Premium or enough channel boosts, and it lasts 6, 12, 24 or 48 hours. TikTok and LinkedIn do not publish stories through their official APIs.
Which language is the SDK for?
Today there is an official Python package: pip install socialift.
Can I try it without writing code?
Yes. In the dashboard Playground you connect an account, call any method with a real request and inspect the response. Ready-made code comes as Python SDK, cURL or JavaScript; destructive and budget actions ask for confirmation.
How does the free trial work?
A new token from the dashboard needs no card: for the first 30 days it runs in trial mode and unlocks every SDK feature — core methods, webhook helpers, publishing, Instagram Direct, Telegram accounts (TelegramAccount), insights, ads and Lead Ads. After that you renew it in 30-day periods from your balance: the price is shown in the dashboard, and features depend on the token's plan — the exact list appears under “Tekshirish va muhitlar” (Check and environments) next to the token in the dashboard. The dashboard Playground works on any plan.
Is Socialift an official Meta, TikTok or Telegram partner?
No. Socialift is an independent integration layer built on the public Meta, LinkedIn, TikTok and Telegram APIs.