Shopping & Anzeigen

Kommerzielle Formate in KI-Antworten: die Produktkarten, die von den Modellen zurückgegeben werden, die bezahlten Platzierungen, die daneben erscheinen, und die lokalen Unternehmen, die bei Prompts mit lokaler Suchintention aufgelistet werden. Shopping und Anzeigen sind ab Tarif Scale verfügbar, lokale Unternehmen in allen Tarifen. Die Endpunkte sind nach dem benannt, was sie messen, und nicht nach dem Assistenten, der es zuerst geliefert hat. Grenzen Sie die Ergebnisse daher mit model ein, statt den Anbieter aus dem Pfad abzuleiten.

GET`/dimensions/shopping`

Produktkarten in KI-Antworten. view=products (Standard) liefert eine Zeile pro Produkt, über alle Ausführungen zusammengeführt, mit der Anzahl der Vorkommen, der Preisspanne, der Bewertung und der Angabe, ob es Ihr Produkt ist. view=merchants liefert eine Zeile pro verkaufendem Händler. Ein Produkt wird anhand seiner externen Produkt-ID erkannt. Liefert der Anbieter keine verwendbare ID, dient stattdessen der Titel. So wird dasselbe Produkt über alle Ausführungen hinweg zusammengeführt, statt in eine Zeile pro Antwort aufgeteilt zu werden.

Parameter:

project_iderforderlich
viewproducts|merchants
owned
query
orderproducts: appearances, price, rating, title; merchants: 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

Jede Antwort enthält außerdem einen Block totals, der den KPI-Karten in der App entspricht.

GET`/dimensions/ads`

Bezahlte Platzierungen in KI-Antworten. view=advertisers (Standard) liefert eine Zeile pro Domain eines Werbetreibenden mit der Anzahl der Platzierungen, der Prompt-Reichweite sowie der durchschnittlichen und der besten Position. view=ads liefert die einzelnen Platzierungen mit Titel, Snippet, Position und dem Prompt, der sie ausgelöst hat. Position 1 ist der beste Platz, ein kleinerer Wert für die durchschnittliche Position ist also besser.

Parameter:

project_iderforderlich
viewadvertisers|ads
owned
query
orderadvertisers: ads, prompts, avg_position, domain; ads: recent, oldest, position
directionnur für advertisers; bei avg_position und domain standardmäßig aufsteigend
model
collection_id
country_code
language_code
prompt
prompt_type
brand_kind
range
from
to
page
per_page
output

GET`/dimensions/local_businesses`

Lokale Unternehmen (Geschäfte, Restaurants, Dienstleister), die in KI-Antworten genannt werden, eine Zeile pro Unternehmen. Ein Unternehmen ist durch seinen Namen und seine Adresse bestimmt, daher ergeben zwei Filialen einer Kette zwei Zeilen. Jede Zeile enthält die Anzahl der Nennungen, die Anzahl der Prompts, bei denen das Unternehmen genannt wurde, seine durchschnittliche Bewertung und seine durchschnittliche Position in der Liste, die Anzahl der Rezensionen und die Angabe, ob es zu Ihrer Marke oder zu einem Wettbewerber im Tracking gehört. In jedem Tarif verfügbar.

Parameter:

project_iderforderlich
owned
queryName oder Adresse
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

Jede Antwort enthält außerdem einen Block totals, der den KPI-Karten in der App entspricht.

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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());
    }
}

Shopping & Anzeigen

GET/dimensions/shopping

GET/dimensions/ads

GET/dimensions/local_businesses

GET`/dimensions/shopping`

GET`/dimensions/ads`

GET`/dimensions/local_businesses`