Zernio Python SDK
One API to post everywhere. 14 platforms, zero headaches.
The official Python SDK for the Zernio API — schedule and publish social media posts across Instagram, TikTok, YouTube, LinkedIn, X/Twitter, Facebook, Pinterest, Threads, Bluesky, Reddit, Snapchat, Telegram, WhatsApp, and Google Business Profile with a single integration.
Installation
pip install zernio-sdk
Quick Start
from zernio import Zernio
# Reads ZERNIO_API_KEY from environment (or pass explicitly)
client = Zernio()
# Publish to multiple platforms with one call
post = client.posts.create(
content="Hello world from Zernio!",
platforms=[
{"platform": "twitter", "accountId": "acc_xxx"},
{"platform": "linkedin", "accountId": "acc_yyy"},
{"platform": "instagram", "accountId": "acc_zzz"},
],
publish_now=True,
)
print(f"Published to {len(post['post']['platforms'])} platforms!")
Configuration
client = Zernio(
api_key="your-api-key", # Or set ZERNIO_API_KEY env var
base_url="https://zernio.com/api", # Optional, this is the default
timeout=30.0, # Optional, request timeout in seconds
)
Examples
Schedule a Post
post = client.posts.create(
content="This post will go live tomorrow at 10am",
platforms=[{"platform": "instagram", "accountId": "acc_xxx"}],
scheduled_for="2025-02-01T10:00:00Z",
)
Platform-Specific Content
Customize content per platform while posting to all at once:
post = client.posts.create(
content="Default content",
platforms=[
{
"platform": "twitter",
"accountId": "acc_twitter",
"platformSpecificContent": "Short & punchy for X",
},
{
"platform": "linkedin",
"accountId": "acc_linkedin",
"platformSpecificContent": "Professional tone for LinkedIn with more detail.",
},
],
publish_now=True,
)
Upload Media
# Option 1: Direct upload (simplest)
result = client.media.upload("path/to/video.mp4")
media_url = result["publicUrl"]
# Option 2: Upload from bytes
result = client.media.upload_bytes(video_bytes, "video.mp4", "video/mp4")
media_url = result["publicUrl"]
# Create post with media
post = client.posts.create(
content="Check out this video!",
media_urls=[media_url],
platforms=[
{"platform": "tiktok", "accountId": "acc_xxx"},
{"platform": "youtube", "accountId": "acc_yyy", "youtubeTitle": "My Video"},
],
publish_now=True,
)
Get Analytics
data = client.analytics.get(period="30d")
print("Analytics:", data)
List Connected Accounts
data = client.accounts.list()
for account in data["accounts"]:
print(f"{account['platform']}: @{account['username']}")
Async Support
import asyncio
from zernio import Zernio
async def main():
async with Zernio(api_key="your-api-key") as client:
posts = await client.posts.alist(status="scheduled")
print(f"Found {len(posts['posts'])} scheduled posts")
asyncio.run(main())
Error Handling
from zernio import Zernio, ZernioAPIError, ZernioRateLimitError, ZernioValidationError
client = Zernio(api_key="your-api-key")
try:
client.posts.create(content="Hello!", platforms=[...])
except ZernioRateLimitError as e:
print(f"Rate limited: {e}")
except ZernioValidationError as e:
print(f"Invalid request: {e}")
except ZernioAPIError as e:
print(f"API error: {e}")
Migration from Late
All old names continue to work. No code changes are required:
# Old style (still works)
from late import Late, LateAPIError
client = Late(api_key="...")
# New style
from zernio import Zernio, ZernioAPIError
client = Zernio() # reads ZERNIO_API_KEY env var
Both from zernio import ... and from late import ... work identically. The LATE_API_KEY environment variable is also still supported as a fallback when ZERNIO_API_KEY is not set.
SDK Reference
Posts
| Method |
Description |
posts.list_posts() |
List posts |
posts.bulk_upload_posts() |
Bulk upload from CSV |
posts.create_post() |
Create post |
posts.get_post() |
Get post |
posts.update_post() |
Update post |
posts.update_post_metadata() |
Update post metadata |
posts.delete_post() |
Delete post |
posts.retry_post() |
Retry failed post |
posts.unpublish_post() |
Unpublish post |
Accounts
| Method |
Description |
accounts.get_all_accounts_health() |
Check accounts health |
accounts.list_accounts() |
List accounts |
accounts.get_account_health() |
Check account health |
accounts.get_follower_stats() |
Get follower stats |
accounts.get_google_business_reviews() |
Get reviews |
accounts.get_linked_in_mentions() |
Resolve LinkedIn mention |
accounts.get_tik_tok_creator_info() |
Get TikTok creator info |
accounts.update_account() |
Update account |
accounts.delete_account() |
Disconnect account |
Profiles
| Method |
Description |
profiles.list_profiles() |
List profiles |
profiles.create_profile() |
Create profile |
profiles.get_profile() |
Get profile |
profiles.update_profile() |
Update profile |
profiles.delete_profile() |
Delete profile |
Analytics
| Method |
Description |
analytics.get_analytics() |
Get post analytics |
analytics.get_best_time_to_post() |
Get best times to post |
analytics.get_content_decay() |
Get content performance decay |
analytics.get_daily_metrics() |
Get daily aggregated metrics |
analytics.get_instagram_account_insights() |
Get Instagram account-level insights |
analytics.get_instagram_demographics() |
Get Instagram audience demographics |
analytics.get_linked_in_aggregate_analytics() |
Get LinkedIn aggregate stats |
analytics.get_linked_in_post_analytics() |
Get LinkedIn post stats |
analytics.get_linked_in_post_reactions() |
Get LinkedIn post reactions |
analytics.get_post_timeline() |
Get post analytics timeline |
analytics.get_posting_frequency() |
Get posting frequency vs engagement |
analytics.get_you_tube_daily_views() |
Get YouTube daily views |
Account Groups
| Method |
Description |
account_groups.list_account_groups() |
List groups |
account_groups.create_account_group() |
Create group |
account_groups.update_account_group() |
Update group |
account_groups.delete_account_group() |
Delete group |
Queue
| Method |
Description |
queue.list_queue_slots() |
List schedules |
queue.create_queue_slot() |
Create schedule |
queue.get_next_queue_slot() |
Get next available slot |
queue.update_queue_slot() |
Update schedule |
queue.delete_queue_slot() |
Delete schedule |
queue.preview_queue() |
Preview upcoming slots |
Webhooks
| Method |
Description |
webhooks.create_webhook_settings() |
Create webhook |
webhooks.get_webhook_logs() |
Get delivery logs |
webhooks.get_webhook_settings() |
List webhooks |
webhooks.update_webhook_settings() |
Update webhook |
webhooks.delete_webhook_settings() |
Delete webhook |
webhooks.test_webhook() |
Send test webhook |
API Keys
| Method |
Description |
api_keys.list_api_keys() |
List keys |
api_keys.create_api_key() |
Create key |
api_keys.delete_api_key() |
Delete key |
Media
| Method |
Description |
media.get_media_presigned_url() |
Get presigned upload URL |
media.upload() |
Upload a file from path |
media.upload_bytes() |
Upload file from bytes |
media.upload_large() |
Upload large file with multipart |
media.upload_large_bytes() |
Upload large file from bytes |
media.upload_multiple() |
Upload multiple files |
Users
| Method |
Description |
users.list_users() |
List users |
users.get_user() |
Get user |
Usage
| Method |
Description |
usage.get_usage_stats() |
Get plan and usage stats |
Logs
| Method |
Description |
logs.list_connection_logs() |
List connection logs |
logs.list_posts_logs() |
List publishing logs |
logs.get_post_logs() |
Get post logs |
Connect (OAuth)
| Method |
Description |
connect.list_facebook_pages() |
List Facebook pages |
connect.list_google_business_locations() |
List GBP locations |
connect.list_linked_in_organizations() |
List LinkedIn orgs |
connect.list_pinterest_boards_for_selection() |
List Pinterest boards |
connect.list_snapchat_profiles() |
List Snapchat profiles |
connect.get_connect_url() |
Get OAuth connect URL |
connect.get_facebook_pages() |
List Facebook pages |
connect.get_gmb_locations() |
List GBP locations |
connect.get_linked_in_organizations() |
List LinkedIn orgs |
connect.get_pending_o_auth_data() |
Get pending OAuth data |
connect.get_pinterest_boards() |
List Pinterest boards |
connect.get_reddit_flairs() |
List subreddit flairs |
connect.get_reddit_subreddits() |
List Reddit subreddits |
connect.get_telegram_connect_status() |
Generate Telegram code |
connect.get_youtube_playlists() |
List YouTube playlists |
connect.update_facebook_page() |
Update Facebook page |
connect.update_gmb_location() |
Update GBP location |
connect.update_linked_in_organization() |
Switch LinkedIn account type |
connect.update_pinterest_boards() |
Set default Pinterest board |
connect.update_reddit_subreddits() |
Set default subreddit |
connect.update_youtube_default_playlist() |
Set default YouTube playlist |
connect.complete_telegram_connect() |
Check Telegram status |
connect.connect_bluesky_credentials() |
Connect Bluesky account |
connect.connect_whats_app_credentials() |
Connect WhatsApp via credentials |
connect.handle_o_auth_callback() |
Complete OAuth callback |
connect.initiate_telegram_connect() |
Connect Telegram directly |
connect.select_facebook_page() |
Select Facebook page |
connect.select_google_business_location() |
Select GBP location |
connect.select_linked_in_organization() |
Select LinkedIn org |
connect.select_pinterest_board() |
Select Pinterest board |
connect.select_snapchat_profile() |
Select Snapchat profile |
Reddit
| Method |
Description |
reddit.get_reddit_feed() |
Get subreddit feed |
reddit.search_reddit() |
Search posts |
Account Settings
| Method |
Description |
account_settings.get_instagram_ice_breakers() |
Get IG ice breakers |
account_settings.get_messenger_menu() |
Get FB persistent menu |
account_settings.get_telegram_commands() |
Get TG bot commands |
account_settings.delete_instagram_ice_breakers() |
Delete IG ice breakers |
account_settings.delete_messenger_menu() |
Delete FB persistent menu |
account_settings.delete_telegram_commands() |
Delete TG bot commands |
account_settings.set_instagram_ice_breakers() |
Set IG ice breakers |
account_settings.set_messenger_menu() |
Set FB persistent menu |
account_settings.set_telegram_commands() |
Set TG bot commands |
Ad Audiences
| Method |
Description |
ad_audiences.list_ad_audiences() |
List custom audiences |
ad_audiences.create_ad_audience() |
Create a custom audience (Meta only) |
ad_audiences.get_ad_audience() |
Get audience details |
ad_audiences.delete_ad_audience() |
Delete a custom audience |
ad_audiences.add_users_to_ad_audience() |
Add users to a customer list audience |
Ad Campaigns
| Method |
Description |
ad_campaigns.list_ad_campaigns() |
List campaigns with aggregate metrics |
ad_campaigns.get_ad_tree() |
Get nested campaign/ad-set/ad tree |
ad_campaigns.update_ad_campaign_status() |
Pause or resume a campaign |
Ads
| Method |
Description |
ads.list_ad_accounts() |
List ad accounts for a social account |
ads.list_ads() |
List ads |
ads.create_standalone_ad() |
Create a standalone ad with custom creative |
ads.get_ad() |
Get ad details |
ads.get_ad_analytics() |
Get ad analytics with daily breakdown |
ads.update_ad() |
Update ad (pause/resume, budget, targeting, name) |
ads.delete_ad() |
Cancel an ad |
ads.boost_post() |
Boost an existing post as a paid ad |
ads.search_ad_interests() |
Search targeting interests |
ads.sync_external_ads() |
Sync external ads from platform ad managers |
Broadcasts
| Method |
Description |
broadcasts.list_broadcast_recipients() |
List broadcast recipients |
broadcasts.list_broadcasts() |
List broadcasts |
broadcasts.create_broadcast() |
Create a broadcast draft |
broadcasts.get_broadcast() |
Get broadcast details |
broadcasts.update_broadcast() |
Update a broadcast |
broadcasts.delete_broadcast() |
Delete a broadcast (draft only) |
broadcasts.add_broadcast_recipients() |
Add recipients to a broadcast |
broadcasts.cancel_broadcast() |
Cancel a broadcast |
broadcasts.schedule_broadcast() |
Schedule broadcast for later |
broadcasts.send_broadcast() |
Trigger immediate send |
Comment Automations
| Method |
Description |
comment_automations.list_comment_automation_logs() |
List trigger logs for an automation |
comment_automations.list_comment_automations() |
List comment-to-DM automations |
comment_automations.create_comment_automation() |
Create a comment-to-DM automation |
comment_automations.get_comment_automation() |
Get automation details with recent logs |
comment_automations.update_comment_automation() |
Update automation settings |
comment_automations.delete_comment_automation() |
Delete automation and all logs |
Comments (Inbox)
| Method |
Description |
comments.list_inbox_comments() |
List commented posts |
comments.get_inbox_post_comments() |
Get post comments |
comments.delete_inbox_comment() |
Delete comment |
comments.hide_inbox_comment() |
Hide comment |
comments.like_inbox_comment() |
Like comment |
comments.reply_to_inbox_post() |
Reply to comment |
comments.send_private_reply_to_comment() |
Send private reply |
comments.unhide_inbox_comment() |
Unhide comment |
comments.unlike_inbox_comment() |
Unlike comment |
Contacts
| Method |
Description |
contacts.list_contacts() |
List contacts |
contacts.bulk_create_contacts() |
Bulk create contacts |
contacts.create_contact() |
Create a contact |
contacts.get_contact() |
Get contact with channels |
contacts.get_contact_channels() |
List channels for a contact |
contacts.update_contact() |
Update a contact |
contacts.delete_contact() |
Delete a contact |
Custom Fields
| Method |
Description |
custom_fields.list_custom_fields() |
List custom field definitions |
custom_fields.create_custom_field() |
Create a custom field definition |
custom_fields.update_custom_field() |
Update a custom field definition |
custom_fields.delete_custom_field() |
Delete a custom field definition |
custom_fields.clear_contact_field_value() |
Clear a custom field value |
custom_fields.set_contact_field_value() |
Set a custom field value |
GMB Attributes
| Method |
Description |
gmb_attributes.get_google_business_attributes() |
Get attributes |
gmb_attributes.update_google_business_attributes() |
Update attributes |
GMB Food Menus
| Method |
Description |
gmb_food_menus.get_google_business_food_menus() |
Get food menus |
gmb_food_menus.update_google_business_food_menus() |
Update food menus |
GMB Location Details
| Method |
Description |
gmb_location_details.get_google_business_location_details() |
Get location details |
gmb_location_details.update_google_business_location_details() |
Update location details |
GMB Media
| Method |
Description |
gmb_media.list_google_business_media() |
List media |
gmb_media.create_google_business_media() |
Upload photo |
gmb_media.delete_google_business_media() |
Delete photo |
GMB Place Actions
| Method |
Description |
gmb_place_actions.list_google_business_place_actions() |
List action links |
gmb_place_actions.create_google_business_place_action() |
Create action link |
gmb_place_actions.delete_google_business_place_action() |
Delete action link |
Messages (Inbox)
| Method |
Description |
messages.list_inbox_conversations() |
List conversations |
messages.get_inbox_conversation() |
Get conversation |
messages.get_inbox_conversation_messages() |
List messages |
messages.update_inbox_conversation() |
Update conversation status |
messages.delete_inbox_message() |
Delete message |
messages.add_message_reaction() |
Add reaction |
messages.edit_inbox_message() |
Edit message |
messages.remove_message_reaction() |
Remove reaction |
messages.send_inbox_message() |
Send message |
messages.send_typing_indicator() |
Send typing indicator |
messages.upload_media_direct() |
Upload media file |
Reviews (Inbox)
| Method |
Description |
reviews.list_inbox_reviews() |
List reviews |
reviews.delete_inbox_review_reply() |
Delete review reply |
reviews.reply_to_inbox_review() |
Reply to review |
Sequences
| Method |
Description |
sequences.list_sequence_enrollments() |
List enrollments for a sequence |
sequences.list_sequences() |
List sequences |
sequences.create_sequence() |
Create a sequence |
sequences.get_sequence() |
Get sequence with steps |
sequences.update_sequence() |
Update a sequence |
sequences.delete_sequence() |
Delete a sequence |
sequences.activate_sequence() |
Activate a sequence |
sequences.enroll_contacts() |
Enroll contacts in a sequence |
sequences.pause_sequence() |
Pause a sequence |
sequences.unenroll_contact() |
Unenroll a contact from a sequence |
Twitter Engagement
| Method |
Description |
twitter_engagement.bookmark_post() |
Bookmark a tweet |
twitter_engagement.follow_user() |
Follow a user |
twitter_engagement.remove_bookmark() |
Remove bookmark |
twitter_engagement.retweet_post() |
Retweet a post |
twitter_engagement.undo_retweet() |
Undo retweet |
twitter_engagement.unfollow_user() |
Unfollow a user |
Validate
| Method |
Description |
validate.validate_media() |
Validate media URL |
validate.validate_post() |
Validate post content |
validate.validate_post_length() |
Validate post character count |
validate.validate_subreddit() |
Check subreddit existence |
WhatsApp
| Method |
Description |
whatsapp.list_whats_app_group_chats() |
List active groups |
whatsapp.list_whats_app_group_join_requests() |
List join requests |
whatsapp.bulk_delete_whats_app_contacts() |
Bulk delete contacts |
whatsapp.bulk_update_whats_app_contacts() |
Bulk update contacts |
whatsapp.create_whats_app_broadcast() |
Create broadcast |
whatsapp.create_whats_app_contact() |
Create contact |
whatsapp.create_whats_app_group_chat() |
Create group |
whatsapp.create_whats_app_group_invite_link() |
Create invite link |
whatsapp.create_whats_app_template() |
Create template |
whatsapp.get_whats_app_broadcast() |
Get broadcast |
whatsapp.get_whats_app_broadcast_recipients() |
List recipients |
whatsapp.get_whats_app_broadcasts() |
List broadcasts |
whatsapp.get_whats_app_business_profile() |
Get business profile |
whatsapp.get_whats_app_contact() |
Get contact |
whatsapp.get_whats_app_contacts() |
List contacts |
whatsapp.get_whats_app_display_name() |
Get display name and review status |
whatsapp.get_whats_app_group_chat() |
Get group info |
whatsapp.get_whats_app_groups() |
List contact groups |
whatsapp.get_whats_app_template() |
Get template |
whatsapp.get_whats_app_templates() |
List templates |
whatsapp.update_whats_app_business_profile() |
Update business profile |
whatsapp.update_whats_app_contact() |
Update contact |
whatsapp.update_whats_app_display_name() |
Request display name change |
whatsapp.update_whats_app_group_chat() |
Update group settings |
whatsapp.update_whats_app_template() |
Update template |
whatsapp.delete_whats_app_broadcast() |
Delete broadcast |
whatsapp.delete_whats_app_contact() |
Delete contact |
whatsapp.delete_whats_app_group() |
Delete group |
whatsapp.delete_whats_app_group_chat() |
Delete group |
whatsapp.delete_whats_app_template() |
Delete template |
whatsapp.add_whats_app_broadcast_recipients() |
Add recipients |
whatsapp.add_whats_app_group_participants() |
Add participants |
whatsapp.approve_whats_app_group_join_requests() |
Approve join requests |
whatsapp.cancel_whats_app_broadcast_schedule() |
Cancel scheduled broadcast |
whatsapp.import_whats_app_contacts() |
Bulk import contacts |
whatsapp.reject_whats_app_group_join_requests() |
Reject join requests |
whatsapp.remove_whats_app_broadcast_recipients() |
Remove recipients |
whatsapp.remove_whats_app_group_participants() |
Remove participants |
whatsapp.rename_whats_app_group() |
Rename group |
whatsapp.schedule_whats_app_broadcast() |
Schedule broadcast |
whatsapp.send_whats_app_broadcast() |
Send broadcast |
whatsapp.send_whats_app_bulk() |
Bulk send template messages |
whatsapp.upload_whats_app_profile_photo() |
Upload profile picture |
WhatsApp Phone Numbers
| Method |
Description |
whatsapp_phone_numbers.get_whats_app_phone_number() |
Get phone number |
whatsapp_phone_numbers.get_whats_app_phone_numbers() |
List phone numbers |
whatsapp_phone_numbers.purchase_whats_app_phone_number() |
Purchase phone number |
whatsapp_phone_numbers.release_whats_app_phone_number() |
Release phone number |
Invites
| Method |
Description |
invites.create_invite_token() |
Create invite token |
MCP Server (Claude Desktop)
The SDK includes a Model Context Protocol (MCP) server for integration with Claude Desktop. See MCP documentation for setup instructions.
pip install zernio-sdk[mcp]
Requirements
Links
License
Apache-2.0
