Appearance
/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
| Parameter | Example | Description |
|---|---|---|
project | 0c30b6a4f8b2b412 | The ID of your project. |
status | ready | Query status: waiting, in progress, ready. |
source | neuron-api | How the query was created: neuron, neuron-api. |
created | 2024-01-19T14:48:31+00:00 | Creation date filter. |
updated | 2024-01-19T14:49:52+00:00 | Update date filter (when the query became ready). |
keyword | trail running shoes | Main keyword filter. |
language | English | Language used during analysis. |
engine | google.com | Search engine used during analysis. |
tags | Done | Limit 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.