Lexigen

Getting started

Quickstart

Lexigen’s Keyword-to-Blog API turns keywords into a structured, SEO-formatted blog post. This page walks through your first request: synchronous generation first, then the asynchronous job and webhook pattern that suits batch pipelines.

Base URL

Every endpoint lives under https://lexigen.app/api/v1, so POST /v1/generate is https://lexigen.app/api/v1/generate. The shorter https://lexigen.app/v1/... form is an equivalent alias. Every example in these docs uses the full form.

1. Get an API key

  1. Sign in and open API keys in your dashboard.
  2. Give the key a name, pick a live or test label, and click “Create API key”. The label is for your own bookkeeping. Both kinds of key generate real content and count toward the same limits.
  3. Copy the key straight away. It is shown only once.

Keep the key out of source control, for example in a local .env file that your shell or app loads:

.env
KEYWORD_TO_BLOG_API_KEY="YOUR_API_KEY"

Send it as Authorization: Bearer <key> (shown below) or as an X-API-Key header.

2. Synchronous generation

The full article comes back in the response. Generation is not instant: with a targetUrl, the page is read on every request to build a fact sheet, so expect roughly 60–110 seconds. Set your HTTP client’s timeout to allow for that, or use a job (step 3).

shell
curl -X POST https://lexigen.app/api/v1/generate \
  -H "Authorization: Bearer $KEYWORD_TO_BLOG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": [
    "ai content marketing",
    "small business seo"
  ],
  "topic": "How small businesses can use AI content marketing without losing their voice",
  "language": "en",
  "region": "US",
  "tone": "friendly",
  "targetAudience": "small business owners with no in-house marketing team",
  "brandVoice": "warm, practical, no jargon",
  "industry": "marketing services",
  "constraints": {
    "maxSections": 6,
    "includeFAQs": true,
    "keywordUsageStrategy": "natural"
  },
  "format": {
    "responseTypes": [
      "json",
      "markdown"
    ]
  },
  "clientProvidedRequestId": "req_local_0192"
}'

Example response:

200 OK
{
  "requestId": "req_9f3a1c2e4b",
  "post": {
    "title": "AI Content Marketing for Small Businesses: A Practical Starting Point",
    "slugSuggestion": "ai-content-marketing-small-business",
    "meta": {
      "description": "A practical guide to using AI content marketing as a small business, without losing the voice your customers already trust.",
      "primaryKeyword": "ai content marketing"
    },
    "outline": {
      "h1": "AI Content Marketing for Small Businesses: A Practical Starting Point",
      "h2": [
        "Why small businesses are turning to AI content marketing",
        "Where AI helps most, and where it doesn't",
        "Keeping your brand voice consistent",
        "A simple weekly workflow",
        "Frequently asked questions"
      ]
    },
    "sections": [
      {
        "type": "introduction",
        "contentMarkdown": "Most small business owners don't have a marketing department. AI content marketing tools promise to fill that gap, but the real question isn't whether AI can write — it's whether it can write like *you*."
      },
      {
        "type": "body",
        "heading": "Why small businesses are turning to AI content marketing",
        "contentMarkdown": "Small business SEO used to mean choosing between hiring a writer or falling behind. AI content marketing changes that math by making a consistent publishing schedule achievable without a full-time hire."
      },
      {
        "type": "body",
        "heading": "Where AI helps most, and where it doesn't",
        "contentMarkdown": "AI is strongest at first drafts, outlines, and repetitive formats like FAQs. It's weakest at judgment calls that depend on knowing your actual customers — so keep a human review step for anything customer-facing."
      },
      {
        "type": "callout",
        "contentMarkdown": "A five-minute voice check before publishing catches most AI-sounding phrasing.",
        "callout": {
          "label": "Quick tip",
          "text": "Read the draft aloud. If it doesn't sound like something you'd actually say to a customer, rewrite that line."
        }
      },
      {
        "type": "body",
        "heading": "Keeping your brand voice consistent",
        "contentMarkdown": "Give the tool a short brand voice brief once, then reuse it: three adjectives, one thing you never say, and one real customer question you hear often."
      },
      {
        "type": "body",
        "heading": "A simple weekly workflow",
        "contentMarkdown": "Draft on Monday, review and edit Tuesday, publish Wednesday. Keeping a fixed cadence matters more than any individual post."
      },
      {
        "type": "faq",
        "heading": "Frequently asked questions",
        "contentMarkdown": ""
      },
      {
        "type": "conclusion",
        "contentMarkdown": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass."
      }
    ],
    "faqs": [
      {
        "question": "Will AI-written content hurt my SEO?",
        "answer": "Search engines rank content on quality and usefulness, not on how it was drafted. Editing for accuracy and voice before publishing is what matters."
      },
      {
        "question": "How much editing does an AI draft usually need?",
        "answer": "Expect to adjust specific claims, add real examples from your business, and tighten anything that reads generic."
      }
    ],
    "conclusion": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass.",
    "coverageNotes": {
      "keywordCoverage": [
        {
          "keyword": "ai content marketing",
          "covered": true,
          "evidence": "Appears in title, H1, and introduction."
        },
        {
          "keyword": "small business seo",
          "covered": true,
          "evidence": "Appears in the second H2 section."
        }
      ]
    }
  },
  "rendered": {
    "markdown": "# AI Content Marketing for Small Businesses: A Practical Starting Point\n\nMost small business owners don't have a marketing department..."
  },
  "quality": {
    "status": "pass",
    "score": 93,
    "revisionCount": 0,
    "qualityVersion": "3.0.0",
    "qa": {
      "qaVersion": "engine-qa-1",
      "pass": true,
      "score": 95,
      "failingGates": [],
      "wordCount": 1120,
      "metrics": {
        "hedgeWords": 4,
        "hedgePer1000": 3.57,
        "keywordPhrase": "ai content marketing",
        "keywordOccurrences": 4,
        "keywordDensityPct": 0.36,
        "keywordMaxPerParagraph": 1,
        "brandName": "",
        "brandOccurrences": 0,
        "brandDensityPct": 0,
        "brandMaxPerParagraph": 0,
        "concreteFigures": 0,
        "claims": {
          "total": 1,
          "supported": 0,
          "unsupported": 1,
          "contradicted": 0,
          "omitted": 1
        },
        "verdictPresent": false,
        "brandCasingViolations": []
      },
      "gates": [
        {
          "name": "claims.contradicted",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 0
        },
        {
          "name": "claims.unsupported",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 2
        },
        {
          "name": "hedges.per1000",
          "pass": true,
          "blocking": true,
          "value": 3.57,
          "threshold": 8
        },
        {
          "name": "keyword.density",
          "pass": true,
          "blocking": true,
          "value": 0.36,
          "threshold": 0.8
        },
        {
          "name": "keyword.perParagraph",
          "pass": true,
          "blocking": true,
          "value": 1,
          "threshold": 1
        },
        {
          "name": "keyword.present",
          "pass": true,
          "blocking": false,
          "value": 4
        },
        {
          "name": "openers.boilerplate",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 0
        },
        {
          "name": "title.recycled",
          "pass": true,
          "blocking": true
        },
        {
          "name": "facts.available",
          "pass": false,
          "blocking": false,
          "value": "no_facts",
          "detail": "no targetUrl — general article without specific prices, plans or policies"
        },
        {
          "name": "editorial.checks",
          "pass": true,
          "blocking": false,
          "value": 0
        }
      ],
      "claims": [
        {
          "id": "C1",
          "text": "Most small businesses publish 4 posts a month.",
          "location": "s1.p0.2",
          "citedFactIds": [],
          "label": "unsupported",
          "reason": "states a figure (num:4) with no fact sheet to support it",
          "omitted": true
        }
      ],
      "fixes": [
        "omitted 1 unsupported claim sentence(s)"
      ],
      "attempts": 1,
      "warnings": [],
      "facts": {
        "mode": "no_facts",
        "brandName": null,
        "requestedUrls": [],
        "allowedDomains": [],
        "sources": [],
        "facts": [],
        "droppedQuoteMismatch": 0,
        "fetchErrors": [],
        "webFetch": null
      }
    }
  }
}

Check quality.status and quality.qa.failingGates before you publish. An article is returned even when a quality gate still fails. See the content quality pipeline.

3. Asynchronous generation + webhook

Best for batch pipelines: create a job, then poll it or let your webhook endpoint receive the result. The webhook block is optional.

shell
curl -X POST https://lexigen.app/api/v1/jobs \
  -H "Authorization: Bearer $KEYWORD_TO_BLOG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "generateRequest": {
    "keywords": [
      "ai content marketing",
      "small business seo"
    ],
    "topic": "How small businesses can use AI content marketing without losing their voice",
    "language": "en",
    "region": "US",
    "tone": "friendly",
    "targetAudience": "small business owners with no in-house marketing team",
    "brandVoice": "warm, practical, no jargon",
    "industry": "marketing services",
    "constraints": {
      "maxSections": 6,
      "includeFAQs": true,
      "keywordUsageStrategy": "natural"
    },
    "format": {
      "responseTypes": [
        "json",
        "markdown"
      ]
    },
    "clientProvidedRequestId": "req_local_0192"
  },
  "webhook": {
    "url": "https://example.com/webhooks/lexigen",
    "events": [
      "job.succeeded",
      "job.failed"
    ]
  },
  "format": {
    "responseTypes": [
      "json",
      "markdown"
    ]
  },
  "idempotencyKey": "job_create_local_0192"
}'

The 202 response carries the jobId and, when you configured a webhook, a one-time webhookSigningSecret. Store the secret, because it is never shown again. Then poll for the result:

shell
curl https://lexigen.app/api/v1/jobs/job_5f2a9d3e1b \
  -H "Authorization: Bearer $KEYWORD_TO_BLOG_API_KEY"

Or receive it at your webhook URL (see verifying signatures):

POST your-webhook-url
{
  "event": "job.succeeded",
  "jobId": "job_5f2a9d3e1b",
  "requestId": "req_9f3a1c2e4b",
  "post": {
    "title": "AI Content Marketing for Small Businesses: A Practical Starting Point",
    "slugSuggestion": "ai-content-marketing-small-business",
    "meta": {
      "description": "A practical guide to using AI content marketing as a small business, without losing the voice your customers already trust.",
      "primaryKeyword": "ai content marketing"
    },
    "outline": {
      "h1": "AI Content Marketing for Small Businesses: A Practical Starting Point",
      "h2": [
        "Why small businesses are turning to AI content marketing",
        "Where AI helps most, and where it doesn't",
        "Keeping your brand voice consistent",
        "A simple weekly workflow",
        "Frequently asked questions"
      ]
    },
    "sections": [
      {
        "type": "introduction",
        "contentMarkdown": "Most small business owners don't have a marketing department. AI content marketing tools promise to fill that gap, but the real question isn't whether AI can write — it's whether it can write like *you*."
      },
      {
        "type": "body",
        "heading": "Why small businesses are turning to AI content marketing",
        "contentMarkdown": "Small business SEO used to mean choosing between hiring a writer or falling behind. AI content marketing changes that math by making a consistent publishing schedule achievable without a full-time hire."
      },
      {
        "type": "body",
        "heading": "Where AI helps most, and where it doesn't",
        "contentMarkdown": "AI is strongest at first drafts, outlines, and repetitive formats like FAQs. It's weakest at judgment calls that depend on knowing your actual customers — so keep a human review step for anything customer-facing."
      },
      {
        "type": "callout",
        "contentMarkdown": "A five-minute voice check before publishing catches most AI-sounding phrasing.",
        "callout": {
          "label": "Quick tip",
          "text": "Read the draft aloud. If it doesn't sound like something you'd actually say to a customer, rewrite that line."
        }
      },
      {
        "type": "body",
        "heading": "Keeping your brand voice consistent",
        "contentMarkdown": "Give the tool a short brand voice brief once, then reuse it: three adjectives, one thing you never say, and one real customer question you hear often."
      },
      {
        "type": "body",
        "heading": "A simple weekly workflow",
        "contentMarkdown": "Draft on Monday, review and edit Tuesday, publish Wednesday. Keeping a fixed cadence matters more than any individual post."
      },
      {
        "type": "faq",
        "heading": "Frequently asked questions",
        "contentMarkdown": ""
      },
      {
        "type": "conclusion",
        "contentMarkdown": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass."
      }
    ],
    "faqs": [
      {
        "question": "Will AI-written content hurt my SEO?",
        "answer": "Search engines rank content on quality and usefulness, not on how it was drafted. Editing for accuracy and voice before publishing is what matters."
      },
      {
        "question": "How much editing does an AI draft usually need?",
        "answer": "Expect to adjust specific claims, add real examples from your business, and tighten anything that reads generic."
      }
    ],
    "conclusion": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass.",
    "coverageNotes": {
      "keywordCoverage": [
        {
          "keyword": "ai content marketing",
          "covered": true,
          "evidence": "Appears in title, H1, and introduction."
        },
        {
          "keyword": "small business seo",
          "covered": true,
          "evidence": "Appears in the second H2 section."
        }
      ]
    }
  },
  "rendered": {
    "markdown": "# AI Content Marketing for Small Businesses: A Practical Starting Point\n\nMost small business owners don't have a marketing department..."
  },
  "quality": {
    "status": "pass",
    "score": 93,
    "revisionCount": 0,
    "qualityVersion": "3.0.0",
    "qa": {
      "qaVersion": "engine-qa-1",
      "pass": true,
      "score": 95,
      "failingGates": [],
      "wordCount": 1120,
      "metrics": {
        "hedgeWords": 4,
        "hedgePer1000": 3.57,
        "keywordPhrase": "ai content marketing",
        "keywordOccurrences": 4,
        "keywordDensityPct": 0.36,
        "keywordMaxPerParagraph": 1,
        "brandName": "",
        "brandOccurrences": 0,
        "brandDensityPct": 0,
        "brandMaxPerParagraph": 0,
        "concreteFigures": 0,
        "claims": {
          "total": 1,
          "supported": 0,
          "unsupported": 1,
          "contradicted": 0,
          "omitted": 1
        },
        "verdictPresent": false,
        "brandCasingViolations": []
      },
      "gates": [
        {
          "name": "claims.contradicted",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 0
        },
        {
          "name": "claims.unsupported",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 2
        },
        {
          "name": "hedges.per1000",
          "pass": true,
          "blocking": true,
          "value": 3.57,
          "threshold": 8
        },
        {
          "name": "keyword.density",
          "pass": true,
          "blocking": true,
          "value": 0.36,
          "threshold": 0.8
        },
        {
          "name": "keyword.perParagraph",
          "pass": true,
          "blocking": true,
          "value": 1,
          "threshold": 1
        },
        {
          "name": "keyword.present",
          "pass": true,
          "blocking": false,
          "value": 4
        },
        {
          "name": "openers.boilerplate",
          "pass": true,
          "blocking": true,
          "value": 0,
          "threshold": 0
        },
        {
          "name": "title.recycled",
          "pass": true,
          "blocking": true
        },
        {
          "name": "facts.available",
          "pass": false,
          "blocking": false,
          "value": "no_facts",
          "detail": "no targetUrl — general article without specific prices, plans or policies"
        },
        {
          "name": "editorial.checks",
          "pass": true,
          "blocking": false,
          "value": 0
        }
      ],
      "claims": [
        {
          "id": "C1",
          "text": "Most small businesses publish 4 posts a month.",
          "location": "s1.p0.2",
          "citedFactIds": [],
          "label": "unsupported",
          "reason": "states a figure (num:4) with no fact sheet to support it",
          "omitted": true
        }
      ],
      "fixes": [
        "omitted 1 unsupported claim sentence(s)"
      ],
      "attempts": 1,
      "warnings": [],
      "facts": {
        "mode": "no_facts",
        "brandName": null,
        "requestedUrls": [],
        "allowedDomains": [],
        "sources": [],
        "facts": [],
        "droppedQuoteMismatch": 0,
        "fetchErrors": [],
        "webFetch": null
      }
    }
  }
}

Next steps