arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Overview

circle-info

Access & Availability The Publer API is available exclusively to Business and Enterprise customers. Upgrade your planarrow-up-right

hashtag
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.

hashtag
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.

hashtag
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

hashtag
API Specifications

Property
Value

hashtag
Authentication

Include your API token in every request header:

Manage and regenerate tokens in .

hashtag
Getting Started

  1. Generate an API key in your Publer Dashboard.

  2. Validate your credentials:

  3. Follow our to make your first API request

hashtag
Support & Resources

If you need assistance with the API:

  • Review our for basic concepts

  • Check the for detailed endpoint information

  • Contact for technical issues

hashtag
Jump right in

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

  • Explore the full API reference for detailed endpoint docs.

    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

    Settings → Access & Login → API Keysarrow-up-right
    quickstart guide
    quickstart guide
    API reference
    [email protected]envelope

    Quickstart

    Get up and running with the API in minutes

    Authentication

    Learn how to authenticate your API requests

    API Reference

    Explore detailed endpoint documentation

    Authorization: Bearer-API YOUR_API_TOKEN
    Publer-Workspace-Id: YOUR_WORKSPACE_ID // Required on special cases
    Content-Type: application/json
    curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         https://app.publer.com/api/v1/me