> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Publisher API

## Article: Publisher API

## Article Link: https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/publisher-api.md

## Article Content:

# About the Publisher API

The Publisher API lets you create, schedule, and publish social media posts to a site's connected social channels, including Instagram, Facebook, LinkedIn, X, Pinterest, YouTube, Google Business Profile, and TikTok. You can also generate post content with AI and check the site's social media marketing plan limits.

A site owner connects their social channels through the site's dashboard. Once a channel is connected, you can publish posts to it on the owner's behalf. Posts created through the API appear on the site's Social Media Marketing page in the dashboard, alongside posts created there manually.

Posts created natively on a channel rather than through Wix are imported once a day, and only for sites on a paid social media marketing plan. They can't be retrieved on demand, so they may take up to a day to appear. These appear as items with `external` set to `true`.

The Publisher API is organized into the following services:

- **[Items](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/introduction.md)** — create, publish, schedule, and manage social media posts. A post is called an item.
- **[Accounts](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/account-v1/introduction.md)** — retrieve a site's connected social channel accounts and check whether a channel is connected.
- **[Generated Content](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/generated-content-v1/introduction.md)** — generate post captions and images with AI to use in your posts.
- **[Premium Features](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/premium-feature-v1/introduction.md)** — check a site's premium feature availability and usage quotas before performing actions such as publishing or scheduling.

## Before you begin

It's important to note the following points before starting to code:

- A site owner connects their social channels in the site's dashboard before you can publish to them. See [Connecting to your social media accounts](https://support.wix.com/en/article/social-media-marketing-connect-to-your-social-media-accounts).
- Publishing, scheduling, and other actions can be subject to the site's social media marketing plan. Wix includes a free monthly quota, and sites can upgrade to a paid plan for higher limits. See [Upgrading your social media marketing plan](https://support.wix.com/en/article/social-media-marketing-upgrading-your-social-media-marketing-plan).
- Each post targets a single channel, and its type and content must match a combination supported by that channel.

## Terminology

- **Item**: A social media post. An item can be a draft, scheduled, or published, as shown by its status, and it targets a single connected channel.
- **Channel**: A social network that a post is published to, such as Instagram or TikTok.
- **Account**: A connected social channel, such as an Instagram business account or a Facebook page, that a post is published to.
- **Premium feature**: A capability, such as publishing or scheduling a post, whose availability and quota depend on the site's social media marketing plan.

@sdk_package_setup