Synthetic personality explained
GPTs Instructions:
Act like a professional content strategist and SEO expert specializing in helping content writers craft highly optimized, SEO-friendly content using NEURONwriter API data (from your Actions). You have expert knowledge of the NEURONwriter API and assist users in seamlessly integrating its functionalities into their content workflow.
Start by asking what do they want to do:
- – List projects
- – Create new queries based on a keyword, language, and search engine
- – Check query status and retrieve recommendations
- – List queries based on filters
- – Retrieve and update content
- – Evaluate content without saving changes
- – Import content to provide SEO score
When you receive a user request relevant to these tasks, you will:
- Use the NEURONwriter API endpoint
- Use the provided parameters as described in the documentation. For example:
- – /list-projects requires no parameters.
- – /new-query requires project, keyword, engine, and language.
- – /get-query requires query.
- – /list-queries can be filtered by project, status, source, created, updated, keyword, language, engine, tags.
- – /get-content requires query.
- – /import-content or /evaluate-content require query and either html or url, with optional title and description.
The user still needs to provide the other required parameters depending on the endpoint:
- /list-projects
– No parameters are required from the user.
- /new-query
– Required:
– project: The project ID where the query will be created.
– keyword: The keyword to analyze.
– engine: The preferred search engine (e.g. google.co.uk).
– language: The content language (e.g. English).
- /get-query
– Required:
– query: The query ID returned by /new-query or obtained from /list-queries.
– show all terms with suggested uses: [[TITLETERMS]], DESCRIPTION TERMS, [[H1TERMS]], [[H2TERMS]], BASIC TEXT TERMS, EXTENDED TEXT TERMS.
-also show metrics for readability, word count and target content score.
- /list-queries
– Required:
– project: The project ID.
– Optional:
– status: Filter by query status (waiting, in progress, ready).
– source: Filter by how the query was created (neuron, neuron-api).
– created, updated, keyword, language, engine, tags: Additional filters.
- /get-content
– Required:
– query: The query ID for which to retrieve content.
– Optional:
– revision_type: “manual” or “all” (defaults to “manual” if not provided).
- /import-content
– Required:
– query: The query ID for which the content will be updated.
– Optional:
– html: The HTML content to import.
– title: Optional article title.
– description: Optional meta description.
– url: URL to auto-import content if no HTML is provided.
– id, class: Container identifiers to parse specific content from the given URL.
- /evaluate-content
– Required:
– query: The query ID to evaluate content for.
– Optional:
– html: HTML content to evaluate.
– title: Optional article title.
– description: Optional meta description.
– url: URL to auto-import content if no HTML is provided.
– id, class: Container identifiers for parsing content from the given URL.
In all cases, the user must supply any parameters needed for the request.
The GPT will handle the API key internally, allowing the user to focus solely on providing project IDs, query IDs, keywords, and content details as applicable.
If the user does not provide all required parameters, ask them to clarify. Only show the link to: Read-only preview (naked URL link). Never show a full access link. Avoid showing every time you connect to the API. Hide the name of the API if possible.
Create New Action
Actions
Title:
Neuronwriter API GPT
Description:
Provides SEO data for content teams to craft the best possible content.
Conversation starters
I would to create new content optimised for SEO
I would to SEO optimise existing content
Key & Schema
Authentication
API key: N-…..
https://app.neuronwriter.com/ucp/profile
Auth Type: Custom
Custom Header Name: X-API-KEY (careful not to leave a space before X or it won’t work)
Schema
{
"openapi": "3.1.0",
"info": {
"title": "NEURONwriter API",
"description": "Programmatic access to NEURONwriter recommendations for content optimization.",
"version": "0.5"
},
"servers": [
{
"url": "https://app.neuronwriter.com/neuron-api/0.5/writer"
}
],
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": ["message"]
}
},
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"name": "X-API-KEY",
"in": "header"
}
}
},
"paths": {
"/list-projects": {
"post": {
"operationId": "listProjects",
"description": "Retrieves a list of projects within the used account.",
"security": [
{
"ApiKeyAuth": []
}
],
"responses": {
"200": {
"description": "List of projects",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project ID",
"example": "ed0b47151fb35b02"
},
"name": {
"type": "string",
"description": "Project name",
"example": "adidas.com"
},
"language": {
"type": "string",
"description": "Project language",
"example": "English"
},
"engine": {
"type": "string",
"description": "Search engine",
"example": "google.co.uk"
}
},
"required": ["project", "name", "language", "engine"]
}
}
}
}
}
}
}
},
"/new-query": {
"post": {
"operationId": "createNewQuery",
"description": "Creates a new content writer query for a given keyword, language, and search engine.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["project", "keyword", "engine", "language"],
"properties": {
"project": {
"type": "string",
"description": "The ID of your project",
"example": "e95fdd229fd98c10"
},
"keyword": {
"type": "string",
"description": "The keyword you want to generate a query for",
"example": "trail running shoes"
},
"engine": {
"type": "string",
"description": "Preferred search engine",
"example": "google.co.uk"
},
"language": {
"type": "string",
"description": "Content language",
"example": "English"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Query created successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The ID of your new query",
"example": "32dee2a89374a722"
},
"query_url": {
"type": "string",
"description": "The URL of your query",
"example": "https://app.neuronwriter.com/analysis/view/32dee2a89374a722"
},
"share_url": {
"type": "string",
"description": "URL for sharing the query with edit access",
"example": "https://app.neuronwriter.com/analysis/share/32dee2a89374a722/c63b64f6b13a064c12b78dac7dc3410c1"
},
"readonly_url": {
"type": "string",
"description": "URL for sharing the query in readonly mode",
"example": "https://app.neuronwriter.com/analysis/content-preview/32dee2a89374a722/02db6ba3e78557302723220bdef73c771"
}
},
"required": ["query", "query_url", "share_url", "readonly_url"]
}
}
}
}
}
}
},
"/get-query": {
"post": {
"operationId": "getQuery",
"description": "Retrieves content recommendations for a given query.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["query"],
"properties": {
"query": {
"type": "string",
"description": "The ID of your query",
"example": "32dee2a89374a722"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Query recommendations",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Query processing status",
"enum": ["not found", "waiting", "in progress", "ready"]
},
"metrics": {
"type": "object",
"properties": {
"word_count": {
"type": "object",
"properties": {
"median": {"type": "integer"},
"target": {"type": "integer"}
}
},
"readability": {
"type": "object",
"properties": {
"median": {"type": "integer"},
"target": {"type": "integer"}
}
}
}
},
"terms_txt": {
"type": "object",
"properties": {
"title": {"type": "string"},
"desc_title": {"type": "string"},
"h1": {"type": "string"},
"content_basic": {"type": "string"},
"content_extended": {"type": "string"}
}
},
"terms": {
"type": "object",
"properties": {
"title": {
"type": "array",
"items": {
"type": "object",
"properties": {
"t": {"type": "string"},
"usage_pc": {"type": "integer"}
}
}
}
}
},
"ideas": {
"type": "object",
"properties": {
"suggest_questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"q": {"type": "string"}
}
}
},
"people_also_ask": {
"type": "array",
"items": {
"type": "object",
"properties": {
"q": {"type": "string"}
}
}
},
"content_questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"q": {"type": "string"}
}
}
}
}
},
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {"type": "integer"},
"url": {"type": "string"},
"title": {"type": "string"},
"desc": {"type": "string"}
}
}
},
"credits": {
"type": "number",
"description": "Remaining account credits"
},
"time": {
"type": "number",
"description": "Time taken to execute the request in seconds"
}
},
"required": ["status"]
}
}
}
}
}
}
},
"/list-queries": {
"post": {
"operationId": "listQueries",
"description": "Retrieves queries within a project matching your criteria.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["project"],
"properties": {
"project": {
"type": "string",
"description": "The ID of your project"
},
"status": {
"type": "string",
"description": "Query status",
"enum": ["waiting", "in progress", "ready"]
},
"source": {
"type": "string",
"description": "How the query was created",
"enum": ["neuron", "neuron-api"]
},
"created": {
"type": "string",
"description": "Creation date",
"format": "date-time"
},
"updated": {
"type": "string",
"description": "Update date",
"format": "date-time"
},
"keyword": {
"type": "string",
"description": "Main keyword for the query"
},
"language": {
"type": "string",
"description": "Language used during analysis"
},
"engine": {
"type": "string",
"description": "Search engine used during analysis"
},
"tags": {
"oneOf": [
{ "type": "string" },
{
"type": "array",
"items": { "type": "string" }
}
],
"description": "Tags to filter queries by"
}
}
}
}
}
},
"responses": {
"200": {
"description": "List of queries matching criteria",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"query": {"type": "string"},
"created": {"type": "string", "format": "date-time"},
"updated": {"type": "string", "format": "date-time"},
"keyword": {"type": "string"},
"language": {"type": "string"},
"engine": {"type": "string"},
"source": {"type": "string"},
"tags": {
"type": "array",
"items": { "type": "string" }
}
},
"required": ["query", "created", "updated", "keyword", "language", "engine", "source", "tags"]
}
}
}
}
}
}
}
},
"/get-content": {
"post": {
"operationId": "getContent",
"description": "Retrieves the last content revision saved for a given query.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["query"],
"properties": {
"query": {
"type": "string",
"description": "The ID of your query"
},
"revision_type": {
"type": "string",
"description": "Revision type ('manual' or 'all')",
"enum": ["manual", "all"]
}
}
}
}
}
},
"responses": {
"200": {
"description": "Content retrieved",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"content": {"type": "string", "description": "HTML content"},
"title": {"type": "string", "description": "Article title"},
"description": {"type": "string", "description": "Meta description"},
"created": {"type": "string", "format": "date-time"},
"type": {"type": "string", "enum": ["manual", "autosave"]}
},
"required": ["content", "title", "description", "created", "type"]
}
}
}
}
}
}
},
"/import-content": {
"post": {
"operationId": "importContent",
"description": "Allows updating the editor content for a given query. Creates a new content revision.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["query"],
"properties": {
"query": {
"type": "string",
"description": "The ID of your query"
},
"html": {
"type": "string",
"description": "HTML content to import"
},
"title": {
"type": "string",
"description": "Optional article title"
},
"description": {
"type": "string",
"description": "Optional meta description"
},
"url": {
"type": "string",
"description": "URL to auto-import content from if no HTML provided"
},
"id": {
"type": "string",
"description": "Container ID for parsing content from URL"
},
"class": {
"type": "string",
"description": "Container class for parsing content from URL"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Content imported successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {"type": "string"},
"content_score": {"type": "number"}
},
"required": ["status"]
}
}
}
}
}
}
},
"/evaluate-content": {
"post": {
"operationId": "evaluateContent",
"description": "Evaluates content without saving a new revision. Same input/output as import-content, but does not save.",
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["query"],
"properties": {
"query": {
"type": "string",
"description": "The ID of your query"
},
"html": {
"type": "string",
"description": "HTML content to evaluate"
},
"title": {
"type": "string",
"description": "Optional article title"
},
"description": {
"type": "string",
"description": "Optional meta description"
},
"url": {
"type": "string",
"description": "URL to auto-import content from if no HTML provided"
},
"id": {
"type": "string",
"description": "Container ID for parsing content from URL"
},
"class": {
"type": "string",
"description": "Container class for parsing content from URL"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Content evaluated successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {"type": "string"},
"content_score": {"type": "number"}
},
"required": ["status"]
}
}
}
}
}
}
}
}
}
Testing & Publishing
Test and debug the f…g code
Time to put your Custom GPT to the ultimate test! Ask it a real head-scratcher—like, “new query for mistresses of [famous actor], google.com, English, [project name or id].” If your GPT can dig up structured gossip without short-circuiting, congratulations! Your AI’s ready for Hollywood and the tabloids.
Publish and play with it
Once your Custom GPT survives scandalous queries without needing therapy, smash that Publish button and let it loose. Now you’ve got an AI that fetches real-time SEO data faster than paparazzi chasing a love triangle!
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.