Prompts

As perguntas enviadas aos modelos de IA segundo a cadência de monitorização configurada na conta, com os registos correspondentes a cada execução.

GET`/dimensions/prompts`

Lista os Prompts de um projeto.

Parâmetros:

project_idobrigatório
collection_id
promptID do prompt
country_code
language_code
from
to
page
per_page≤100

GET`/dimensions/prompt_executions`

Lista as execuções de prompts num projeto.

Parâmetros:

project_idobrigatório
model
collection_id
promptID do prompt
country_code
language_code
from
to
page
per_page
mention_filter
citation_filter
competitorsa matriz de dois eixos descrita em GET /answers

GET`/dimensions/query_fan_outs`

As subconsultas que um modelo emitiu efetivamente ao responder aos seus Prompts monitorizados, útil para descobrir a formulação que os modelos pesquisam, em vez da formulação que escreveu. view=query (predefinido) devolve uma linha por subconsulta distinta, com a respetiva contagem e percentagem de todas as ocorrências; view=prompt devolve uma linha por prompt, com o número de subconsultas distintas que produziu. O Query Fan Out é comunicado sobretudo pelo ChatGPT, pelo que um resultado vazio significa normalmente que os modelos abrangidos não o expõem.

Parâmetros:

project_idobrigatório
viewquery ou prompt
querysubcadeia no texto da subconsulta
order
direction
model
collection_id
prompt
country_code
language_code
prompt_type
brand_kind
range
from
to
page
per_page
output

POST`/prompts`

Crie até 100 Prompts por pedido. Os Prompts existentes (mesmo texto + idioma) são ignorados.

Corpo (JSON):

project_idobrigatório
promptsarray, obrigatório, máx. 100
country_codeobrigatório
language_codeobrigatório

DELETE`/prompts/:id`

Elimina um prompt. Irreversível; o prompt desaparece imediatamente, liberta uma vaga de prompt e o seu histórico (execuções, menções, citações e sentimento) é eliminado por uma tarefa em segundo plano. Requer uma chave de API com permissão de escrita.

Parâmetros:

project_idobrigatório
:idno URL

Devolve ERR_NOT_FOUND para prompts fora do projeto.

Exemplos de código

Download: OpenAPI Swagger Postman

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

Linguagem

Request

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

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/prompts?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/dimensions/prompts?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/prompts?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/dimensions/prompts?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/dimensions/prompts?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{ "project_id":4, "page":1, "per_page":20, "total":132,
  "data":[ { "id":101, "prompt_text":"Best AI tools for marketing?", "collection_id":7, "collection_ids":[7, 12], "country_code":"ES", "language_code":"es", "last_executed_at":"2025-03-01T10:00:00Z" } ],
  "request_id":"..." }

Request

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

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/prompt_executions?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/dimensions/prompt_executions?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/prompt_executions?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/dimensions/prompt_executions?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/dimensions/prompt_executions?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{ "project_id":4, "page":1, "per_page":20, "total":540,
  "data":[ { "id":9001, "prompt_id":101, "executed_at":"2025-03-01T10:00:00Z", "duration":1.23, "success":true, "model":"gpt-4o" } ],
  "request_id":"..." }

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"}' \
  "https://api.llmpulse.ai/api/v1/prompts"

const response = await fetch("https://api.llmpulse.ai/api/v1/prompts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/prompts",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/prompts",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/prompts", strings.NewReader(`{"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"}`))
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/prompts', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","prompts":["best CRM software 2026","top project management tools"],"country_code":"US","language_code":"en"}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/prompts"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"prompts\":[\"best CRM software 2026\",\"top project management tools\"],\"country_code\":\"US\",\"language_code\":\"en\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "project_id": 123,
  "created": 2,
  "skipped": 1,
  "total_after": 53,
  "prompts_available": 47,
  "data": [
    { "id": 456, "raw_input": "best CRM software 2026", "status": "created" },
    { "id": 457, "raw_input": "top project management tools", "status": "created" },
    { "id": 400, "raw_input": "best AI tools", "status": "exists" }
  ],
  "request_id": "..."
}

Prompts

GET/dimensions/prompts

GET/dimensions/prompt_executions

GET/dimensions/query_fan_outs

POST/prompts

DELETE/prompts/:id

GET`/dimensions/prompts`

GET`/dimensions/prompt_executions`

GET`/dimensions/query_fan_outs`

POST`/prompts`

DELETE`/prompts/:id`