Skip to content

/list-queries

Retrieves queries within a project matching your criteria, and reports their status (whether they are ready, etc.).

  • Method: POST
  • Endpoint: https://app.neuronwriter.com/neuron-api/0.5/writer/list-queries

Parameters

ParameterExampleDescription
project0c30b6a4f8b2b412The ID of your project.
statusreadyQuery status: waiting, in progress, ready.
sourceneuron-apiHow the query was created: neuron, neuron-api.
created2024-01-19T14:48:31+00:00Creation date filter.
updated2024-01-19T14:49:52+00:00Update date filter (when the query became ready).
keywordtrail running shoesMain keyword filter.
languageEnglishLanguage used during analysis.
enginegoogle.comSearch engine used during analysis.
tagsDoneLimit results to queries with one or more tags. Single tag string, or a list (all must be present): ['MyNewTag', 'Done'].

Response

A list of queries:

json
[
  {"query": "a6d0fb2bf9a7a2be", "created": "2024-01-19T14:48:31+00:00", "updated": "2024-01-19T14:49:52+00:00", "keyword": "how should running shoes fit", "language": "English", "engine": "google.co.uk", "source": "neuron-api", "tags": ["Done"]},
  {"query": "bdc73d8e0057ed8f", "created": "2024-01-19T14:48:31+00:00", "updated": "2024-01-19T14:49:52+00:00", "keyword": "trail running shoes for winter", "language": "English", "engine": "google.co.uk", "source": "neuron-api", "tags": ["Done"]}
]

Tag-driven pipelines

Filtering by tags (for example Done) is the cleanest way to pull only finished, human-approved queries into a downstream automation.