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
Rozdzielana przecinkami lista pól do zwrócenia.
Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się one 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.
Raporty widoczności AI przechodzą na wolumen skorygowany o AI. Lepiej szacuje popyt na odpowiedzi AI w chatbotach i w obszarach wyszukiwania AI. Jest obliczany przez skorygowanie wolumenu wyszukiwań Google o szacowane użycie każdej platformy AI w porównaniu z Google. Ten parametr zostanie wycofany 30 września 2026 r.; wszystkie żądania będą korzystać z nowego wolumenu skorygowanego o AI.
Kolumna, według której mają zostać posortowane wyniki.
Format wyjściowy.
Odpowiedzi
Kraj, którego dotyczy pytanie.
Model chatbota, który wygenerował odpowiedź.
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.