Integraciones con tiendas

Los endpoints en los que se basa la aplicación de LLM Pulse para Shopify: asociar una tienda a su proyecto, enviar los pedidos que los asistentes de IA derivaron a la tienda y volver a consultarlos, y convertir productos del catálogo en prompts de comprador que monitorizar. Requieren una clave de API, por lo que necesitan el plan Scale o superior, y no están disponibles para las cuentas con un portal de marca blanca o un embed, que reciben ERR_INTEGRATION_UNAVAILABLE (403).

GET`/store_connection`

Indica a una aplicación de tienda si la cuenta de la clave de API puede usarla y a qué proyecto pertenece la tienda. project es el proyecto activo cuyo dominio coincide con el de la tienda; si no lo hay, uno cuyo dominio sea un dominio padre o un subdominio del de la tienda; y si tampoco lo hay, null. Cuando varios proyectos activos coinciden por igual, project es null y ambiguous es true. candidates enumera todos los proyectos activos de la cuenta para que la aplicación pueda ofrecer un selector. No admite project_id.

Parámetros:

platformobligatorio, shopify
domainobligatorio, el dominio de la tienda, con o sin protocolo

GET`/ai_orders`

Devuelve los pedidos procedentes de IA que una aplicación de tienda ha enviado para un proyecto: totales, una fila por asistente de IA y una serie diaria. Cada revenue es una cadena decimal en la moneda que indica currency, y currency es null cuando el intervalo no contiene ningún pedido almacenado. Los miembros del equipo necesitan acceso de lectura a «Tráfico de IA».

Parámetros: project_id (obligatorio), platform (por defecto, shopify), from / to (YYYY-MM-DD; por defecto, los 90 días que terminan hoy; 400 días como máximo).

GET`/catalog_prompt_suggestions`

Enumera los prompts de comprador sugeridos a partir del catálogo de una tienda, empezando por los más antiguos, con su estado y el producto del que procede cada uno. Los miembros del equipo necesitan acceso de lectura a «Prompts».

Parámetros:

project_idobligatorio
statuspending|accepted|rejected
product_external_id
page
per_page50 por defecto, máximo 100

PUT`/ai_orders`

Sustituye los pedidos y los ingresos diarios procedentes de IA de un intervalo. Envía como referrer el host de referencia sin procesar o el utm_source de la primera visita de cada pedido: LLM Pulse lo clasifica e ignora todo lo que no sea un asistente de IA, y la respuesta indica el número de filas almacenadas en stored y el de entradas ignoradas en ignored. Se sustituyen todas las filas almacenadas de ese proyecto y esa plataforma entre from y to, así que volver a enviar el mismo intervalo deja el mismo resultado en lugar de contar los pedidos dos veces. Requiere una clave de API con ámbito de lectura y escritura; los miembros del equipo necesitan acceso de actualización a «Tráfico de IA».

Cuerpo (JSON): project_id (obligatorio), platform (obligatorio, shopify), currency (obligatorio, ISO 4217), from y to (obligatorios, YYYY-MM-DD, 400 días como máximo), days (obligatorio, hasta 400 entradas con day, referrer, orders y revenue).

POST`/catalog_prompt_suggestions`

Genera prompts de comprador para un máximo de 20 productos del catálogo y los guarda como sugerencias pendientes en la cola de «Prompts sugeridos» del proyecto. data contiene solo las sugerencias nuevas y skipped cuenta los prompts que el proyecto ya tenía como sugerencia. Consume el mismo cupo horario de sugerencias de prompts que la aplicación (ERR_QUOTA_EXCEEDED una vez agotado); una generación fallida devuelve ERR_GENERATION_FAILED (502) y se puede reintentar. Requiere una clave de API con ámbito de lectura y escritura; los miembros del equipo necesitan acceso de creación a «Prompts».

Cuerpo (JSON): project_id (obligatorio), platform (obligatorio, shopify), products (obligatorio, de 1 a 20 objetos; external_id y title obligatorios, handle, product_type, vendor, tags, collections y url opcionales), country_code y language_code (por defecto: los del proyecto).

POST`/catalog_prompt_suggestions/accept`

Empieza a monitorizar las sugerencias pendientes: cada una se convierte en un prompt, etiquetado con una colección que lleva el nombre de su producto. Las sugerencias que ya no están pendientes se devuelven en skipped, con su estado como motivo. Si con los nuevos prompts se superase el límite del plan, la llamada devuelve ERR_LIMIT_REACHED y no acepta ninguna. Requiere una clave de API con ámbito de lectura y escritura; los miembros del equipo necesitan acceso de creación a «Prompts».

Cuerpo (JSON):

project_idobligatorio
idsobligatorio, hasta 100 ID de sugerencia, todas del mismo país e idioma

POST`/catalog_prompt_suggestions/reject`

Marca como rechazadas las sugerencias pendientes. Las sugerencias que ya no están pendientes se quedan como están, y rejected cuenta las que han cambiado. Requiere una clave de API con ámbito de lectura y escritura; los miembros del equipo necesitan acceso de actualización a «Prompts».

Cuerpo (JSON):

project_idobligatorio
idsobligatorio, hasta 100 ID de sugerencia

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/store_connection?platform=shopify&domain=acme-store.com"

const response = await fetch("https://api.llmpulse.ai/api/v1/store_connection?platform=shopify&domain=acme-store.com", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/store_connection?platform=shopify&domain=acme-store.com",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/store_connection?platform=shopify&domain=acme-store.com",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/store_connection?platform=shopify&domain=acme-store.com", 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/store_connection?platform=shopify&domain=acme-store.com', [
    '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/store_connection?platform=shopify&domain=acme-store.com"))
    .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/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03"

const response = await fetch("https://api.llmpulse.ai/api/v1/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03", 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/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03', [
    '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/ai_orders?project_id=PROJECT_ID&platform=shopify&from=2026-07-06&to=2026-10-03"))
    .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/catalog_prompt_suggestions?project_id=PROJECT_ID&status=pending"

const response = await fetch("https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions?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/catalog_prompt_suggestions?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/catalog_prompt_suggestions?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/catalog_prompt_suggestions?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/catalog_prompt_suggestions?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/catalog_prompt_suggestions?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 PUT -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]}' \
  "https://api.llmpulse.ai/api/v1/ai_orders"

const response = await fetch("https://api.llmpulse.ai/api/v1/ai_orders", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]})
});
const data = await response.json();

import requests

response = requests.put(
    "https://api.llmpulse.ai/api/v1/ai_orders",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]}
)
data = response.json()

require 'httparty'

response = HTTParty.put(
  "https://api.llmpulse.ai/api/v1/ai_orders",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]}
)
data = response.parsed_response

req, _ := http.NewRequest("PUT", "https://api.llmpulse.ai/api/v1/ai_orders", strings.NewReader(`{"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]}`))
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('PUT', 'https://api.llmpulse.ai/api/v1/ai_orders', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","platform":"shopify","currency":"EUR","from":"2026-09-04","to":"2026-10-03","days":[{"day":"2026-10-01","referrer":"chatgpt.com","orders":3,"revenue":"120.50"}]}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/ai_orders"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .PUT(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"platform\":\"shopify\",\"currency\":\"EUR\",\"from\":\"2026-09-04\",\"to\":\"2026-10-03\",\"days\":[{\"day\":\"2026-10-01\",\"referrer\":\"chatgpt.com\",\"orders\":3,\"revenue\":\"120.50\"}]}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]}' \
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions"

const response = await fetch("https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions", strings.NewReader(`{"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]}`))
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/catalog_prompt_suggestions', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","platform":"shopify","products":[{"external_id":"gid://shopify/Product/1","handle":"trail-runner","title":"Trail Runner 2","product_type":"Running shoes","url":"https://acme-store.com/products/trail-runner"}]}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"platform\":\"shopify\",\"products\":[{\"external_id\":\"gid://shopify/Product/1\",\"handle\":\"trail-runner\",\"title\":\"Trail Runner 2\",\"product_type\":\"Running shoes\",\"url\":\"https://acme-store.com/products/trail-runner\"}]}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","ids":[1,2]}' \
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/accept"

const response = await fetch("https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/accept", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","ids":[1,2]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/accept",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","ids":[1,2]}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/accept",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","ids":[1,2]}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/accept", strings.NewReader(`{"project_id":"PROJECT_ID","ids":[1,2]}`))
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/catalog_prompt_suggestions/accept', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","ids":[1,2]}
]);
$data = json_decode($response->getBody(), true);

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

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","ids":[3]}' \
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/reject"

const response = await fetch("https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/reject", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","ids":[3]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/reject",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","ids":[3]}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/reject",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","ids":[3]}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/catalog_prompt_suggestions/reject", strings.NewReader(`{"project_id":"PROJECT_ID","ids":[3]}`))
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/catalog_prompt_suggestions/reject', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","ids":[3]}
]);
$data = json_decode($response->getBody(), true);

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

Integraciones con tiendas

GET/store_connection

GET/ai_orders

GET/catalog_prompt_suggestions

PUT/ai_orders

POST/catalog_prompt_suggestions

POST/catalog_prompt_suggestions/accept

POST/catalog_prompt_suggestions/reject

GET`/store_connection`

GET`/ai_orders`

GET`/catalog_prompt_suggestions`

PUT`/ai_orders`

POST`/catalog_prompt_suggestions`

POST`/catalog_prompt_suggestions/accept`

POST`/catalog_prompt_suggestions/reject`