# Overview

{% hint style="info" %}
**Access & Availability**\
The Publer API is available exclusively to Business and Enterprise customers.\
\
[Upgrade your plan](https://publer.com/plans)
{% endhint %}

### 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

<table><thead><tr><th width="193.2862548828125">Property</th><th>Value</th></tr></thead><tbody><tr><td>Base URL</td><td><code>https://app.publer.com/api/v1</code></td></tr><tr><td>Format</td><td>JSON</td></tr><tr><td>Auth Method</td><td>Bearer-API Token</td></tr><tr><td>Version</td><td>v1 (semantic versioning MAJOR.MINOR.PATCH)</td></tr><tr><td>Rate Limits</td><td>100 requests/2 minutes per user</td></tr></tbody></table>

### Authentication

Include your API token in every request header:

```http
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**](https://publer.com/help/en/article/how-to-access-the-publer-api-1w08edo/).

### Getting Started

1. **Generate an API key** in your Publer Dashboard.
2. **Validate your credentials**:

   ```sh
   curl -H "Authorization: Bearer YOUR_API_TOKEN" \
        https://app.publer.com/api/v1/me
   ```
3. **Follow our** [quickstart guide](https://publer.com/docs/getting-started/quickstart) to make your first API request
4. **Explore the full** [**API reference**](https://publer.com/docs/api-reference) for detailed endpoint docs.

### Support & Resources

If you need assistance with the API:

* Review our [quickstart guide](https://publer.com/docs/getting-started/quickstart) for basic concepts
* Check the [API reference](https://publer.com/docs/api-reference/introduction) for detailed endpoint information
* Contact <support@publer.com> for technical issues

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Quickstart</strong></td><td>Get up and running with the API in minutes</td><td></td><td></td><td><a href="getting-started/quickstart">quickstart</a></td></tr><tr><td><strong>Authentication</strong></td><td>Learn how to authenticate your API requests</td><td></td><td></td><td><a href="getting-started/authentication-1">authentication-1</a></td></tr><tr><td><strong>API Reference</strong></td><td>Explore detailed endpoint documentation</td><td></td><td></td><td><a href="api-reference/introduction">introduction</a></td></tr></tbody></table>