Getting an API Key

The PostEverywhere API lets you programmatically manage posts, accounts, media, and AI image generation. API access is included on all plans — Starter, Growth, and Pro.

Generating an API key

1. Go to Settings > Advanced
2. Find the API Keys section
3. Click Create API Key
4. Give your key a name and select the scopes you need:
   • Read — list and view accounts, posts, results, and media
   • Write — create, edit, delete posts and media, retry failed posts
   • AI — generate images using AI models (uses your plan's AI credits)
5. Copy and store your key securely — it won't be shown again

Your API key starts with pe_live_ and should be kept secret. Do not share it publicly or commit it to version control.

Using your API key

Include your API key in the Authorization header of every request:

Authorization: Bearer pe_live_your_key_here

What you can do with the API

Posts

• Create posts — publish immediately or schedule for later, to any combination of your connected accounts
• List posts — filter by status (scheduled, published, draft) and platform
• Get post results — see per-platform publish status, errors, and platform post IDs
• Retry failed posts — re-queue any failed destinations for another attempt
• Delete posts — remove scheduled or draft posts

Media

• Upload media — images (via Cloudflare Images), videos (MP4), and PDFs (via R2 presigned URLs)
• Complete uploads — finalize media after uploading to the presigned URL
• List & manage media — view your media library, get details, delete files

AI Image Generation

• Generate images from text prompts — create social media visuals directly via the API
• 4 AI models to choose from:
  • Nano Banana Pro — highest quality (15 credits)
  • Ideogram v2 — best for text-in-image (8 credits)
  • Gemini 3 Pro — good balance of speed and quality (5 credits)
  • Flux Schnell — fastest and cheapest (1 credit)
• 7 aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4
• Generated images are saved to your media library, ready to attach to posts via media_ids

Accounts

• List connected accounts — see all active social accounts in your organization

Rate limits

API requests are rate-limited to protect the service and your social accounts.

General API limits

Tier	Limit
Per minute	30 requests
Per hour	500 requests

Posting limits

These limits protect your social accounts from platform restrictions (especially X/Twitter's strict daily limits):

Tier	Limit
Per minute	5 posts
Per hour	30 posts
Per day	100 posts

AI generation limits

Tier	Limit
Per 5 minutes	15 generations
Per hour	60 generations

AI generation also requires available credits on your plan. Credit usage depends on the model chosen.

Rate limit headers are included in every response so you can track your usage.

API documentation

For full endpoint documentation, request/response examples, and schemas, visit the API reference:

developers.posteverywhere.ai

Revoking an API key

To revoke an API key, go to Settings > Advanced, find the key, and click Revoke. The key will stop working immediately.