Overview

Access & Availability The Publer API is available exclusively to Business and Enterprise customers. Upgrade your plan

Introduction

Welcome to the Publer API. This RESTful JSON API brings Publer’s social media scheduling, publishing, and analytics capabilities into your own applications, scripts, or services. Whether you’re automating campaigns, building dashboards, or integrating content workflows, the Publer API provides the same power you know from the Publer web platform.

What is Publer?

Publer is an all-in-one social media management solution. From a single dashboard you can:

• Schedule and publish posts

• Manage accounts and team workspaces

• Track performance with built-in analytics

Supported networks: Facebook, Instagram, Twitter/X, LinkedIn, Pinterest, YouTube, TikTok, Google Business Profile, WordPress, Telegram, Mastodon, Threads, Bluesky.

What can I do with the Publer API?

• Create, schedule, and publish posts (text, images, videos, links, polls, carousels, PDFs)

• Upload, organize, and reuse media assets (images, videos, GIFs, documents)

• List workspaces, accounts, and user details

• Retrieve posts and their performance analytics

• Analytics:

  • Charts: Discover available analytics charts and fetch chart data for dashboards

  • Post Insights: Per‑post metrics with filtering, sorting, pagination, and competitor mode

  • Hashtag Analysis: Aggregate hashtag performance plus top performing posts per hashtag

  • Best Times to Post: Day/hour heatmap for optimal posting times (supports competitor view)

  • Members: Per‑member activity and performance (posts, reach, engagements)

  • Competitor Analysis: List competitors and compare followers, engagement, reach, and posting mix

• Build custom integrations, dashboards, or bots

API Specifications

Property	Value
Base URL	https://app.publer.com/api/v1
Format	JSON
Auth Method	Bearer-API Token
Version	v1 (semantic versioning MAJOR.MINOR.PATCH)
Rate Limits	100 requests/2 minutes per user

Authentication

Include your API token in every request header:

Authorization: Bearer-API YOUR_API_TOKEN
Publer-Workspace-Id: YOUR_WORKSPACE_ID // Required on special cases
Content-Type: application/json

Manage and regenerate tokens in Settings → Access & Login → API Keys.

Getting Started

1. Generate an API key in your Publer Dashboard.

2. Validate your credentials:

   curl -H "Authorization: Bearer YOUR_API_TOKEN" \
        https://app.publer.com/api/v1/me

3. Follow our quickstart guide to make your first API request

4. Explore the full API reference for detailed endpoint docs.

Support & Resources

If you need assistance with the API:

• Review our quickstart guide for basic concepts

• Check the API reference for detailed endpoint information

• Contact [email protected] for technical issues

Jump right in

Quickstart

Get up and running with the API in minutes

Authentication

Learn how to authenticate your API requests

API Reference

Explore detailed endpoint documentation