Località e lingue: gl, hl, location, google_domain e device

Qual è la differenza tra gl, hl e location?

gl indica di quale paese vuoi i risultati. hl indica in quale lingua legge la persona, il che cambia l'interfaccia e spesso anche le domande e gli snippet. location restringe il paese a una città o a una regione, cosa che conta non appena una query ha un'intenzione locale.

Si combinano liberamente. Un francofono in Svizzera è gl=ch, hl=fr. Una ricerca in inglese da Berlino è gl=de, hl=en, location=Berlin, Berlin, Germany. Mantieni gl e il paese di location uguali: una città in un paese con gl di un altro dà risultati che nessun visitatore reale vede.

Come faccio a puntare a una città?

Scrivi il luogo in inglese, dall'unità più piccola alla più grande: City, Region, Country. Esempi: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Usa il nome della città, non una via o un codice postale.

Controlla search_parameters.location nella risposta: mostra il luogo applicato. Un valore che non può essere usato restituisce 400 invalid_parameter e non costa nulla, così puoi testare un elenco di luoghi a basso costo.

# The same query from two cities: compare the local packs
for city in "Austin, Texas, United States" "Denver, Colorado, United States"; do
  curl -sG "https://serpcrypto.com/api/v1/search" \
    -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
    --data-urlencode "q=emergency plumber" \
    --data-urlencode "location=$city" \
    -d gl=us -d hl=en -d device=mobile \
    | jq -r --arg city "$city" '.local_results[]? | "\($city)\t\(.position)\t\(.title)"'
done

Quale dominio Google devo usare?

Di solito nessuno: lascia fuori google_domain e l'API usa il dominio del paese gl, come nella tabella sopra. Impostalo solo per riprodurre una configurazione specifica, per esempio google.com con gl=gb.

Il solo dominio non definisce il paese dei risultati. gl e location fanno la maggior parte del lavoro, ed è per questo che la risposta li registra tutti e tre in search_parameters.

I risultati da mobile e da desktop sono diversi?

Spesso sì. La pagina mobile può ordinare i blocchi in modo diverso, mostrare più risultati locali per intenti di prossimità e accorciare gli snippet. Se i tuoi visitatori usano soprattutto il telefono, monitora device=mobile; per un quadro completo, monitora entrambi e salva il dispositivo con ogni posizionamento.

Ogni dispositivo è una ricerca separata, quindi monitorare entrambi raddoppia i crediti per quelle keyword. A 0,56 USD/1K ricerche sul pack 100.000 ricerche, 1.000 keyword su due dispositivi per 30 giorni usano 60.000 ricerche.

Come confronto più paesi in un unico script?

Fai un loop su una lista di mercati e conserva ciò che l'API ha applicato. L'esempio Python invia una query a tre paesi con una città ciascuno e stampa il dominio usato e il primo link.

import os

import requests

MARKETS = [
    {"gl": "de", "hl": "de", "location": "Munich, Bavaria, Germany"},
    {"gl": "fr", "hl": "fr", "location": "Lyon, Auvergne-Rhone-Alpes, France"},
    {"gl": "br", "hl": "pt-BR", "location": "Curitiba, State of Parana, Brazil"},
]

for market in MARKETS:
    r = requests.get(
        "https://serpcrypto.com/api/v1/search",
        params={"q": "running shoes", **market},
        headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
        timeout=60,
    )
    r.raise_for_status()
    applied = r.json()["search_parameters"]
    top = r.json().get("organic_results", [])[:1]
    print(applied["gl"], applied.get("google_domain"), [x["link"] for x in top])

Bing accetta gli stessi parametri?

Sì per q, gl, hl, device e page: usa gli stessi codici con engine=bing. google_domain non si applica a Bing e viene ignorato. La risposta ha la stessa struttura, con organic_results e related_searches; vedi la pagina Bing per i suoi casi d'uso.