Compras y anuncios

Espacios comerciales dentro de las respuestas de IA: las tarjetas de producto que devuelven los modelos, los emplazamientos de pago que aparecen junto a ellas y los negocios locales que enumeran en respuesta a prompts con intención local. Shopping y anuncios requieren el plan Scale o superior; los negocios locales están disponibles en todos los planes. Los endpoints reciben el nombre de lo que miden y no del asistente que lo devolvió por primera vez, así que filtra con model en lugar de deducir el proveedor de la ruta.

GET`/dimensions/shopping`

Tarjetas de producto devueltas dentro de las respuestas de IA. view=products (por defecto) devuelve una fila por producto distinto, combinado entre ejecuciones, con su número de apariciones, rango de precios, valoración y si es tuyo. view=merchants devuelve una fila por comercio vendedor. Un producto se identifica por su id de producto externo y recurre a su título cuando el proveedor no envía uno utilizable, por lo que el mismo producto se combina entre ejecuciones en lugar de dividirse en una fila por respuesta.

Parámetros:

project_idobligatorio
viewproducts|merchants
owned
query
orderproductos: appearances, price, rating, title; comercios: appearances, products, avg_price, avg_rating, merchant
direction
model
collection_id
country_code
language_code
prompt
prompt_type
brand_kind
range
from
to
page
per_page
output

Cada respuesta incluye además un bloque totals que coincide con las tarjetas KPI de la aplicación.

GET`/dimensions/ads`

Emplazamientos de pago devueltos dentro de las respuestas de IA. view=advertisers (por defecto) devuelve una fila por dominio anunciante con su número de emplazamientos, alcance de prompts, posición media y mejor posición. view=ads devuelve los emplazamientos individuales con título, snippet, posición y el prompt que los generó. La posición 1 es la mejor, por lo que una posición media más baja es mejor.

Parámetros:

project_idobligatorio
viewadvertisers|ads
owned
query
orderanunciantes: ads, prompts, avg_position, domain; anuncios: recent, oldest, position
directionsolo anunciantes; avg_position y domain por defecto en orden ascendente
model
collection_id
country_code
language_code
prompt
prompt_type
brand_kind
range
from
to
page
per_page
output

GET`/dimensions/local_businesses`

Negocios locales (tiendas, restaurantes, servicios) que aparecen en las respuestas de IA, con una fila por negocio. Un negocio se identifica por su nombre y su dirección, así que dos establecimientos de una misma cadena son dos filas. Cada fila incluye su número de apariciones, el número de prompts en los que aparece, su valoración media y su posición media en la lista, su número de reseñas y si es tuyo o de un competidor monitorizado. Disponible en todos los planes.

Parámetros:

project_idobligatorio
owned
querynombre o dirección
orderappearances, business, rating, reviews, avg_position, prompts
direction
model
collection_id
country_code
language_code
prompt
prompt_type
brand_kind
range
from
to
page
per_page
output

Cada respuesta incluye además un bloque totals que coincide con las tarjetas KPI de la aplicación.

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/dimensions/shopping?project_id=PROJECT_ID&view=products&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/shopping?project_id=PROJECT_ID&view=products&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/shopping?project_id=PROJECT_ID&view=products&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/shopping?project_id=PROJECT_ID&view=products&range=30", 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/shopping?project_id=PROJECT_ID&view=products&range=30', [
    '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/shopping?project_id=PROJECT_ID&view=products&range=30"))
    .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/dimensions/ads?project_id=PROJECT_ID&view=advertisers&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/ads?project_id=PROJECT_ID&view=advertisers&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/ads?project_id=PROJECT_ID&view=advertisers&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/ads?project_id=PROJECT_ID&view=advertisers&range=30", 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/ads?project_id=PROJECT_ID&view=advertisers&range=30', [
    '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/ads?project_id=PROJECT_ID&view=advertisers&range=30"))
    .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/dimensions/local_businesses?project_id=PROJECT_ID&order=appearances&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/local_businesses?project_id=PROJECT_ID&order=appearances&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/local_businesses?project_id=PROJECT_ID&order=appearances&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

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

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

Compras y anuncios

GET/dimensions/shopping

GET/dimensions/ads

GET/dimensions/local_businesses

GET`/dimensions/shopping`

GET`/dimensions/ads`

GET`/dimensions/local_businesses`