NeuronWriter API

Fresh Beta

The NeuronWriter API gives you programmatic access to NeuronWriter's content recommendations. With it you can:

• Add new queries in bulk and retrieve the share URLs
• Pull NLP term recommendations, entities, questions, competitors, and SERP intent into your own content generation pipeline
• Import drafted HTML back into the editor and score it programmatically

Start fast

The quickest way to start is to jump straight to the Usage Examples.

Requirements & cost

Requirement	Detail
Plan	Gold plan or higher
Monthly limits	API requests consume your monthly query limit. Creating a query via the API costs the same as creating it in the interface.
Skill level	Basic understanding of HTTP requests and a language like Python, PHP, or Node.

Base endpoint

https://app.neuronwriter.com/neuron-api/0.5/writer

Append the method name to this base (for example .../0.5/writer/new-query). Unless stated otherwise, every method is a POST request with a JSON body.

Authentication

Every request must include the X-API-KEY HTTP header with your Neuron API key.

X-API-KEY: <your-neuron-api-key>
Accept: application/json
Content-Type: application/json

Where to get your API key

Open your profile, go to the Neuron API access tab, and copy your API key.

[image: Neuron API access tab in profile settings]

Methods at a glance

Method	Purpose
/list-projects	List all projects in the account
/new-query	Create a new content writer query for a keyword
/get-query	Retrieve recommendations (terms, entities, questions, competitors, intent)
/list-queries	List queries in a project, filter by status/tags/date
/get-content	Retrieve the last saved content revision
/import-content	Push HTML (or a URL to auto-import) into the editor
/evaluate-content	Score content without saving a revision

Typical flow

flowchart LR
  A[/new-query/] -->|wait ~60s| B[/get-query/]
  B --> C{status == ready?}
  C -->|no| B
  C -->|yes| D[Use terms, entities, questions]
  D --> E[Generate / optimize draft]
  E --> F[/evaluate-content/ or /import-content/]