# Juicer API

> Juicer's Integration API and Data API for embedding and accessing social media feeds from Instagram, TikTok, YouTube, X, and 15+ platforms. Guides, references, and code samples.

## Docs

- [Get account info, usage, and limits](https://developers.juicer.io/api-reference/account/get-account-info-usage-and-limits.md)
- [Get feed analytics and engagement stats](https://developers.juicer.io/api-reference/analytics/get-feed-analytics-and-engagement-stats.md): Returns engagement metrics, source breakdown, and top posts for a feed within a date range. Defaults to the last 30 days.
- [Look up posts for a handle, hashtag, or other term](https://developers.juicer.io/api-reference/data-api/look-up-posts-for-a-handle-hashtag-or-other-term.md): Returns recent posts for the given term across the requested platforms. Availability and coverage vary by platform; results are returned on a best-effort basis.
- [Look up the canonical profile per platform for a handle](https://developers.juicer.io/api-reference/data-api/look-up-the-canonical-profile-per-platform-for-a-handle.md): Resolves one or more handles to their canonical profile on each requested platform. Pass several handles as a comma-separated `term` list — every term is looked up on every platform independently, and each `data[]` entry is a `{ platform, term, exact_match, profiles[] }` group. Hashtag terms (`#foo`…
- [Get embed code snippets](https://developers.juicer.io/api-reference/embed/get-embed-code-snippets.md): Returns ready-to-use embed snippets for displaying the feed on a website. Includes JavaScript, iframe, WordPress shortcode, and WordPress PHP options.
- [Create a new feed](https://developers.juicer.io/api-reference/feeds/create-a-new-feed.md): Creates a new feed. Returns `422` with `error.code = "feed_limit_reached"` and an upgrade action if your plan's feed limit is exceeded.
- [Delete a feed](https://developers.juicer.io/api-reference/feeds/delete-a-feed.md)
- [Get feed details](https://developers.juicer.io/api-reference/feeds/get-feed-details.md): Returns feed details. Use `?include=sources` to embed sources in the response.
- [List all feeds](https://developers.juicer.io/api-reference/feeds/list-all-feeds.md)
- [Update feed settings](https://developers.juicer.io/api-reference/feeds/update-feed-settings.md): Updates feed settings, including manual and AI moderation.
- [List available platforms and term types](https://developers.juicer.io/api-reference/platforms/list-available-platforms-and-term-types.md): Returns all social media platforms that Juicer supports, along with the term types each platform accepts. Each term type includes its OAuth connection requirements, so you know upfront whether the user needs to connect an account before creating a source.
- [Approve a moderated post](https://developers.juicer.io/api-reference/posts/approve-a-moderated-post.md): Restores a moderated, deleted, or rejected post back to public.
- [Bulk moderate posts](https://developers.juicer.io/api-reference/posts/bulk-moderate-posts.md)
- [Delete a post](https://developers.juicer.io/api-reference/posts/delete-a-post.md): Soft-deletes the post. It can be recovered via the approve endpoint.
- [Get a single post](https://developers.juicer.io/api-reference/posts/get-a-single-post.md)
- [List posts from a feed](https://developers.juicer.io/api-reference/posts/list-posts-from-a-feed.md): Returns paginated posts from a feed. Supports filtering by source, platform, date range, and text search.
- [Pin a post to the top of the feed](https://developers.juicer.io/api-reference/posts/pin-a-post-to-the-top-of-the-feed.md)
- [Reject a post](https://developers.juicer.io/api-reference/posts/reject-a-post.md)
- [Unpin a post](https://developers.juicer.io/api-reference/posts/unpin-a-post.md)
- [API v1 endpoint index](https://developers.juicer.io/api-reference/quickstart/api-v1-endpoint-index.md): Lists all v1 endpoints with a quickstart hint pointing at /v1/authorize. Intended for AI/CLI callers that haven't read this spec.
- [Get an API key with an email (no dashboard, no prior signup)](https://developers.juicer.io/api-reference/quickstart/get-an-api-key-with-an-email-no-dashboard-no-prior-signup.md): Provision an API key using just an email address. The behavior depends on whether the email already belongs to a confirmed Juicer account:
- [Poll the status of a device authorization request](https://developers.juicer.io/api-reference/quickstart/poll-the-status-of-a-device-authorization-request.md): Poll for the outcome of a Mode B authorization request. Returns: - **202** — still pending (keep polling). - **200** — approved; the body contains a 12-hour temporary `api_key`.   The key is returned **once**; subsequent polls return 410. - **410** — denied, expired, or already delivered.
- [Search posts across all feeds](https://developers.juicer.io/api-reference/search/search-posts-across-all-feeds.md): Searches for posts matching a text query across all of the account's feeds. Use `+` between terms for AND matching, or `,` for OR matching.
- [Check connection status per platform](https://developers.juicer.io/api-reference/social-accounts/check-connection-status-per-platform.md): Returns which platforms that require OAuth are connected and which need connecting. Use this before creating sources to know if the user needs to authorize first.
- [Disconnect a social account](https://developers.juicer.io/api-reference/social-accounts/disconnect-a-social-account.md)
- [Generate OAuth connection link](https://developers.juicer.io/api-reference/social-accounts/generate-oauth-connection-link.md): Generates a single-use magic link that signs the user in and redirects straight to the OAuth authorization page. The user does **not** need to be logged into Juicer — just clicking the link is enough.
- [List connected social accounts](https://developers.juicer.io/api-reference/social-accounts/list-connected-social-accounts.md): Returns all social accounts connected across the account (including accounts connected by other team members). Several platforms require a connected social account before you can create sources for them; use `GET /platforms` or `GET /social_accounts/status` to discover which apply to the caller.
- [Add a source to a feed](https://developers.juicer.io/api-reference/sources/add-a-source-to-a-feed.md): Creates a new source and performs an initial sync to fetch posts. Some platforms (like LinkedIn) sync asynchronously — check `syncable` status after creation.
- [List sources for a feed](https://developers.juicer.io/api-reference/sources/list-sources-for-a-feed.md)
- [Remove a source from a feed](https://developers.juicer.io/api-reference/sources/remove-a-source-from-a-feed.md)
- [Assign a feed to a user](https://developers.juicer.io/api-reference/users/assign-a-feed-to-a-user.md): Creates an assignment linking the user to the given feed. The feed must belong to the current account. Subject to the user's plan feed limit. Idempotent — returns `200` when the assignment already exists.
- [Fetch a single user](https://developers.juicer.io/api-reference/users/fetch-a-single-user.md)
- [Invite a manager or collaborator](https://developers.juicer.io/api-reference/users/invite-a-manager-or-collaborator.md): Invites a new user to the current account. Requires an API key belonging to an account owner or manager.
- [List account users](https://developers.juicer.io/api-reference/users/list-account-users.md): Returns managers and collaborators on the current account plus any users with pending admin invitations. Requires an API key belonging to an account owner or manager.
- [Remove a feed assignment from a user](https://developers.juicer.io/api-reference/users/remove-a-feed-assignment-from-a-user.md): Removes the assignment linking the user to the feed. If this would leave an enterprise/team user with zero feeds, the call fails with `422 last_feed_removal_blocked` — delete the user instead. If the feed has no remaining assignments after removal, the feed is soft-deleted.
- [Remove a user from the account](https://developers.juicer.io/api-reference/users/remove-a-user-from-the-account.md): Removes the user from this account. If the user has a pending admin invitation, the invitation is cleared. Otherwise the user is downgraded to a personal free plan and all of their assignments are removed.
- [Create a webhook subscription](https://developers.juicer.io/api-reference/webhooks/create-a-webhook-subscription.md): The `secret` is returned only in the creation response. Store it securely — it's used to verify webhook payloads via HMAC-SHA256 signature in the `X-Juicer-Signature` header.
- [Delete a webhook](https://developers.juicer.io/api-reference/webhooks/delete-a-webhook.md)
- [Get event details with delivery history](https://developers.juicer.io/api-reference/webhooks/get-event-details-with-delivery-history.md)
- [List deliveries for a webhook](https://developers.juicer.io/api-reference/webhooks/list-deliveries-for-a-webhook.md)
- [List webhook events](https://developers.juicer.io/api-reference/webhooks/list-webhook-events.md)
- [List webhook subscriptions](https://developers.juicer.io/api-reference/webhooks/list-webhook-subscriptions.md)
- [Retry a failed delivery](https://developers.juicer.io/api-reference/webhooks/retry-a-failed-delivery.md)
- [Send a test event to the webhook](https://developers.juicer.io/api-reference/webhooks/send-a-test-event-to-the-webhook.md)
- [Update a webhook](https://developers.juicer.io/api-reference/webhooks/update-a-webhook.md)
- [Authentication](https://developers.juicer.io/authentication.md): Use a Bearer API key to authenticate every request.
- [Juicer Developer Docs - One API for Every Social Platform](https://developers.juicer.io/introduction.md): One unified API for Instagram, TikTok, YouTube, X, and 15+ social platforms. Read feeds, sources, and posts without integrating each platform individually.
- [Connect & Setup](https://developers.juicer.io/mcp-connect.md): Connect any MCP client to the Juicer MCP Server — endpoint, authentication, and per-client setup for Claude, Cursor, VS Code, and more.
- [Documentation MCP](https://developers.juicer.io/mcp-docs-search.md): Connect the read-only Juicer Documentation MCP server to your AI agent to search the Juicer API docs in natural language.
- [MCP Server](https://developers.juicer.io/mcp-server.md): Let AI agents drive the Juicer API over the Model Context Protocol (MCP). Manage feeds, sources, posts, and analytics in natural language.
- [Tool Catalog](https://developers.juicer.io/mcp-tools.md): The 33 tools exposed by the Juicer MCP Server — account, feeds, sources, posts, moderation, social accounts, analytics, webhooks, team, and social data — grouped by domain.
- [Quickstart](https://developers.juicer.io/quickstart.md): Connect Instagram, TikTok, YouTube, X, and 15+ social platforms with Juicer's API. Create a feed, add a source, and ship an embeddable snippet in five API calls.

## OpenAPI Specs

- [v1](https://developers.juicer.io/openapi/v1.yaml)
- [openapi](https://developers.juicer.io/api-reference/openapi.json)