Baza słów kluczowych: narzędzia · sugestie fraz (suggest)
/api/keywords_analysis/tools/keywords_suggester/suggestGeneruje sugestie fraz przez rozwijanie słów wejściowych (keywords) — technika podpowiedzi/autouzupełniania (dopisywanie słów przed/po frazie). Dla każdej sugestii zwraca frazę źródłową (parent_keyword), zaproponowaną frazę (suggested_keyword), pierwszą literę i liczbę słów.
| Sugerowana fraza | Fraza źródłowa | Pierwsza litera | Liczba słów |
|---|---|---|---|
| buty do biegania salomon | buty do biegania | b | 3 |
| buty do biegania skechers | buty do biegania | b | 3 |
| buty do biegania saucony | buty do biegania | b | 3 |
| buty do biegania salomon damskie | buty do biegania | b | 4 |
country_id 1, keywords „buty do biegania”, mode „lr”, iterations 2. Wszystkie pola wiersza.
To narzędzie (tools/*) — zużywa jednostkę dziennego limitu narzędzi Bazy słów (keywords_analysis_suggester / tools_daily_limit). Patrz Limity zapytań.
Żądanie
POST /api/keywords_analysis/tools/keywords_suggester/suggest
{
"country_id": 1,
"keywords": ["buty do biegania"],
"mode": "lr",
"iterations": 2,
"limit": 10
}Parametry
| Name | Type | Default |
|---|---|---|
country_id | numberWymagane. ID kraju (bazy słów). | |
keywords | string[]Wymagane. Frazy wejściowe do rozwinięcia. | |
mode | stringTryb rozwijania (kierunek dopisywania słów). | 'lr' |
iterations | numberGłębokość rozwinięcia (liczba iteracji). | 2 |
limit | numberLiczba wierszy na stronę. | 10 |
page | numberNumer strony. | 1 |
order | { prop: string; dir: "asc" | "desc"; }Sortowanie |
Odpowiedź
| Name | Type | Default |
|---|---|---|
success | boolean | |
data | { parent_keyword: string; suggested_keyword: string; first_letter: string; keywords_number: number; }[] | |
pagination | { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number; } |
Błędy
Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.
Powiązane akcje
keywords/getKeywords— pełna wyszukiwarka bazy z metrykami.keywords/getRelated— frazy powiązane semantycznie.