Zernio
Zernio
ResourcesIntegrationsOpen SourceMigrations
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources

Open Source

Generate a client from the Zernio OpenAPI spec, use one of the platform specs, or start from an open-source project built on the API.


Use the Zernio OpenAPI spec to generate a client, take one of the platform specs, or start from an open-source project built on the API. The Zernio spec is at zernio.com/openapi.yaml; the official clients built from it are on the SDKs page.

Generate a Zernio client

Point a generator at zernio.com/openapi.yaml:

openapi-generator-cli generate \
  -i https://zernio.com/openapi.yaml \
  -g typescript-fetch -o ./zernio-sdk

A generated client that returns 401 on every call is sending no credentials. The spec's global requirement is HTTP bearer, so set the API key on the generated configuration object before the first call. The generator also picks up a second scheme, connectToken (the X-Connect-Token header), which the page and location selection operations under /v1/connect accept as an alternative, so the configuration carries two auth settings; leave that one empty unless you are finishing an OAuth flow with no browser session (connecting accounts).

Platform API specs

OpenAPI specifications for the platform APIs Zernio publishes to, maintained in the openapi-specs repository. Use them to generate a client, build a request in Postman or read an API in Swagger UI.

X API

OpenAPI spec for the X API v2: posts, users, spaces and lists

Instagram Graph API

OpenAPI spec for the Instagram Graph API: media, comments, insights and stories

Facebook Graph API

OpenAPI spec for the Facebook Graph API: pages, posts, comments and ads

LinkedIn API

OpenAPI spec for the LinkedIn Marketing and Community APIs: posts, organizations and analytics

TikTok API

OpenAPI spec for the TikTok Business APIs: video and photo publishing, creator info, comments and analytics

YouTube Data API

OpenAPI spec for the YouTube Data API v3: videos, channels, playlists and comments

Pinterest API

OpenAPI spec for the Pinterest API v5: pins, boards and analytics

Reddit API

OpenAPI spec for the Reddit API: posts, comments, subreddits and users

Threads API

OpenAPI spec for the Threads API: posts, replies and user profiles

Bluesky API (AT Protocol)

OpenAPI spec for the Bluesky AT Protocol: posts, follows and feeds

Google Business Profile API

OpenAPI spec for the Google Business Profile API: reviews, posts and locations

Telegram Bot API

OpenAPI spec for the Telegram Bot API: messages, updates and inline queries

WhatsApp Business API

OpenAPI spec for the WhatsApp Business Platform: messages, templates, media and flows

Snapchat Marketing API

OpenAPI spec for the Snapchat Marketing API: ads, campaigns and analytics

Use a spec

Each spec has a raw URL: https://raw.githubusercontent.com/zernio-dev/openapi-specs/main/<file>.yaml, where <file> is the file the card links (twitter.yaml for X). Everything below takes that URL.

Import into Postman: copy the raw URL, open Postman, choose File and then Import, and paste it.

Generate a client. The generator reads the raw URL, so there is nothing to download first:

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/zernio-dev/openapi-specs/main/twitter.yaml \
  -g typescript-fetch -o ./twitter-sdk

View in Swagger UI:

docker run -p 8080:8080 -e SWAGGER_JSON_URL=https://raw.githubusercontent.com/zernio-dev/openapi-specs/main/twitter.yaml swaggerapi/swagger-ui

Issues and pull requests for the specs go to the openapi-specs repository.

The platform specs are snapshots of other companies' APIs, so open an issue when one drifts from the live platform.

Projects

Four open-source apps built on the Zernio API, each one a working starting point rather than a sample:

Latewiz

Open-source social media scheduler built on the Zernio API

Zernflow

Open-source visual chatbot builder for Instagram, Facebook, Telegram, X, Bluesky and Reddit

Unified Inbox

Open-source inbox for WhatsApp, Instagram, Messenger, Telegram, X, Reddit and Bluesky, built on the Zernio API

Ads Dashboard

Open-source ads reporting dashboard for the Zernio API. Paste your API key, see your ads data.

Was this page helpful?

OpenClaw

Install the Zernio skill from ClawHub so OpenClaw can create, schedule and retry posts, connect accounts and read analytics from natural language.

Migrate from Ayrshare

Move social posting, profiles, media and scheduled posts from Ayrshare to Zernio, with a drop-in SDK for the social-media-api package or a field mapping for raw HTTP calls.

On this page

Generate a Zernio clientPlatform API specsUse a specProjects