Skip to main content
Use NEURONwriter through Corsair: one client, typed API calls. The API needs a Gold plan or higher. Copy the key from your profile, under the “Neuron API access” tab. Every request is a POST to https://app.neuronwriter.com/neuron-api/0.5/writer/{method} with the key in the X-API-KEY header. The workflow is two calls, and they behave differently:
  • analysis.start queues work; it does not return results. It answers a query id and three URLs, and takes about a minute before the recommendations exist.
  • analysis.get is the poll. It answers { status } alone while the analysis is waiting or in progress, and adds metrics, terms, terms_txt, ideas and competitors only once status is ready. So the response type has those fields optional, and a caller branches on the status rather than assuming they are there.
What costs money and what does not:
  • analysis.start spends one Content Writer analysis from the account’s monthly limit, the same as creating one in the app. At the Gold plan’s 75 analyses, the API and the app share that total.
  • analysis.get spends nothing. Polling it as often as needed is free.
  • content.import saves a revision; content.evaluate does not. Both take the same body and return the same shape. Use evaluate to score a draft, then import once it is ready, and the revision history stays clean.
What to know when sizing and shaping a request:
  • competitors_mode changes the SERP sample. The default top10 analyses the ten top results, top30 the thirty, and top-intent up to ten pages matching the dominant intent.
  • A query and a project are different ids. The project id is in the project URL, and the query id comes back from analysis.start or queries.list.
  • queries.list filters by tags with AND. Every tag sent has to be on the query, and one string behaves the same as a list of one.
  • Import takes HTML or a URL, never both. When importing from a URL, id and class select the container to read.
Errors are thin: a bad or inactive key is the only documented failure, a 401 with { "error": "..." }. The auth check runs before routing, so a bad key hides whether a method exists. What you get:
  • 7 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

List the account’s projects
Queue an analysis for one keyword
See the full list on the API page.

What’s next

API reference

Every neuronwriter.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.