Developer API

API Reference

Integrate AIPostMockup's AI generation and mockup rendering directly into your applications. Available on Business plan ($79/mo).

Who this API is for

The AIPostMockup API is designed for SaaS teams, agencies, internal marketing platforms, and workflow tools that need AI-generated social content plus realistic mockup rendering. Typical use cases include campaign generation, approval dashboards, client reporting, content planning tools, and white-labeled social media utilities.

If you want to generate multiple post variations, render preview assets, monitor credit usage, or connect mockup creation to other systems, this documentation gives you the endpoint structure, authentication model, and request patterns to get started quickly.

Popular workflows

Generate campaign variants, render previews, and return assets to an approval queue.

Developer resources

Use authentication, credits, webhooks, and endpoint examples to build reliable integrations.

Helpful links

See pricing, embed options, and the blog for implementation ideas.

Authentication

All API requests require a Bearer token in the Authorization header.

HTTP Header

Authorization: Bearer apm_live_your_api_key_here

AI Engines

Choose which engine to use per request. Higher engines produce better content but cost more credits.

V1 Spark

Fast & efficient. 1 credit/post.

v1_spark

V2 Pro

Smart & creative. 3 credits/post.

v2_pro

V3 Ultra

Best quality. 5 credits/post.

v3_ultra

Rate Limits

Endpoint	Limit	Window
/v1/generate	60 requests	per minute
/v1/renders	30 requests	per minute
/v1/campaigns	10 requests	per minute
/v1/templates	120 requests	per minute

Endpoints

POST

/v1/generate

Generate AI posts from keywords. Choose your engine tier for quality control.

Request Body

{
  "keywords": ["startup", "growth", "ai"],
  "engine": "v2_pro",
  "platforms": ["linkedin", "instagram", "twitter"],
  "tone": "professional"
}

Response

{
  "id": "gen_abc789",
  "credits_used": 8,
  "posts": [
    {
      "platform": "linkedin",
      "content": "We bootstrapped to $1M ARR...",
      "engagement_score": 9.2,
      "hashtags": ["#startup", "#growth"]
    }
  ]
}

GET

/v1/templates

List available mockup templates with filtering by platform and category.

Response

{
  "data": [
    {
      "id": "tpl_123",
      "name": "LinkedIn Viral Post",
      "platform": "linkedin",
      "category": "engagement",
      "downloads": 12400
    }
  ],
  "meta": { "total": 150, "page": 1 }
}

POST

/v1/renders

Create a mockup render with your generated content.

Request Body

{
  "template_id": "tpl_123",
  "content": "Your post content here...",
  "author_name": "Alex Chen",
  "format": "png",
  "resolution": "2x"
}

Response

{
  "render_id": "rnd_xyz456",
  "status": "completed",
  "url": "https://cdn.aipostmockup.com/renders/rnd_xyz456.png",
  "size": "1200x627"
}

POST

/v1/campaigns

Generate a full campaign — multiple variations across platforms for A/B testing.

Request Body

{
  "keywords": ["saas", "launch", "product"],
  "engine": "v3_ultra",
  "variations": 5,
  "platforms": ["linkedin", "twitter", "instagram", "facebook"]
}

Response

{
  "campaign_id": "cmp_def123",
  "credits_used": 40,
  "total_posts": 20,
  "variations": 5,
  "status": "completed"
}

GET

/v1/account/credits

Check remaining credits and usage for the current billing period.

Response

{
  "plan": "growth",
  "credits_total": 500,
  "credits_used": 234,
  "credits_remaining": 266,
  "engines_available": ["v1_spark", "v2_pro", "v3_ultra"],
  "billing_resets": "2026-03-01T00:00:00Z"
}

Ready to integrate?

API access is available on the Business plan. Get your API key and start building.

Get API Access