ESER Developer API v1 Reference

REST API & Webhook Specifications

Build custom social automation tools, connect n8n/Make nodes, or deploy native MCP servers.

GET/v2/user

API Quickstart & Authentication

Authenticate REST API requests using Authorization: Bearer YOUR_API_KEY (or header eser-api-key) at https://app.eserai.tech/v1.

GET/v2/accounts

List Connected Social Accounts

Fetch all connected social accounts with channel identifiers, platform status, and destinations.

GET/v2/credits

Check Credit Balances & Quotas

Get active AI credit balance, monthly renewal timestamp, and tier allocations.

POST/v2/posts

Create and Schedule Posts

Submit multi-channel post drafts with media attachments, scheduled timestamps with timezone offsets, and platform settings.

GET/v2/analytics/top-posts

Top Posts & Cross-Platform Analytics

Retrieve top-performing posts ranked by impressions, views, engagement rate, or comments across 8 platforms (LinkedIn excluded).

GET/v2/comments

Inbound Comments & Replies

Read and reply to inbound comments on published Instagram and Facebook posts.

GET/v2/conversations

Direct Messages & Conversations

Manage Instagram and Facebook DM threads respecting Meta 24-hour response windows.

POST/v2/automations

Keyword DM Automations API

Create keyword-triggered auto-replies and lead magnet fulfillment rules on Instagram and Facebook.

POST/v2/sources

Ingest Content Sources API

Ingest external article URLs, YouTube video transcripts, and PDF documents into workspace source collections.

POST/v2/videos/from-templates

Visual Templates & Video Render API

Trigger automated 9:16 vertical video renders or slide deck creations from visual templates.

GET/v2/schedules

Content Calendar Schedules API

Query workspace recurring posting slots and active IANA timezone settings.