Store Integrations

The endpoints behind the LLM Pulse app for Shopify: match a store to its project, push the orders AI assistants referred to the store and read them back, and turn catalog products into buyer prompts to track. They need an API key, so the Scale plan or above, and they are not available to accounts with a white-label portal or an embed, which get ERR_INTEGRATION_UNAVAILABLE (403).

GET`/store_connection`

Tells a store app whether the API key's account can use it and which project the store belongs to. project is the live project whose domain equals the store domain, else one whose domain is a parent or a subdomain of it, else null. When several live projects match equally, project is null and ambiguous is true. candidates lists every live project of the account so the app can offer a picker. Takes no project_id.

Params:

platformrequired, shopify
domainrequired, the store domain, with or without scheme

GET`/ai_orders`

Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series. Every revenue is a decimal string in currency, which is null when the window holds no stored order. Team members need read access to AI Traffic.

Params: project_id (required), platform (default shopify), from / to (YYYY-MM-DD; default: the 90 days ending today; at most 400 days).

GET`/catalog_prompt_suggestions`

Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts.

Params:

project_idrequired
statuspending|accepted|rejected
product_external_id
page
per_pagedefault 50, max 100

PUT`/ai_orders`

Replaces the daily AI-referred orders and revenue of a window. Send the raw referring host or utm_source of each order's first visit as referrer: LLM Pulse classifies it and ignores anything that is not an AI assistant, and the response counts the stored rows and the ignored entries. Every stored row of that project and platform between from and to is replaced, so pushing the same window again converges instead of counting twice. Requires a writable API key; team members need update access to AI Traffic.

Body (JSON): project_id (required), platform (required, shopify), currency (required, ISO 4217), from and to (required, YYYY-MM-DD, at most 400 days), days (required, up to 400 entries with day, referrer, orders and revenue).

POST`/catalog_prompt_suggestions`

Writes buyer prompts for up to 20 catalog products and saves them as pending suggestions in the project's Suggested prompts queue. data holds only the new suggestions, and skipped counts the prompts the project already had as a suggestion. It draws on the same hourly prompt-suggestion allowance as the app (ERR_QUOTA_EXCEEDED once it is used up); a failed generation returns ERR_GENERATION_FAILED (502) and can be retried. Requires a writable API key; team members need create access to Prompts.

Body (JSON): project_id (required), platform (required, shopify), products (required, 1 to 20 objects; external_id and title required, handle, product_type, vendor, tags, collections and url optional), country_code and language_code (default: the project's).

POST`/catalog_prompt_suggestions/accept`

Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product. Suggestions that are no longer pending come back in skipped, with their status as the reason. When the new prompts would exceed the plan, the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a writable API key; team members need create access to Prompts.

Body (JSON):

project_idrequired
idsrequired, up to 100 suggestion ids, all in one country and language

POST`/catalog_prompt_suggestions/reject`

Marks pending suggestions as rejected. Suggestions that are no longer pending stay as they are, and rejected counts the ones that changed. Requires a writable API key; team members need update access to Prompts.

Body (JSON):

project_idrequired
idsrequired, up to 100 suggestion ids

Code Examples

Download: OpenAPI Swagger Postman

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

Language

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());

Store Integrations

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`