Developer Reference

API Reference

Programmatic blueprint generation for Agency users. Generate, list, and retrieve blueprints via REST. All endpoints are under /api/v1/ and authenticate with a Bearer key.

Get an API key →

Contents

Authentication
POST /blueprints
GET /blueprints/:id
GET /blueprints
POST /blueprints/:id/regenerate
POST /validate
POST /teardown
POST /names
GET /usage
Rate limits
Error codes
Zapier integration

Authentication

All requests require a Bearer token in the Authorization header. Keys start with lpk_live_ and are issued from your dashboard. Each key is shown only once on creation — store it securely.

API access is limited to Agency tier. Studio tier gets read-only access (GET endpoints only).

Example header

Authorization: Bearer lpk_live_YOURKEYHERE

curl example

curl https://blueprintlaunch.app/api/v1/usage \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE"

Node.js

const res = await fetch('https://blueprintlaunch.app/api/v1/usage', {
  headers: { Authorization: 'Bearer lpk_live_YOURKEYHERE' }
});
const usage = await res.json();
console.log(`Used: ${usage.used_this_month} blueprints this month`);

Endpoints

POST /api/v1/blueprints

Generate a full blueprint from an app idea. Returns all 11 sections + viability score. Counts against your monthly tier limit.

Request body (JSON)

Field	Type	Required	Description
idea	string	required	Your app idea. 10–2000 characters.

Request — curl

curl -X POST https://blueprintlaunch.app/api/v1/blueprints \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE" \
  -H "Content-Type: application/json" \
  -d '{"idea":"A Duolingo-style app for learning SQL through daily puzzles"}'

Request — Node.js

const res = await fetch('https://blueprintlaunch.app/api/v1/blueprints', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer lpk_live_YOURKEYHERE',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ idea: 'A Duolingo-style app for learning SQL through daily puzzles' }),
});
const blueprint = await res.json();
console.log(`Blueprint ready: ${blueprint.share_url}`);

Response (201 Created)

{
  "id": 1042,
  "slug": "aB3xKpQr7m",
  "title": "QueryQuest — Learn SQL by solving mysteries",
  "idea_input": "A Duolingo-style app for learning SQL through daily puzzles",
  "sections": {
    "product_concept": "...",
    "target_customer": "...",
    "feature_plan": "...",
    "brand_direction": "...",
    "landing_page_copy": "...",
    "app_store_copy": "...",
    "pricing_strategy": "...",
    "paywall_plan": "...",
    "marketing_content": "...",
    "developer_prompt": "...",
    "launch_checklist": "..."
  },
  "viability": { "score": 82, "verdict": "Strong signal", "signals": {} },
  "share_url": "https://blueprintlaunch.app/b/aB3xKpQr7m",
  "pdf_url": "https://blueprintlaunch.app/b/aB3xKpQr7m/pdf",
  "created_at": "2026-06-13T09:00:00.000Z"
}

GET /api/v1/blueprints/:id

Retrieve a single blueprint by its integer ID. Only blueprints owned by the authenticated user are accessible.

Path params

Param	Type		Description
id	integer	required	Blueprint integer ID returned from POST /blueprints.

Request

curl https://blueprintlaunch.app/api/v1/blueprints/1042 \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE"

Response (200)

{
  "id": 1042,
  "slug": "aB3xKpQr7m",
  "title": "QueryQuest — Learn SQL by solving mysteries",
  "idea_input": "A Duolingo-style app for learning SQL through daily puzzles",
  "sections": { ... },
  "viability_score": 82,
  "viability_signals": { "verdict": "Strong signal" },
  "is_public": false,
  "category": null,
  "created_at": "2026-06-13T09:00:00.000Z",
  "updated_at": "2026-06-13T09:00:00.000Z",
  "share_url": "https://blueprintlaunch.app/b/aB3xKpQr7m",
  "pdf_url": "https://blueprintlaunch.app/b/aB3xKpQr7m/pdf"
}

GET /api/v1/blueprints

Paginated list of your blueprints in reverse-chronological order. Uses cursor-based pagination via the cursor query param.

Query params

Param	Type		Description
limit	integer	optional	Results per page. Default 20, max 100.
cursor	integer	optional	Blueprint ID to paginate from (exclusive). Pass `next_cursor` from previous response.

Request

curl "https://blueprintlaunch.app/api/v1/blueprints?limit=5&cursor=1050" \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE"

Response (200)

{
  "blueprints": [
    {
      "id": 1042,
      "slug": "aB3xKpQr7m",
      "title": "QueryQuest — Learn SQL by solving mysteries",
      "idea_input": "...",
      "is_public": false,
      "category": null,
      "created_at": "2026-06-13T09:00:00.000Z",
      "updated_at": "2026-06-13T09:00:00.000Z",
      "share_url": "https://blueprintlaunch.app/b/aB3xKpQr7m",
      "pdf_url": "https://blueprintlaunch.app/b/aB3xKpQr7m/pdf"
    }
    // ...
  ],
  "pagination": {
    "limit": 5,
    "next_cursor": 1038,
    "has_more": true
  }
}

GET /api/v1/usage

Returns your current plan usage for the billing cycle. Agency tier has no monthly cap (monthly_limit is null).

Request

curl https://blueprintlaunch.app/api/v1/usage \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE"

Response (200)

{
  "tier": "agency",
  "used_this_month": 47,
  "monthly_limit": null,
  "remaining": null,
  "period_end": "2026-07-01T00:00:00.000Z"
}

POST /api/v1/blueprints/:id/regenerate

Regenerate a single section of an existing blueprint. Useful for iterating on a specific section without re-generating the entire document. Cap: 30 section regens/day per user.

Path params

Param	Type		Description
id	integer	required	Blueprint integer ID.

Request body (JSON)

Field	Type	Required	Description
section	string	required	Section key. One of: `product_concept`, `target_customer`, `feature_plan`, `brand_direction`, `landing_page_copy`, `app_store_copy`, `pricing_strategy`, `paywall_plan`, `marketing_content`, `developer_prompt`, `launch_checklist`

Request

curl -X POST https://blueprintlaunch.app/api/v1/blueprints/1042/regenerate \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE" \
  -H "Content-Type: application/json" \
  -d '{"section":"pricing_strategy"}'

Response (200)

{
  "blueprint_id": 1042,
  "section": "pricing_strategy",
  "content": { ... },
  "regen_count_today": 3,
  "regen_limit_daily": 30
}

Free Tool Endpoints

These endpoints expose the same AI tools available on the free web pages — validate an idea, tear down a competitor, or generate app names. Agency and Studio tiers both have full access. These calls are metered by API key rate limits (60 req/min) but do NOT count against your monthly blueprint quota.

POST /api/v1/validate

Score an app idea with a viability analysis. Returns a 0–100 score, 3 signal breakdowns, a verdict, and a shareable URL.

Request body (JSON)

Field	Type	Required	Description
idea	string	required	App idea to validate. 10–1000 characters.

Request

curl -X POST https://blueprintlaunch.app/api/v1/validate \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE" \
  -H "Content-Type: application/json" \
  -d '{"idea":"A Duolingo-style app for learning SQL through daily puzzles"}'

Response (200)

{
  "score": 78,
  "score_id": "aB3xKpQr7m",
  "signals": [
    { "label": "Market Size", "key": "market_size", "status": "strong", "note": "..." },
    { "label": "Competition", "key": "competition", "status": "moderate", "note": "..." },
    { "label": "Monetization Fit", "key": "monetization_fit", "status": "strong", "note": "..." }
  ],
  "verdict": "Strong developer education niche with clear subscription fit...",
  "share_url": "https://blueprintlaunch.app/validate/share/aB3xKpQr7m"
}

POST /api/v1/teardown

Run a competitor teardown analysis. Accepts a product URL, name, or description. Returns positioning gaps, strengths, and 5 differentiation angles.

Request body (JSON)

Field	Type	Required	Description
input	string	required	Competitor URL, product name, or description. 5–1500 characters.

Request

curl -X POST https://blueprintlaunch.app/api/v1/teardown \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE" \
  -H "Content-Type: application/json" \
  -d '{"input":"notion.so"}'

Response (200)

{
  "teardown_id": "xK9mQr2pLn",
  "competitor": "Notion",
  "what_they_do_well": ["...", "...", "..."],
  "positioning_gaps": ["...", "...", "..."],
  "target_customer": "Knowledge workers who need...",
  "pricing_read": "Freemium with team upsell...",
  "how_to_differentiate": ["...", "...", "...", "...", "..."],
  "share_url": "https://blueprintlaunch.app/teardown/xK9mQr2pLn"
}

POST /api/v1/names

Generate 20 AI-crafted app names with domain availability hints (.com/.app/.io via DNS check). Mix of made-up, real-word, compound, portmanteau, and two-word styles.

Request body (JSON)

Field	Type	Required	Description
description	string	required	What your app does. 10–500 characters.
industry	string	optional	e.g. "fintech", "edtech", "health"
tone	string	optional	e.g. "playful", "professional", "bold"
style	string	optional	e.g. "made_up", "two_word", "compound"

Request

curl -X POST https://blueprintlaunch.app/api/v1/names \
  -H "Authorization: Bearer lpk_live_YOURKEYHERE" \
  -H "Content-Type: application/json" \
  -d '{"description":"A habit tracking app for remote teams","tone":"professional"}'

Response (200)

{
  "search_id": "nM7kPqR3wJ",
  "count": 20,
  "names": [
    {
      "name": "Cadence",
      "type": "real_word",
      "domainHint": { "com": "taken", "app": "available", "io": "unknown" },
      "length": "medium"
    },
    ...
  ]
}

Rate limits

Each API key is limited to 60 requests per minute. When exceeded, the API returns HTTP 429 with a Retry-After header indicating seconds to wait.

Limit	Scope	Reset
60 req/min	Per API key	Rolling 60-second window
Unlimited	Monthly blueprints — Agency	Billing period
200/month	Monthly blueprints — Studio (read-only API)	Billing period

Error codes

All errors return a JSON envelope: { "error": { "code": "...", "message": "..." } }

code	HTTP	Description
missing_auth	401	No Authorization header provided.
invalid_key	401	Key not found, wrong format, or revoked.
user_not_found	401	User associated with key no longer exists.
tier_required	403	Account is not on Agency or Studio tier.
write_not_allowed	403	Studio tier tried to POST (read-only).
rate_limit	429	60 req/min key limit exceeded.
usage_limit	402	Monthly blueprint generation cap reached.
invalid_idea	400	idea field missing or under 10 chars.
idea_too_long	400	idea field over 2000 chars.
ai_busy	503	AI service rate limited. Retry shortly.
ai_parse_error	502	AI returned invalid JSON. Retry.
server_error	500	Internal error. Retry or contact support.

Zapier integration

Connect LaunchPad AI to 7,000+ apps without writing a single line of code. The Zapier integration exposes the same API as triggers and actions.

Type	Name	Description
Trigger	New Blueprint Created	Fires when a new blueprint is generated by the API or web UI.
Trigger	Validate Score Posted	Fires when an idea validation score is produced.
Trigger	Teardown Completed	Fires when a competitor teardown is finished.
Action	Generate Blueprint	Generate a full blueprint from an idea text input.
Action	Run Validate	Score an app idea and return signals + verdict.
Action	Run Teardown	Tear down a competitor and return positioning gaps.
Action	Generate Names	Generate 20 app name ideas with domain hints.

Pre-built Zap templates: Airtable row → auto-blueprint · Notion DB → batch blueprints · Typeform survey → validate score → Slack · HubSpot deal → teardown analysis · Google Sheets idea list → CSV of blueprints.

See the full integration guide at blueprintlaunch.app/integrations/zapier →

Ready to build with the API?

Get your API key from your dashboard. Agency plan required — unlimited blueprint generation, full REST access.

Upgrade to Agency →