REST API v2

Programmatic SEO articles from $0.50 each

Prepaid credit packs from $0.60/article. No subscription. Integrate from your own stack.

-H "Authorization: Bearer $KEY" \
-d '{"primary_keyword":"crm startups"}'
✔ 201 — job queued
→ id: a1b2c3d4
researching → drafting → published
✔ published — markdown + schema ready

One POST to start, then GET polls on a separate per-minute limit.

Dashboard vs API

From $0.97/article

Dashboard

Editor UI, approvals, and CMS connectors
Subscription quota with optional overage
Campaigns, review queues, and team seats

Compare plans

Developer path

From $0.60/article

Developer API

REST v2: start jobs, poll status, pull markdown
Credits never expire; scale concurrency by pack
Cron, workers, or your own backend

Get API credits

CompareDashboardDeveloper API

Best for

Teams using CMS workflows, campaigns, and review queues

Developers, cron jobs, and multi-app content pipelines

Billing

Monthly subscription with article quota

One-time prepaid packs ($0.60 to $0.50/article)

Lock-in

Plan renews monthly

No subscription required

Credits

Monthly quota + optional overage

Prepaid balance, no monthly reset

Concurrency

Portal generation limits

5 / 10 / 20 parallel jobs by pack tier

Credit packs

Buy once, use anytime. Credits never expire. Higher packs unlock more parallel generations and lower per-article cost.

Side Project Pack

$30one-time

50 articles · $0.60 each

Ship one app or test the API locally.

5 concurrent generations
10 article starts/min (POST)
150 status polls/min (GET)

Get started

Indie SaaS Pack

$55one-time

100 articles · $0.55 each

Cron-driven content for one product or a couple of client sites.

10 concurrent generations
20 article starts/min (POST)
300 status polls/min (GET)

Get started

Scale Pack

$100one-time

200 articles · $0.50 each

Programmatic SEO across several sites or a content-heavy launch.

20 concurrent generations
30 article starts/min (POST)
600 status polls/min (GET)

Get started

How it works

Create an account and buy a credit pack in the Developer hub.
POST /api/v2/articles with your keyword, intent category, and optional brand voice overrides.
GET /api/v2/articles/:id until status is published.
Optional: configure webhooks in the portal for article.generated, article.published, and other lifecycle events.

API reference

Start a generation job, poll until the article is ready, and optionally override brand voice, reader perspective, and article category per request. Authenticate with a Bearer API key from the Developer hub.

Create article

POST/api/v2/articles

Starts an async SEO article generation job. Returns 202 with an article id and poll_url. Consumes one API credit per successful start (by pack tier).

Body Parameters

JSON

primary_keywordrequired
string
Main SEO keyword or phrase the article should rank for. Drives research, outline, and on-page optimization.
secondary_keywords
array of string
Optional supporting keywords. When omitted, GeoCopy derives related terms from the primary keyword and intent category.
intent_category
string — "informational" | "how_to" | "comparison" | "commercial" | "transactional" | "listicle" | "local"
Article format / search intent category. Controls outline structure, word-count targets, and module selection. Default: informational.
search_intent
string
Free-text search intent label stored on the article (e.g. informational, commercial). Defaults to informational when omitted. Default: informational.
topic
string
Optional title or topic override. When omitted, the primary keyword is used as the working title.
target_word_count
integer
Target article length in words. When omitted, GeoCopy uses the default for the intent category (typically ~1,200–1,800).
length_preference
"shorter" | "standard" | "comprehensive" — "shorter" | "standard" | "comprehensive"
Pipeline length bias applied on top of the category default.
reader_voice
string — "practitioner" | "expert_authority" | "editorial"
Narrative perspective preset. Practitioner allows first person where appropriate; expert_authority is third-person peer voice; editorial is reportage-style. Default: expert_authority (or your Developer hub default).
brand_voice
string or object
Brand voice override as plain text or a JSON brand-voice document (tone, vocabulary, example phrases). When omitted, your account brand brief from the Developer hub is used.
first_person_stance
string — "I" | "we" | "our team" | "the team" | "none"
First-person pronoun policy merged into brand voice when using a JSON brand_voice object. Use none to forbid first person.

Create article

curl -X POST https://app.geocopy.io/api/v2/articles \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "primary_keyword": "best project management tools for remote teams",
  "secondary_keywords": [
    "remote team collaboration",
    "async project management"
  ],
  "intent_category": "comparison",
  "search_intent": "commercial",
  "topic": "Best Project Management Tools for Remote Teams (2026)",
  "target_word_count": 1800,
  "length_preference": "standard",
  "reader_voice": "practitioner",
  "first_person_stance": "we",
  "brand_voice": {
    "tone": "Direct, practical B2B SaaS — no hype.",
    "first_person_stance": "we",
    "vocabulary_to_avoid": [
      "synergy",
      "leverage",
      "game-changer"
    ]
  }
}'

Response202

{
  "id": "26d80e87-2ee5-4ba8-982b-1c0f0f08dc73",
  "status": "queued",
  "poll_url": "/api/v2/articles/26d80e87-2ee5-4ba8-982b-1c0f0f08dc73",
  "billing": {
    "creation_channel": "api",
    "charged_via": "api_credit",
    "charged_at": "2026-05-30T12:00:00.000Z",
    "export_is_billed": false,
    "charge_timing": "on_create",
    "credits_remaining": 47
  }
}

Retrieve article

GET/api/v2/articles/:id

Poll job status until the article reaches a terminal state (published, failed, or rejected). Returns the full nested document including markdown body, metadata, and billing when complete.

Path Parameters

JSON

idrequired
string (uuid)
Article ID returned from POST /api/v2/articles.

From production pipelineRetrieve example based on: Javascript Chrome Enable: Fix Broken Sites in Chrome

Retrieve article

curl -s "https://app.geocopy.io/api/v2/articles/YOUR_ARTICLE_ID" \
  -H "Authorization: Bearer sk_live_your_key_here"

Response200

{
  "id": "26d80e87-2ee5-4ba8-982b-1c0f0f08dc73",
  "status": "awaiting_approval",
  "created_at": "2026-08-30T20:57:14.448Z",
  "updated_at": "2026-08-30T20:57:41.614Z",
  "published_at": null,
  "meta": {
    "title": "Javascript Chrome Enable: Fix Broken Sites in Chrome",
    "slug": "javascript-chrome-enable-guide-2026",
    "summary": "If your Chrome pages look “stuck” or buttons don’t work, you may need javascript chrome enable. Learn how to turn JavaScript on safely and verify fixes quickly.",
    "primary_keyword": "javascript chrome enable",
    "keywords_targeted": [
      "javascript chrome enable"
    ],
    "search_intent": "informational",
    "meta_title": "Javascript Chrome Enable: Fix Broken Sites in Chrome",
    "meta_description": "javascript chrome enable to fix half-loaded pages fast. Learn how to turn on JavaScript in Chrome—then test your site properly.",
    "word_count": 1167,
    "reading_time_minutes": 6
  },
  "images": {
    "featured": "https://images.pexels.com/photos/270360/pexels-photo-270360.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
    "alt_text": "How to Enable JavaScript in Chrome for Faster, Working Sites - featured image"
  },
  "content": {
    "format": "markdown",
    "body": "# How to Enable JavaScript in Chrome for Faster, Working Sites\n\nIf you’re staring at a half-loaded page, broken buttons, or a site that looks “stuck,” your javascript chrome enable settings might be the culprit. JavaScript is what many modern sites use to render content, run interactive features, and connect UI to real data. When it’s blocked (even for one site), the page can fall back to a static shell that feels broken even though the page “loads.”\n\n## How Do I Enable JavaS\n\n…",
    "html": null
  },
  "schema_jsonld": {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "Javascript Chrome Enable: Fix Broken Sites in Chrome",
    "_note": "Full JSON-LD included in production responses"
  },
  "links": {
    "external_url": null,
    "external_post_id": null
  },
  "billing": {
    "creation_channel": "portal",
    "charged_via": "trial",
    "charged_at": "2026-08-30T20:57:16.758Z",
    "export_is_billed": false
  }
}

Rate limits

GeoCopy rate-limits the API on three independent axes: concurrent jobs, article starts, and status polls. Polling does not compete with new generations.

Concurrent jobs cap how many articles can be in-flight at once (queued through drafting, until published, failed, rejected, or archived). Article starts measure POST /api/v2/articles calls per minute. Each successful start consumes one API credit and queues a new job. Status polls measure GET traffic to /api/v2/articles, /api/v2/articles/:id, and /api/v2/account per minute in a separate bucket, so a tight poll loop will not reduce how many articles you can start.

Limits are set by your highest active credit pack. If you buy a larger pack later, concurrency and per-minute ceilings increase immediately. When you exceed a limit, the API returns HTTP 429 with a Retry-After hint. Check your live caps anytime with GET /api/v2/account.

Side Project Pack

50 articles · $0.60 each

5
parallel: 10
POST / min: 150
GET / min

Indie SaaS Pack

Popular

100 articles · $0.55 each

10
parallel: 20
POST / min: 300
GET / min

Scale Pack

200 articles · $0.50 each

20
parallel: 30
POST / min: 600
GET / min

Credit pack	Parallel jobsIn-flight generations at the same time	Article startsPOST /api/v2/articles per minute	Status pollsGET polls & account checks per minute
Side Project Pack 50 articles · $30 pack	5	10	150
Indie SaaS Pack 100 articles · $55 pack	10	20	300
Scale Pack 200 articles · $100 pack	20	30	600

Credit pack

Parallel jobsIn-flight generations at the same time

Article startsPOST /api/v2/articles per minute

Status pollsGET polls & account checks per minute

Side Project Pack

50 articles · $30 pack

150

Indie SaaS Pack

100 articles · $55 pack

300

Scale Pack

200 articles · $100 pack

600

Per-minute counters reset on a rolling 60-second window. Concurrent slots free up when a job reaches a terminal status. Exceeding a limit returns 429 Too Many Requests with Retry-After when applicable.

REST API on every plan

Every paid plan can enable REST API access. Starter includes Tier 1 throughput, Growth Tier 2, Pro Tier 3. Each API article uses your plan quota unless you have prepaid credits.

Need API-only, prepaid credits? See Developer API pricing.

Developer API

Need CMS workflows and team seats? Compare dashboard plans