Odpowiedzi AI
API + MCPŻądania do tego punktu końcowego zużywają jednostki API w zależności od parametru
prompts: żądania zwracające wyłącznie dane niestandardowego promptu są bezpłatne, natomiast żądania uwzględniające dane promptów Ahrefs są rozliczane zgodnie ze standardowym cennikiem jednostek API.
Parametry zapytania
Lista pól do zwrócenia rozdzielonych przecinkami.
Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).
ID raportu, którego należy użyć. Jeśli zostanie podane, pozostałe parametry są pobierane z raportu (marka, konkurenci, rynek, kraj, filtry). Jeśli podano kraj lub filtry, zastępują one wartości z raportu. Znajdziesz je w adresie URL raportu Brand Radar w Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
Rozdzielana przecinkami lista marek do wyszukania. Co najmniej jedno z pól brand, competitors, market lub where nie może być puste.
Rozdzielana przecinkami lista konkurentów twoich marek.
Lista modeli chatbotów rozdzielona przecinkami. Wszystkie modele można łączyć ze sobą. Moduł claude obsługuje wyłącznie niestandardowe prompty.
Modele google_ai_overviews_keywords i google_ai_mode_keywords raportują widoczność AI Overview / AI Mode na podstawie zapytań w wyszukiwarce Google (słów kluczowych), a nie promptów.
Rozdzielana przecinkami lista dwuliterowych kodów krajów (ISO 3166-1 alpha-2).
Typ promptów do użycia. Jeśli nie określono, użyte zostaną oba. Niestandardowe prompty wymagają podania report_id.
Liczba wyników do zwrócenia.
Data, dla której ma zostać wykonane wyszukiwanie, w formacie YYYY-MM-DD.
Data do porównania z date, w formacie YYYY-MM-DD. Musi być ściśle wcześniejsza niż date. Po ustawieniu raport obejmuje każdy prompt, na który udzielono odpowiedzi w którymkolwiek z tych dni, a pole status informuje, jak każdy z nich zmienił się między tymi datami. Prompt, na który odpowiedziano tylko w date_compared, jest raportowany jako lost, a pozostałe pola opisują jego odpowiedź z date_compared, ponieważ nie ma jej dla date.
Kolumna do sortowania wyników.
Format wyjściowy.
Odpowiedzi
Każda wzmianka o śledzonej marce w odpowiedzi — najpierw Twoje marki, a potem konkurenci w ich kolejności — wraz z tym, jak odpowiedź się o niej wypowiada.
Wspomniana śledzona marka.
Jak odpowiedź wypowiada się o marce w tej wzmiance. Null, gdy nie jest dostępne.
Czego dotyczy wzmianka, np. ceny lub jakości. Null, gdy nie jest dostępne.
Zdanie z odpowiedzi, w którym znajduje się wzmianka. Null, gdy nie można znaleźć takiego zdania w odpowiedzi.
Kraj, którego dotyczy pytanie.
Model chatbota, który wygenerował odpowiedź.
Etap lejka promptu. Wartość null, gdy etap lejka nie jest dostępny.
Etykiety intencji promptu, w tym jego główna intencja, podtypy oraz atrybuty markowe/lokalne. Pusta tablica oznacza, że nie są dostępne żadne etykiety intencji.
Data ostatniej aktualizacji danych.
(10 jednostek) Linki użyte w odpowiedzi.
Pytanie zadane przez użytkownika.
(10 jednostek) Odpowiedź z modelu.
Zapytanie wyszukiwawcze użyte przez chatbota do znalezienia informacji potrzebnych do odpowiedzi. Uwaga: jeśli data_source nie zawiera chatgpt ani perplexity, to pole zawsze będzie puste.
Jak prompt zmienił się między date_compared a date. Wartość null, jeśli nie ustawiono date_compared. new — prompt, na który udzielono odpowiedzi w date, ale nie w date_compared. lost — prompt, na który udzielono odpowiedzi w date_compared, ale nie w date; pozostała część tego wiersza opisuje odpowiedź z date_compared, ponieważ nie ma jej dla date. no_change — prompt, na który udzielono odpowiedzi dla obu dat, co nie mówi nic o tym, czy zmieniła się sama odpowiedź, jej wzmianki lub cytowania.
Tagi przypisane do zapytania.
(10 jednostek) Szacowana liczba wyszukiwań miesięcznie. Wartość oparta na naszych estymacjach dla Google, wyliczona poprzez połączenie wolumenów wyszukiwań powiązanych słów kluczowych, w których to pytanie pojawia się w sekcji People Also Ask.