ตำแหน่งและภาษา: gl, hl, location, google_domain และ device

gl, hl และ location ต่างกันอย่างไร

gl ระบุว่าต้องการผลการค้นหาของประเทศใด hl ระบุว่าผู้ใช้อ่านภาษาอะไร ซึ่งเปลี่ยนอินเทอร์เฟซและบ่อยครั้งเปลี่ยนคำถามและสแนปเป็ต location เจาะจงประเทศลงไปถึงเมืองหรือภูมิภาค ซึ่งสำคัญทันทีที่คำค้นหามีเจตนาเชิงท้องถิ่น

ใช้ร่วมกันได้อย่างอิสระ ผู้พูดภาษาฝรั่งเศสในสวิตเซอร์แลนด์คือ gl=ch, hl=fr การค้นหาภาษาอังกฤษจากเบอร์ลินคือ gl=de, hl=en, location=Berlin, Berlin, Germany ให้ gl และประเทศของ location ตรงกัน: เมืองในประเทศหนึ่งกับ gl ของอีกประเทศจะให้ผลการค้นหาที่ไม่มีผู้เยี่ยมชมจริงคนใดเห็น

ฉันจะกำหนดเป้าหมายเป็นเมืองได้อย่างไร

เขียนชื่อสถานที่ในภาษาอังกฤษ จากหน่วยเล็กสุดไปใหญ่สุด: City, Region, Country ตัวอย่าง: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France ใช้ชื่อเมือง ไม่ใช่ชื่อถนนหรือรหัสไปรษณีย์

ตรวจสอบ search_parameters.location ในคำตอบ: มันแสดงสถานที่ที่ถูกใช้ ค่าที่ใช้ไม่ได้จะคืน 400 invalid_parameter และไม่มีค่าใช้จ่าย คุณจึงทดสอบรายชื่อสถานที่ได้อย่างประหยัด

# 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

ควรใช้โดเมน Google ไหน?

โดยปกติไม่ต้องระบุ: ปล่อย google_domain ไว้ แล้ว API จะใช้โดเมนของประเทศ gl ตามตารางด้านบน ตั้งค่าก็ต่อเมื่อต้องจำลองการตั้งค่าเฉพาะ เช่น google.com กับ gl=gb

โดเมนเพียงอย่างเดียวไม่ได้กำหนดประเทศของผลลัพธ์ gl และ location คือตัวกำหนดหลัก ซึ่งเป็นเหตุผลที่คำตอบบันทึกทั้งสามค่าไว้ใน search_parameters

ผลการค้นหาบนมือถือและเดสก์ท็อปต่างกันไหม?

บ่อยครั้งที่ต่างกัน หน้ามือถืออาจจัดลำดับบล็อกต่างออกไป แสดงผลลัพธ์ท้องถิ่นมากกว่าสำหรับเจตนาค้นหาใกล้เคียง และตัด snippet ให้สั้นลง หากผู้เข้าชมของคุณส่วนใหญ่ใช้มือถือ ให้ติดตาม device=mobile; หากต้องการภาพรวมทั้งหมด ให้ติดตามทั้งสองแบบและบันทึกอุปกรณ์ไว้กับแต่ละอันดับ

แต่ละอุปกรณ์คือการค้นหาแยกกัน ดังนั้นการติดตามทั้งสองแบบจะใช้เครดิตเป็นสองเท่าสำหรับคำค้นหาเหล่านั้น ที่ US$0.56/1K การค้นหา ในแพ็ก 100,000 การค้นหา คำค้นหา 1,000 คำบนสองอุปกรณ์เป็นเวลา 30 วันใช้ 60,000 การค้นหา

จะเปรียบเทียบหลายประเทศในสคริปต์เดียวได้อย่างไร?

วนลูปผ่านรายการตลาดและเก็บค่าที่ API ใช้จริง ตัวอย่าง Python ส่งหนึ่งคำค้นหาไปยังสามประเทศโดยระบุเมืองแต่ละแห่ง แล้วพิมพ์โดเมนที่ใช้และลิงก์แรก

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 ใช้พารามิเตอร์เดียวกันไหม?

ใช่สำหรับ q, gl, hl, device และ page: ใช้โค้ดเดียวกันกับ engine=bing ได้เลย google_domain ใช้ไม่ได้กับ Bing และจะถูกเพิกเฉย คำตอบมีโครงสร้างเหมือนกัน โดยมี organic_results และ related_searches ดูหน้า Bing สำหรับกรณีการใช้งาน