ロケーション

ほとんどのSERPリクエストでは、自由形式のlocation=文字列で十分です。Googleの独自ロケーション分類体系と照合したカノニカルな都市レベルのターゲティングが必要な場合は、Locations APIを使用して場所文字列をuule値に解決してください。

自由形式のロケーション(シンプル)

ロケーションを文字列として渡します。Shifterはその場で最適に一致するジオを解決します。

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2C+Illinois"

ユースケースの95%で機能します。欠点として、曖昧な文字列(Springfield、London)は期待とは異なる都市を選んでしまう場合があります。

特定の都市を確実に指定するには、まず解決してください。

curl "https://serp.shifter.io/v1?engine=locations&api_key=YOUR_API_KEY&q=Chicago"

レスポンスには、カノニカル名、country_code、target_type(City、State、Country)、google_idを含む、一致するすべてのロケーションが一覧表示されます。目的のものを選択し、そのカノニカル名をlocation=に使用してください。

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2CIllinois%2CUnited+States"

gl(国)とhl(言語)を組み合わせることで、適切な形式の結果を得られます。

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=news&gl=de&hl=de"

モバイルとデスクトップのSERPは大きく異なります(機能が異なり、ランキングも異なります)。明示的に指定してください。

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=laptop&device=mobile"

値: desktop(デフォルト)、mobile、tablet。

Yandexはlrを介して独自のロケーションIDを使用します。

完全なリストはengine=yandex_locationsから入手できます。