Concorrentes

As marcas que monitoriza a par da sua. Os IDs de concorrente devolvidos aqui são os valores actor_id que os endpoints de métricas reportam.

GET`/dimensions/competitors`

Lista os concorrentes do projeto.

GET`/dimensions/competitors/:id`

Obtenha informações detalhadas sobre um concorrente, incluindo nomes correspondentes e IDs das lojas de aplicações.

POST`/competitors`

Adiciona um concorrente com a sua própria regra de correspondência de URLs de citação. Respeita o limite máximo de concorrentes de cada plano.

Corpo (JSON):

project_idobrigatório
brand_nameobrigatório
domainobrigatório, o URL é normalizado
matching_namesarray opcional
citation_match_modedomain, host ou path_prefix; predefinido domain
citation_match_pathobrigatório para path_prefix

PATCH/DELETE /competitors/:id

Atualiza um concorrente (brand_name, domínio ou host do site, matching_names, color, correspondência de URLs de citação) ou elimina-o. As alterações ao nome, ao site e à regra de citação reexecutam a correspondência histórica em segundo plano (processing: true durante alguns minutos; as edições ficam bloqueadas entretanto). A eliminação é irreversível e remove os dados do concorrente em segundo plano.

Corpo do PATCH:

project_idobrigatório
brand_name
domaindomínio ou host do site; um URL completo é normalizado
matching_namesarray de substituição total
colorhexadecimal
citation_match_mode
citation_match_path

DELETE: project_id + :id no URL.

Exemplos de código

Download: OpenAPI Swagger Postman

Perguntar à IA: Abrir no ChatGPT Abrir no Claude Ver como Markdown

Linguagem

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

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, _ := client.Do(req)
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);

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

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, _ := client.Do(req)
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);

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 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'

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

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, _ := client.Do(req)
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);

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

Concorrentes

GET/dimensions/competitors

GET/dimensions/competitors/:id

POST/competitors

PATCH/DELETE /competitors/:id

GET`/dimensions/competitors`

GET`/dimensions/competitors/:id`

POST`/competitors`