# Juicer API

> Juicer API documentation — Integration API and Data API for social media feeds.

## 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 or hashtag](https://developers.juicer.io/api-reference/data-api/look-up-posts-for-a-handle-or-hashtag.md): Returns recent posts for the given term across the requested platforms. Availability and coverage vary by platform and by the caller's account configuration; results are returned on a best-effort basis.
- [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)
- [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.
- [Introduction](https://developers.juicer.io/introduction.md): Programmatic access to Juicer feeds, sources, posts, and live social data.
- [Quickstart](https://developers.juicer.io/quickstart.md): Create a feed, add a source, and get an embed snippet in five API calls.

## OpenAPI Specs

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