Wettbewerber

Die Marken, die Sie neben Ihrer eigenen beobachten. Die hier zurückgegebenen Wettbewerber-IDs entsprechen den Werten von actor_id, unter denen die Endpunkte für Kennzahlen ihre Ergebnisse ausweisen.

GET`/dimensions/competitors`

Listet die Wettbewerber des Projekts auf.

GET`/dimensions/competitors/:id`

Liefert detaillierte Informationen zu einem Wettbewerber, darunter Namensvarianten und App-Store-IDs.

GET`/competitors/suggestions`

Der Tab „Vorschläge“ auf der Seite „Wettbewerber“. basis=brands (Standard) liefert die konkurrierenden Marken, die die KI-gestützte Wettbewerbersuche vorgeschlagen hat und die bisher weder im Tracking sind noch abgelehnt wurden, jeweils mit den Namensvarianten, anhand derer sie erkannt würden. basis=citations liefert die in KI-Antworten am häufigsten zitierten Domains, die weder zu Ihnen gehören noch bereits im Tracking sind, jeweils mit der Anzahl der Antworten, in denen sie zitiert werden. discovery gibt an, ob ein Durchlauf der Wettbewerbersuche noch läuft. Der Endpunkt greift nur lesend zu und startet nie selbst eine Wettbewerbersuche. Fügen Sie einen Vorschlag mit POST /competitors hinzu. Auch als MCP-Tool list_competitor_suggestions verfügbar.

Parameter:

project_iderforderlich
basisbrands|citations
query
page
per_pagestandardmäßig 20, maximal 100
output

POST`/competitors`

Fügt einen Wettbewerber mit eigener Abgleichsregel für zitierte URLs hinzu. Dabei gilt das Limit für Wettbewerber, das Ihr Tarif vorsieht.

Anfragetext (JSON):

project_iderforderlich
brand_nameerforderlich
domainerforderlich, die URL wird normalisiert
matching_namesoptional, Array
citation_match_modedomain, host oder path_prefix; standardmäßig domain
citation_match_patherforderlich bei path_prefix

PATCH/DELETE /competitors/:id

Ändert einen Wettbewerber (brand_name, Domain oder Host der Website, matching_names, color, Abgleich zitierter URLs) oder löscht ihn. Nach Änderungen an Name, Website oder Abgleichsregel wird der Abgleich für alle bisherigen Daten im Hintergrund neu ausgeführt (einige Minuten lang processing: true, Bearbeitungen sind währenddessen gesperrt). Das Löschen ist endgültig: Der Wettbewerber verschwindet sofort, anschließend löscht ein Hintergrundprozess seine Erwähnungen, Zitierungen, Sentiment-Daten und den Verlauf seines Share of Voice. Seine Anzeigen, Shopping-Produkte, lokalen Unternehmen und Markenentitäten bleiben erhalten und gehen an das Projekt oder an einen anderen Wettbewerber über, zu dem sie passen; andernfalls bleiben sie ohne Zuordnung.

PATCH-Anfragetext:

project_iderforderlich
brand_name
domainDomain oder Host der Website; eine vollständige URL wird normalisiert
matching_namesArray, ersetzt die bisherige Liste vollständig
colorHex-Farbcode
citation_match_mode
citation_match_path

DELETE: project_id + :id in der URL.

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/competitors?project_id=PROJECT_ID"

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

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/competitors?project_id=PROJECT_ID",
  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/competitors?project_id=PROJECT_ID", 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/competitors?project_id=PROJECT_ID', [
    '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/competitors?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{ "project_id":1, "competitors":[ { "id":5,"name":"Contoso","domain":"contoso.com" } ], "request_id":"..." }

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/competitors/123"

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/competitors/123",
  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/competitors/123", 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/competitors/123', [
    '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/competitors/123"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": 42, "project_id": 107, "brand_name": "Competitor X",
  "domain": "competitor-x.com", "matching_names": ["Competitor X", "CompX"],
  "google_play_id": "com.competitorx.app", "app_store_id": "123456789",
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/competitors/suggestions?project_id=PROJECT_ID&basis=brands"

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

import requests

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

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/competitors/suggestions?project_id=PROJECT_ID&basis=brands",
  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/competitors/suggestions?project_id=PROJECT_ID&basis=brands", 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/competitors/suggestions?project_id=PROJECT_ID&basis=brands', [
    '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/competitors/suggestions?project_id=PROJECT_ID&basis=brands"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .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","brand_name":"Acme","domain":"acme.com","matching_names":["Acme","Acme Inc"]}' \
  "https://api.llmpulse.ai/api/v1/competitors"

const response = await fetch("https://api.llmpulse.ai/api/v1/competitors", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","brand_name":"Acme","domain":"acme.com","matching_names":["Acme","Acme Inc"]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/competitors",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "brand_name": "Acme", "domain": "acme.com", "matching_names": ["Acme", "Acme Inc"]}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/competitors",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "brand_name" => "Acme", "domain" => "acme.com", "matching_names" => ["Acme", "Acme Inc"] }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/competitors", strings.NewReader(`{"project_id":"PROJECT_ID","brand_name":"Acme","domain":"acme.com","matching_names":["Acme","Acme Inc"]}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/competitors', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'brand_name' => 'Acme', 'domain' => 'acme.com', 'matching_names' => ['Acme', 'Acme Inc']]
]);
$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/competitors"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"brand_name\":\"Acme\",\"domain\":\"acme.com\",\"matching_names\":[\"Acme\",\"Acme Inc\"]}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Wettbewerber

GET/dimensions/competitors

GET/dimensions/competitors/:id

GET/competitors/suggestions

POST/competitors

PATCH/DELETE /competitors/:id

GET`/dimensions/competitors`

GET`/dimensions/competitors/:id`

GET`/competitors/suggestions`

POST`/competitors`