GEO Writer

Create and manage AI-powered GEO Writer tasks. Tasks are processed asynchronously, so create one and poll it until it completes.

POST`/intelligence_tasks`

Create a GEO Writer task. Two modes: prompt-based (provide prompt_id) or agentic (provide custom_topic and/or user_instructions).

Body (JSON):

project_idrequired
task_typerequired: brief, create, update, pr_insights, custom
prompt_id
custom_topic
user_instructions
output_language_code
existing_content
existing_content_url

GET`/intelligence_tasks`

List GEO Writer tasks for a project with optional filtering.

Params:

project_idrequired
task_type
status
page
per_page

GET`/intelligence_tasks/:id`

Get full task details including result data when completed. Accepts numeric ID or public_id.

Params:

project_idrequired
:idtask ID or public_id in URL

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

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, "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,
  "created_at": "2026-04-08T10:00:00Z",
  "processed_at": "2026-04-08T10:03:00Z",
  "request_id": "..."
}

GEO Writer

POST/intelligence_tasks

GET/intelligence_tasks

GET/intelligence_tasks/:id

POST`/intelligence_tasks`

GET`/intelligence_tasks`

GET`/intelligence_tasks/:id`