Launchmind API Documentation

Version: v1.0
Base URL: https://launchmind.io/api
Authentication: Bearer Token (API Key)
Content-Type: application/json

---

🔐 Authentication

All API requests require authentication via Bearer token. Get your API key from the Dashboard.

curl -X POST https://launchmind.io/api/v1/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API Key Format: lm_live_xxxxxxxxxxxxxxxxxxxx

Error Responses

HTTP Code	Error	Description
401	Missing API key	Authorization header not provided
401	Invalid API key	Key not found or inactive
400	Bad Request	Invalid request parameters
429	Rate Limited	Too many requests
500	Server Error	Internal error occurred

---

📝 Content Generation API

Batch Generate Articles

Generate multiple SEO + GEO optimized articles in a single request.

Endpoint: POST /api/v1/batch

Request Body:

{
  "topics": ["How to Rank in ChatGPT", "GEO vs SEO Explained"],
  "language": "en",
  "tone": "professional",
  "count": 5
}

Parameters:

Parameter	Type	Required	Description
topics	string[]	Yes	Array of topics to generate articles for
language	string	No	Language code (default: "en")
tone	string	No	Writing tone: professional, casual, formal (default: "professional")
count	number	No	Max articles to generate, up to 10 (default: 1)

Supported Languages:

• en - English
• nl - Dutch (Nederlands)
• de - German (Deutsch)
• fr - French (Français)
• es - Spanish (Español)
• it - Italian (Italiano)

Response:

{
  "success": true,
  "batch_id": "uuid",
  "articles_generated": 2,
  "articles": [
    {
      "id": "uuid",
      "title": "How to Rank in ChatGPT: Complete 2025 Guide",
      "content": "<h2>Introduction</h2><p>...</p>",
      "topic": "How to Rank in ChatGPT",
      "language": "en",
      "status": "generated",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "credits_used": 2,
  "remaining_credits": 98
}

---

List Generated Articles

Retrieve your generated articles with optional filtering.

Endpoint: POST /api/v1/articles/list

Request Body:

{
  "status": "generated",
  "limit": 10
}

Parameters:

Parameter	Type	Required	Description
status	string	No	Filter by status: "generated", "published"
limit	number	No	Max results to return (default: 10)

Response:

{
  "success": true,
  "count": 5,
  "articles": [
    {
      "id": "uuid",
      "title": "Article Title",
      "content": "<h2>...</h2>",
      "status": "generated",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

---

📰 Blog Posts API (Public)

Retrieve published blog posts. No authentication required.

List Blog Posts

Endpoint: GET /api/blog/posts

Query Parameters:

Parameter	Type	Description
lang	string	Language code (default: "en")
limit	number	Max results (default: 10)
offset	number	Pagination offset (default: 0)

Example Request:

curl "https://launchmind.io/api/blog/posts?lang=en&limit=5"

Response:

[
  {
    "id": "uuid",
    "slug": "how-to-rank-in-chatgpt",
    "title": "How to Rank in ChatGPT",
    "excerpt": "Learn how to optimize...",
    "content": "...",
    "published_at": "2025-01-15T10:00:00Z",
    "language": "en"
  }
]

Get Single Blog Post

Endpoint: GET /api/blog/[slug]

Example:

curl "https://launchmind.io/api/blog/how-to-rank-in-chatgpt"

---

🤖 SEO Agent API

Generate SEO + GEO optimized content with advanced configuration.

Generate Content

Endpoint: POST /api/seo-agent/generate

Request Body:

{
  "clientId": "your-client-id",
  "keyword": "AI website builder",
  "contentType": "blog-post",
  "language": "en",
  "includeBranding": true
}

Parameters:

Parameter	Type	Required	Description
clientId	string	Yes	Your client identifier
keyword	string	Yes	Target keyword for the content
contentType	string	Yes	Type: "blog-post", "landing-page", "product-page"
language	string	No	Language code (default: "en")
includeBranding	boolean	No	Include Launchmind footer (default: true)

Response:

{
  "success": true,
  "data": {
    "content": "# AI Website Builder: Complete Guide...",
    "title": "AI Website Builder: Complete Guide",
    "slug": "ai-website-builder",
    "seoScore": 85,
    "geoScore": 80,
    "wordCount": 2000,
    "includesBranding": true
  }
}

---

📊 Rate Limits

Plan	Requests/Hour	Requests/Day	Articles/Month
Starter	60	1,000	100
Business	300	5,000	500
Enterprise	1000	10,000	100

Rate limit headers are included in every response:

• X-RateLimit-Limit: Total allowed requests
• X-RateLimit-Remaining: Remaining requests
• X-RateLimit-Reset: Timestamp when limit resets

---

📦 Webhooks (Coming Soon)

Configure webhooks to receive real-time notifications:

• Article generation complete
• Content published
• Error notifications

---

🛠️ SDKs & Integrations

WordPress Plugin

Install our WordPress plugin for auto-publishing:

# Coming Q1 2025

JavaScript SDK

import { LaunchmindClient } from '@launchmind/sdk';

const client = new LaunchmindClient('YOUR_API_KEY');

const articles = await client.batch.generate({
  topics: ['GEO optimization tips'],
  language: 'en'
});

---

🆘 Support & Resources

• API Status: status.launchmind.io
• Email: api@launchmind.io
• Response Time: < 24 hours (business days)

Changelog

v1.0 (November 2025)

• Initial API release
• Batch content generation
• Multi-language support
• SEO + GEO optimization