zernio-sdk 1.3.63

The official Python library for the Zernio API

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.edit_post()	Edit published 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_google_business_performance()	Get GBP performance metrics
analytics.get_google_business_search_keywords()	Get GBP search keywords
analytics.get_instagram_account_insights()	Get Instagram insights
analytics.get_instagram_demographics()	Get Instagram 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 frequency vs engagement
analytics.get_you_tube_daily_views()	Get YouTube daily views
analytics.get_you_tube_demographics()	Get YouTube demographics

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_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 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_logs()	List activity 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_ads()	Connect ads for a platform
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 custom audience
ad_audiences.get_ad_audience()	Get audience details
ad_audiences.delete_ad_audience()	Delete custom audience
ad_audiences.add_users_to_ad_audience()	Add users to audience

Ad Campaigns

Method	Description
ad_campaigns.list_ad_campaigns()	List campaigns
ad_campaigns.get_ad_tree()	Get campaign tree
ad_campaigns.update_ad_campaign_status()	Pause or resume a campaign

Ads

Method	Description
ads.list_ad_accounts()	List ad accounts
ads.list_ads()	List ads
ads.list_conversion_destinations()	List destinations for the Conversions API
ads.create_standalone_ad()	Create standalone ad
ads.get_ad()	Get ad details
ads.get_ad_analytics()	Get ad analytics
ads.update_ad()	Update ad
ads.delete_ad()	Cancel an ad
ads.boost_post()	Boost post as ad
ads.search_ad_interests()	Search targeting interests
ads.send_conversions()	Send conversion events to an ad platform

Broadcasts

Method	Description
broadcasts.list_broadcast_recipients()	List broadcast recipients
broadcasts.list_broadcasts()	List broadcasts
broadcasts.create_broadcast()	Create broadcast draft
broadcasts.get_broadcast()	Get broadcast details
broadcasts.update_broadcast()	Update broadcast
broadcasts.delete_broadcast()	Delete broadcast
broadcasts.add_broadcast_recipients()	Add recipients to a broadcast
broadcasts.cancel_broadcast()	Cancel broadcast
broadcasts.schedule_broadcast()	Schedule broadcast for later
broadcasts.send_broadcast()	Send broadcast now

Comment Automations

Method	Description
comment_automations.list_comment_automation_logs()	List automation logs
comment_automations.list_comment_automations()	List comment-to-DM automations
comment_automations.create_comment_automation()	Create comment-to-DM automation
comment_automations.get_comment_automation()	Get automation details
comment_automations.update_comment_automation()	Update automation settings
comment_automations.delete_comment_automation()	Delete automation

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 contact
contacts.get_contact()	Get contact
contacts.get_contact_channels()	List channels for a contact
contacts.update_contact()	Update contact
contacts.delete_contact()	Delete contact

Custom Fields

Method	Description
custom_fields.list_custom_fields()	List custom field definitions
custom_fields.create_custom_field()	Create custom field
custom_fields.update_custom_field()	Update custom field
custom_fields.delete_custom_field()	Delete custom field
custom_fields.clear_contact_field_value()	Clear custom field value
custom_fields.set_contact_field_value()	Set 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.create_inbox_conversation()	Create conversation
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 sequence
sequences.get_sequence()	Get sequence with steps
sequences.update_sequence()	Update sequence
sequences.delete_sequence()	Delete sequence
sequences.activate_sequence()	Activate sequence
sequences.enroll_contacts()	Enroll contacts in a sequence
sequences.pause_sequence()	Pause sequence
sequences.unenroll_contact()	Unenroll contact

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 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.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_business_profile()	Get business profile
whatsapp.get_whats_app_display_name()	Get display name status
whatsapp.get_whats_app_group_chat()	Get group info
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_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_group_chat()	Delete group
whatsapp.delete_whats_app_template()	Delete template
whatsapp.add_whats_app_group_participants()	Add participants
whatsapp.approve_whats_app_group_join_requests()	Approve join requests
whatsapp.reject_whats_app_group_join_requests()	Reject join requests
whatsapp.remove_whats_app_group_participants()	Remove participants
whatsapp.upload_whats_app_profile_photo()	Upload profile picture

WhatsApp Flows

Method	Description
whatsapp_flows.list_whats_app_flows()	List flows
whatsapp_flows.create_whats_app_flow()	Create flow
whatsapp_flows.get_whats_app_flow()	Get flow
whatsapp_flows.get_whats_app_flow_json()	Get flow JSON asset
whatsapp_flows.update_whats_app_flow()	Update flow
whatsapp_flows.delete_whats_app_flow()	Delete flow
whatsapp_flows.deprecate_whats_app_flow()	Deprecate flow
whatsapp_flows.publish_whats_app_flow()	Publish flow
whatsapp_flows.send_whats_app_flow_message()	Send flow message
whatsapp_flows.upload_whats_app_flow_json()	Upload flow JSON

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

• Python 3.10+
• Zernio API key (free tier available)

Links

• Documentation
• Dashboard
• Changelog

License

Apache-2.0