Документация Socialift

Q: На каком языке программирования Socialift SDK?

Это асинхронный пакет для Python 3.11 и новее: pip install socialift. Playground в кабинете показывает для каждого метода также примеры на cURL и JavaScript fetch, но официальный SDK есть только для Python.

Socialift — асинхронный Python SDK и веб-кабинет для Instagram, Facebook, LinkedIn, TikTok, Telegram и Meta Marketing API. Здесь собраны установка и первый запрос, получение ключей developer-приложений на платформах, ошибки и вебхуки, а также сигнатура, описание и пример каждого метода SDK.

по версии socialift 1.3.0 · Обновлено: 2026-09-19

Установка

Python 3.11+. Для аккаунта Telegram (MTProto) установите дополнительный пакет.

terminal

pip install socialift

# Для аккаунта Telegram (MTProto)
pip install "socialift[telegram]"

export SOCIALIFT_LICENSE_KEY="slk_..."

Начало работы

Установка, лицензионный ключ и веб-кабинет.

Быстрый старт с Socialift SDKУстановка pip install socialift, лицензионный ключ и первый запрос: Telegram-бот за пару минут, Facebook и Instagram через OAuth. Пошагово для Python 3.11+.Аутентификация: лицензионный ключ, seats и токены платформКак устроена лицензия Socialift SDK: SOCIALIFT_LICENSE_KEY, проверка Ed25519, lease на 12 часов, 7 дней офлайн, seats и SOCIALIFT_INSTANCE_ID в Docker.Кабинет Socialift: что делает каждый разделРуководство по кабинету Socialift: лицензионные токены, Playground на 191 методов, подключение аккаунтов, свои ключи приложений, статистика и пополнение счёта.

Ключи платформ

Создание приложений и получение ключей в Meta, Instagram, LinkedIn, TikTok и Telegram.

Приложение Meta для Facebook и Instagram API: пошаговая настройкаНастройка приложения Meta для Facebook Pages, Instagram через Page, Lead Ads и Marketing API: App ID, App Secret, config_id, redirect URI, вебхуки и App Review.Instagram Login: как получить Instagram app ID и secretInstagram API без Facebook Page: где взять Instagram app ID и secret, OAuth redirect URI, разрешения instagram_business_*, вебхуки и подключение к Socialift.Как создать приложение LinkedIn для APIПриложение в LinkedIn Developer Portal: привязка Company Page, OpenID Connect и Share on LinkedIn, redirect URL, Client ID, secret и подключение к Socialift.Приложение TikTok для API: пошаговая настройкаПриложение TikTok for Developers: Login Kit, Content Posting API (Direct Post), scope, redirect URI, подтверждение домена, sandbox, ревью с демо-видео и вебхуки.Telegram: токен бота и api_id/api_hash для аккаунтаДва способа подключить Telegram: токен бота через BotFather, privacy mode и вебхук или аккаунт с api_id/api_hash с my.telegram.org. Что выбрать и как настроить.

Основные понятия

Ошибки, повторные попытки и приём вебхуков.

Обработка ошибок и автоматические повторыОшибки Socialift SDK: в какие классы попадают ошибки Meta, LinkedIn, TikTok и Telegram, что повторяется автоматически и как настроить RetryPolicy.Приём вебхуков с помощью SDKПриём вебхуков Meta, TikTok и Telegram с socialift.webhooks: проверка подписи, разбор событий, пример на FastAPI, быстрый ответ 200 и дедупликация.

Справочник SDK

Каждый клиент и метод: сигнатура, описание, разрешения и пример.

FacebookМетодов: 25from socialift import FacebookPython-клиент Facebook Graph API: вход через Facebook Login, токены страниц, посты, истории, комментарии, подписка на вебхуки и лиды Lead Ads. Методы и примеры.InstagramМетодов: 25from socialift import InstagramPython-клиент Instagram Graph API: подключение через Instagram Login или страницу Facebook, публикация постов, каруселей и историй, комментарии, Direct и статистика.LinkedInМетодов: 10from socialift import LinkedInPython-клиент LinkedIn API: вход через OpenID Connect, проверка и обновление токена, профиль и публикация постов от имени участника. Все методы с примерами.TikTokМетодов: 26from socialift import TikTokВсе методы клиента TikTok в Python SDK Socialift: OAuth через Login Kit, публикация видео и фото, статус поста, комментарии через Business API. С примерами.Telegram-ботМетодов: 76from socialift import TelegramTelegram-бот на Python: отправка сообщений и медиа, webhook, модерация групп, пригласительные ссылки. 76 методов SDK с ограничениями Bot API и примерами.Telegram-аккаунтМетодов: 90from socialift import TelegramAccountPython SDK для Telegram-аккаунта через MTProto (Telethon): история чатов, участники групп, истории, модерация и каналы. 90 методов с примерами и настройкой входа.Реклама MetaМетодов: 35from socialift import AdsКлиент Meta Marketing API в Python SDK Socialift: кампании, группы объявлений, объявления, таргетинг, аудитории и статистика. Всё создаётся в PAUSED.

Частые вопросы

На каком языке программирования Socialift SDK?

Это асинхронный пакет для Python 3.11 и новее: pip install socialift. Playground в кабинете показывает для каждого метода также примеры на cURL и JavaScript fetch, но официальный SDK есть только для Python.

К какой версии SDK относится документация?

Список методов и сигнатуры в справочнике собираются напрямую из кода SDK — версия указана на каждой странице. Если в SDK появится новый метод без описания, тесты не пройдут.

Можно ли проверить методы без кода?

Да. В Playground кабинета вы подключаете аккаунт, вызываете любой метод настоящим запросом и видите ответ. Удаление и действия с рекламным бюджетом требуют подтверждения.

Обязательны ли ключи developer-приложения?

Если используете SDK на своём сервере — да, на каждой платформе нужно своё приложение (для Telegram-бота достаточно токена от BotFather). При подключении через кабинет можно указать свои ключи в разделе «Kalitlar» (ключи) или, где доступно, использовать общее приложение Socialift.