GEO Writer

Crie e faça a gestão de tarefas do GEO Writer com IA. As tarefas são processadas de forma assíncrona, por isso crie uma e faça polling até estar concluída.

POST`/intelligence_tasks`

Crie uma tarefa do GEO Writer. Dois modos: baseado em prompt (indique prompt_id) ou agêntico (indique custom_topic e/ou user_instructions).

Corpo (JSON):

project_idobrigatório
task_typeobrigatório: brief, create, update, pr_insights, custom
prompt_id
custom_topic
user_instructions
output_language_code
existing_content
existing_content_url

GET`/intelligence_tasks`

Liste as tarefas do GEO Writer de um projeto com filtragem opcional.

Parâmetros:

project_idobrigatório
task_type
status
page
per_page

GET`/intelligence_tasks/:id`

Obtenha os detalhes completos da tarefa, incluindo os dados do resultado quando estiver concluída. Aceita o ID numérico ou o public_id.

Parâmetros:

project_idobrigatório
:idID da tarefa ou public_id no URL

PATCH`/intelligence_tasks/:id`

Edite blocos de texto existentes de uma tarefa concluída sem a regenerar. Cada chave de edits é um caminho com pontos para um valor de texto de result_data (por exemplo, sections.0.content) e só é possível alterar texto existente. Um valor igual ao texto guardado é ignorado e a primeira edição guarda uma cópia da versão de IA para que possa ser restaurada.

Corpo (JSON):

project_idobrigatório
:idID da tarefa ou public_id no URL
editsobrigatório, objeto que associa caminhos em notação de pontos ao novo texto

Requer uma chave de API com âmbito de escrita.

POST`/intelligence_tasks/:id/revert`

Descarta todas as edições manuais e restaura a versão de IA guardada na primeira edição. Devolve ERR_INVALID_PARAM quando a tarefa não tem edições manuais.

Parâmetros:

project_idobrigatório
:idID da tarefa ou public_id no URL

Requer uma chave de API com âmbito de escrita.

Exemplos de código

Download: OpenAPI Swagger Postman

Perguntar à IA: Abrir no ChatGPT Abrir no Claude Ver como Markdown

Linguagem

Request (prompt-based)

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","task_type":"create","prompt_id":456}' \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","task_type":"create","prompt_id":456})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","task_type":"create","prompt_id":456}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","task_type":"create","prompt_id":456}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/intelligence_tasks", strings.NewReader(`{"project_id":"PROJECT_ID","task_type":"create","prompt_id":456}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/intelligence_tasks', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","task_type":"create","prompt_id":456}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"task_type\":\"create\",\"prompt_id\":456}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request (prompt + custom instructions)

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"}' \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/intelligence_tasks", strings.NewReader(`{"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/intelligence_tasks', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","task_type":"create","prompt_id":456,"user_instructions":"Focus on competitor weaknesses and pricing"}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"task_type\":\"create\",\"prompt_id\":456,\"user_instructions\":\"Focus on competitor weaknesses and pricing\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request (agentic mode)

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"}' \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/intelligence_tasks", strings.NewReader(`{"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/intelligence_tasks', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","task_type":"brief","custom_topic":"AI visibility best practices"}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"task_type\":\"brief\",\"custom_topic\":\"AI visibility best practices\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "id": 789,
  "public_id": "abc123def",
  "project_id": 123,
  "task_type": "create",
  "title": "Create: best CRM software",
  "status": "pending",
  "prompt_id": 456,
  "prompt_text": "best CRM software",
  "agentic_mode": false,
  "custom_topic": null,
  "user_instructions": "Focus on competitor weaknesses",
  "output_language_code": "en",
  "word_count": null,
  "result_data": null,
  "error_message": null,
  "estimated_time": "3-5 minutes",
  "created_at": "2026-04-08T10:00:00Z",
  "processed_at": null,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks?project_id=PROJECT_ID&task_type=create&status=completed"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "project_id": 123, "page": 1, "per_page": 20, "total": 5,
  "data": [{
    "id": 789, "public_id": "abc123def",
    "task_type": "create", "title": "Enterprise CRM Guide",
    "status": "completed", "prompt_id": 456,
    "prompt_text": "best CRM software",
    "word_count": 2450, "manually_edited_at": null,
    "created_at": "2026-04-08T10:00:00Z",
    "processed_at": "2026-04-08T10:03:00Z"
  }],
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks/789?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "id": 789, "public_id": "abc123def", "project_id": 123,
  "task_type": "create", "title": "Enterprise CRM Guide",
  "status": "completed", "prompt_id": 456,
  "prompt_text": "best CRM software",
  "agentic_mode": false,
  "custom_topic": null,
  "user_instructions": "Focus on competitor weaknesses",
  "output_language_code": "en",
  "word_count": 2450,
  "result_data": { "content": "...", "sections": [...] },
  "error_message": null,
  "manually_edited_at": null,
  "edited_by_user_id": null,
  "created_at": "2026-04-08T10:00:00Z",
  "processed_at": "2026-04-08T10:03:00Z",
  "request_id": "..."
}

Request

curl -X PATCH -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}}' \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks/789", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}})
});
const data = await response.json();

import requests

response = requests.patch(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks/789",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}}
)
data = response.json()

require 'httparty'

response = HTTParty.patch(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}}
)
data = response.parsed_response

req, _ := http.NewRequest("PATCH", "https://api.llmpulse.ai/api/v1/intelligence_tasks/789", strings.NewReader(`{"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('PATCH', 'https://api.llmpulse.ai/api/v1/intelligence_tasks/789', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","edits":{"title":"How to measure AI visibility in 2026","sections.0.content":"AI visibility is the share of AI answers that mention your brand."}}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks/789"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .PATCH(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"edits\":{\"title\":\"How to measure AI visibility in 2026\",\"sections.0.content\":\"AI visibility is the share of AI answers that mention your brand.\"}}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "id": 789, "public_id": "abc123def", "project_id": 123,
  "task_type": "create", "title": "Enterprise CRM Guide (2026 edition)",
  "status": "completed",
  "word_count": 2461,
  "result_data": { "title": "Enterprise CRM Guide (2026 edition)", "sections": [...] },
  "manually_edited_at": "2026-09-09T15:12:00Z",
  "edited_by_user_id": 42,
  "changed_paths": ["title", "sections.0.content"],
  "request_id": "..."
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/intelligence_tasks/789/revert?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .POST()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "id": 789, "public_id": "abc123def", "project_id": 123,
  "task_type": "create", "title": "Enterprise CRM Guide",
  "status": "completed",
  "result_data": { "title": "Enterprise CRM Guide", "sections": [...] },
  "manually_edited_at": null,
  "edited_by_user_id": null,
  "request_id": "..."
}

GEO Writer

POST/intelligence_tasks

GET/intelligence_tasks

GET/intelligence_tasks/:id

PATCH/intelligence_tasks/:id

POST/intelligence_tasks/:id/revert

POST`/intelligence_tasks`

GET`/intelligence_tasks`

GET`/intelligence_tasks/:id`

PATCH`/intelligence_tasks/:id`

POST`/intelligence_tasks/:id/revert`