Recomendaciones

Las mismas ejecuciones de recomendación que alimentan la página Recomendaciones de la aplicación, más el endpoint que lanza una nueva.

GET`/recommendations`

Lista las ejecuciones de recomendaciones de un proyecto con filtros por tipo y estado.

Parámetros:

project_idobligatorio
recommendation_typeai_visibility|social_community|brand_building|sentiment_reputation
statuspending|processing|completed|failed
page
per_page

Los valores de enumeración no válidos devuelven ERR_INVALID_PARAM.

GET`/recommendations/:id`

Una ejecución de recomendación con sus elementos y los datos del informe: array de elementos con título, prioridad, pasos de acción, metadatos y referencias de fuentes, además del recuento de elementos agrupado por active, completed, archived.

Parámetros:

project_idobligatorio
:iden la URL
item_statusactive|completed|archived
resolve_source_refspor defecto true

POST`/recommendations`

Lanza una nueva generación (el mismo motor que la página de Recomendaciones de la app). Se ejecuta de forma asíncrona (1-3 minutos); sondea GET /recommendations/:id hasta que el estado sea completed. Consume el presupuesto semanal de elementos de recomendación del proyecto (ERR_LIMIT_REACHED cuando se agota, o cuando ya hay una ejecución del mismo tipo pendiente). sentiment_reputation requiere Scale o superior. Requiere una clave de API con permisos de escritura.

Cuerpo (JSON):

project_idobligatorio
recommendation_typeai_visibility por defecto | social_community | brand_building | sentiment_reputation

Ejemplos de código

Download: OpenAPI Swagger Postman

Preguntar a la IA: Abrir en ChatGPT Abrir en Claude Ver como Markdown

Idioma

Request

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

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

import requests

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

require 'httparty'

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

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

Request

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

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

require 'httparty'

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

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