Na základe výsledkov vyhľadávania je hlavný rozdiel medzi koncovými bodmi rozhrania API `phrase_all` a `phrase_this` pre prehľad Prehľad kľúčových slov:
1. phrase_all:
- Tento koncový bod získava údaje Prehľad kľúčových slov pre dané kľúčové slovo vo všetkých dostupných regionálnych databázach.
- Vráti metriky kľúčových slov (objem vyhľadávania, CZK, konkurencia atď.) agregované vo všetkých databázach.
- Je to užitočné, keď chcete získať celkový prehľad o výkonnosti kľúčového slova.
2. phrase_this:
- Tento koncový bod získava údaje Prehľad kľúčových slov pre dané kľúčové slovo, ale pre konkrétnu regionálnu databázu.
- Musíte zadať parameter `database`, aby ste označili, pre ktorú regionálnu databázu chcete údaje (napr. `database=us`).
- To vám umožní získať podrobnejšie údaje špecifické pre daný región.
V súhrne:
- `phrase_all` vám poskytuje súhrnné údaje o kľúčových slovách vo všetkých regiónoch.
- `phrase_this` vám umožňuje získať prehľad kľúčových slov pre konkrétnu regionálnu databázu.
Výber medzi týmito dvoma závisí od toho, či potrebujete globálne alebo viac lokalizované zobrazenie údajov o kľúčových slovách. Ak zacieľujete na konkrétny trh, relevantnejšie by bolo použiť koncový bod `phrase_this` s príslušnou regionálnou databázou. Ak chcete celkovú, medziregionálnu perspektívu, vhodnejší by bol koncový bod `phrase_all`.
Obidva koncové body podporujú ďalšie parametre, ako napríklad `display_limit` a `export_columns` na prispôsobenie údajov vrátených v odpovedi.
Citácie:[1] https://www.semrush.com/kb/257-keyword-overview
[2] https://www.semrush.com/kb/972-api-reports
[3] https://developer.semrush.com/api/v3/analytics/keyword-reports/
[4] https://www.semrush.com/features/keyword-research/
[5] https://www.semrush.com/analytics/keywordoverview/