Search Console API · REST v1 · เอกสารพร้อมใช้งาน

Google Search Console API สำหรับสแตกของคุณเอง

ข้อมูลประสิทธิภาพจาก Search Console ของคุณ ผ่าน REST endpoint ที่สะอาดตา

ดึงคลิก การแสดงผล CTR และตำแหน่งเฉลี่ย แยกตามคำค้น หน้าเว็บ และช่วงวันที่ จาก Google Search Console เข้าสู่โปรดักต์ แดชบอร์ด หรือดาต้าแวร์เฮาส์ของคุณได้โดยตรง เชื่อมต่อ GSC ครั้งเดียวภายใน SEOcrawl AI สร้างคีย์ Bearer จากแดชบอร์ดของคุณ แล้วเรียก REST /v1 — โดยไม่ต้องสร้าง OAuth ของ Google เอง นี่คือเลเยอร์ข้อมูลมาตรฐานเดียวกับที่ขับเคลื่อน SEOcrawl AI MCP ตัวเลขของคุณจึงตรงกันเสมอ ส่วนความครอบคลุมของการจัดทำดัชนีและ URL Inspection กำลังจะมาบน REST เป็นลำดับถัดไป และใช้ผ่าน MCP ได้แล้ววันนี้

รับ API key ของคุณอ่านเอกสาร APIสำรวจ MCP
Claude
Codex CLI
Cursor
Google Search Console API ของ SEOcrawl AI — คำสั่ง curl หนึ่งคำสั่งและผลลัพธ์ JSON ที่มีชนิดข้อมูลชัดเจน ประกอบด้วยคลิก การแสดงผล CTR และตำแหน่ง
ตัวอย่างการเรียก Google Search Console API ด้วย cURL, JavaScript และ Python

หาพร็อพเพอร์ตี้ให้เจอ แล้วดึงข้อมูล GSC

สร้าง Bearer token จากแดชบอร์ดของคุณแล้วส่งใน Authorization header หา id ของพร็อพเพอร์ตี้ Search Console เพียงครั้งเดียว จากนั้นค่อยเรียกดูประสิทธิภาพของพร็อพเพอร์ตี้นั้นผ่าน REST คีย์เดียวกันใช้ได้ทั้งกับ REST API และ MCP server

Base URL

https://api.seocrawl.ai/v1

Authorization header

Authorization: Bearer sca_live_your_token_here
รับ API key ของคุณRead the API docs

ทุกเมตริกของ Search Console, ครบผ่าน REST

คลิก การแสดงผล CTR และตำแหน่งเฉลี่ย — แยกตามคำค้น หน้าเว็บ ช่วงวันที่ และเทียบช่วงต่อช่วง ทุก endpoint ผูกกับพร็อพเพอร์ตี้เสมอ: หา id ของพร็อพเพอร์ตี้ก่อน แล้วจึงอ่านข้อมูล Search Console ของมัน กลุ่ม GSC เหล่านี้พร้อมใช้งานแล้วใน v1 ส่วนความครอบคลุมของการจัดทำดัชนีและ URL Inspection วันนี้เปิดให้ใช้ผ่าน MCP และจะมาบน REST เป็นลำดับถัดไป

พร็อพเพอร์ตี้

แสดงรายการพร็อพเพอร์ตี้ Search Console ที่เชื่อมต่อกับบัญชีของคุณ ใช้ id ของแต่ละพร็อพเพอร์ตี้ใน path ของทุก endpoint ของ GSC

  • GET/v1/propertiesพร้อมใช้

ประสิทธิภาพ

ยอดรวมคลิก การแสดงผล CTR และตำแหน่งเฉลี่ยของช่วงวันที่ที่เลือก พร้อมส่วนต่างเทียบกับช่วงก่อนหน้าของกรอบเวลาเดียวกัน

  • GET/v1/properties/{id}/gsc/summaryพร้อมใช้
  • GET/v1/properties/{id}/gsc/compareพร้อมใช้

คำค้น

คำค้นที่เว็บของคุณติดอันดับอยู่ พร้อมเมตริกรายคำค้น และประวัติรายวันแบบเต็มของคีย์เวิร์ดใดก็ได้

  • GET/v1/properties/{id}/gsc/top-keywordsพร้อมใช้
  • GET/v1/properties/{id}/gsc/keywords/detailพร้อมใช้

หน้าเว็บ

URL ที่ทำผลงานได้ดีที่สุดพร้อมเมตริกจาก Search Console และรายละเอียดประสิทธิภาพรายวันแบบเต็มของหน้าใดก็ได้

  • GET/v1/properties/{id}/gsc/top-pagesพร้อมใช้
  • GET/v1/properties/{id}/gsc/pages/detailพร้อมใช้

ความครอบคลุมของดัชนี

สิ่งที่ Google จัดทำดัชนีจริง ๆ: สถานะความครอบคลุมและประวัติการจัดทำดัชนี วันนี้ใช้ได้แล้วใน MCP ส่วน endpoint ฝั่ง REST กำลังทยอยเปิด

  • GET/v1/properties/{id}/indexation/summaryเร็ว ๆ นี้

URL Inspection

ตรวจสอบราย URL — ความครอบคลุม การรวบรวมข้อมูลครั้งล่าสุด และสถานะการจัดทำดัชนีของหน้าเดียว ใช้ผ่าน MCP ได้แล้ววันนี้ ส่วน REST จะตามมา

  • GET/v1/properties/{id}/url-inspectionเร็ว ๆ นี้

ข้อมูล Search Console ของจริง, สร้างมาเพื่อโปรดักต์

ประสิทธิภาพจริงบน Google Search Console ของคุณ — ไม่ใช่ตัวเลขประมาณการจากบุคคลที่สาม — ผ่าน REST API ที่สะอาดตา มีการยืนยันตัวตนด้วย Bearer และขีดจำกัดการเรียก ใช้เลเยอร์ข้อมูลมาตรฐานร่วมกับ MCP ตัวเลขจึงไม่มีทางขัดกันเอง

ตรงจาก Search Console

คลิก การแสดงผล CTR และตำแหน่งเฉลี่ย ดึงจากพร็อพเพอร์ตี้ GSC ของคุณเอง — ตัวเลขจริงที่ Google รายงาน ไม่ใช่ค่าประมาณจากโมเดลหรือการสแครป รีซอร์สคาดเดาได้ ใช้ verb มาตรฐาน JSON มีชนิดข้อมูลชัดเจน และข้อผิดพลาดเป็นไปตาม RFC

ไม่ต้องสร้าง OAuth ของ Google

เชื่อมต่อ Search Console ครั้งเดียวภายใน SEOcrawl AI แล้วอ่านข้อมูลด้วยคีย์ Bearer sca_live_ เพียงคีย์เดียว ข้ามเรื่องโปรเจกต์ Google Cloud หน้าจอขอความยินยอม และการรีเฟรช token ไปได้เลย — สร้างและเพิกถอนคีย์จากแดชบอร์ดของคุณได้ในไม่กี่วินาที

เลเยอร์ข้อมูลมาตรฐานชุดเดียว

REST endpoint ของ GSC กับเครื่องมือ GSC ใน MCP เป็นพี่น้องกันบนผู้ให้บริการชุดเดียวกัน โดยทดสอบความสอดคล้องใน CI แดชบอร์ดและ AI agent ของคุณจึงเห็นคลิก การแสดงผล และตำแหน่งที่ตรงกันเสมอ

ละเอียดถึงระดับคำค้นและหน้าเว็บ

อ่านยอดรวมของทั้งพร็อพเพอร์ตี้ หรือเจาะลงไปที่คำค้นยอดนิยม หน้ายอดนิยม แนวโน้มรายวันของคีย์เวิร์ดเดียว หรือประวัติของ URL เดียว — มิติเดียวกับที่คุณเห็นใน Search Console แต่เรียกผ่าน HTTP ได้

เทียบช่วงต่อช่วงมาให้ในตัว

ระบุ range (last_7_days, last_28_days, last_3_months, last_year) หรือกำหนดวันที่ from/to เอง แล้วรับผลเปรียบเทียบระหว่างช่วงมาพร้อมกันเลย — ไม่ต้องเรียกรอบสอง และไม่ต้องคำนวณวันที่ฝั่งไคลเอนต์เพื่อกระทบยอดส่วนต่าง

ขีดจำกัดการเรียกที่ระบุไว้ชัดเจน

60 คำขอต่อนาที และ 1,000 คำขอต่อชั่วโมงต่อหนึ่ง token พร้อมการตอบกลับ 429 + Retry-After ที่ชัดเจน โควตาของ REST แยกกองกับการใช้งาน MCP — ฝั่งหนึ่งจึงไม่มีทางกินโควตาอีกฝั่งจนหมด

เริ่มใน 3 ขั้นตอน

จากศูนย์ถึงการเรียกข้อมูล Search Console ครั้งแรกภายในไม่กี่นาที

1

สร้างคีย์

เชื่อมต่อ Search Console ใน SEOcrawl AI แล้วเปิด API tokens เพื่อสร้าง Bearer token คัดลอกเก็บไว้ทันทีเพราะจะเห็นครั้งเดียว — คีย์จะขึ้นต้นด้วย sca_live_

2

หาพร็อพเพอร์ตี้ให้เจอ

เรียก GET /v1/properties พร้อม Authorization: Bearer sca_live_… เพื่อรับ id (เป็น UUID) ของพร็อพเพอร์ตี้ Search Console ที่คุณต้องการอ่าน

3

ดึงข้อมูล GSC

เรียก /v1/properties/{id}/gsc/summary?range=last_28_days เพื่อดูยอดรวม หรือใช้ /gsc/top-keywords, /gsc/top-pages และ endpoint /detail — แล้วส่ง JSON เข้าโปรดักต์ แดชบอร์ด หรือแวร์เฮาส์ของคุณได้ทันที

สามวิธี ในการเข้าถึงข้อมูล Search Console

ตัวเลข GSC ชุดเดียวกัน แต่คนละพื้นผิวการใช้งาน — เลือกแบบที่เข้ากับวิธีสร้างของคุณ

REST API

สำหรับโปรดักต์ แดชบอร์ด และไปป์ไลน์ข้อมูล ยืนยันตัวตนด้วย Bearer, JSON มีชนิดข้อมูลชัดเจน, มีขีดจำกัดการเรียก คุณกำลังอยู่บนหน้านี้ — SEO API แบบเต็ม เพิ่ม endpoint เรื่องอันดับและการมองเห็นบน AI ด้วยคีย์เดิม

MCP server

สำหรับ AI agent — Claude, ChatGPT และไคลเอนต์ MCP ใด ๆ ถามข้อมูล Search Console ของคุณด้วยภาษาธรรมชาติได้เลย

สำรวจ MCP

เทอร์มินัลและ CLI

สำหรับสคริปต์และ CI/CD — สั่งงานข้อมูล GSC ของคุณจาก terminal agent ตัวไหนก็ได้ที่รองรับ MCP

ดู CLI
เทียบการเชื่อมต่อทั้งหมด

Search Console API นี้ เหมาะกับใคร

ทีมที่อยากได้ข้อมูลประสิทธิภาพ GSC ของจริงไว้ในระบบของตัวเอง

เอเจนซี

ส่งข้อมูล Search Console ของลูกค้าทุกรายเข้าพอร์ทัลที่ทำเอง Looker Studio หรือเลเยอร์รายงานของคุณ — คีย์เดียว ครบทุกพร็อพเพอร์ตี้ ไม่ต้องเอ็กซ์พอร์ต GSC ด้วยมืออีกต่อไป

SaaS และพาร์ทเนอร์

ฝังเมตริก Search Console แบบสดเข้าไปใน UI ของโปรดักต์คุณเอง ให้ผู้ใช้เห็นคลิก การแสดงผล และตำแหน่ง โดยไม่ต้องต่อ API ของ Google เอง

ทีมข้อมูล

ส่งคลิก การแสดงผล CTR และตำแหน่งจาก GSC ลงแวร์เฮาส์ตามตารางเวลา นำไปเชื่อมกับรายได้ แล้วสร้างโมเดลที่แดชบอร์ดของคุณต้องใช้

นักพัฒนา

ทำระบบเฝ้าดูคำค้นและหน้าเว็บอัตโนมัติ แจ้งเตือนเมื่ออันดับตก และต่อข้อมูล Search Console เข้ากับแอปและเวิร์กโฟลว์ที่คุณใช้งานอยู่แล้ว

คำถามที่พบบ่อย

นี่คือ Search Console API อย่างเป็นทางการของ Google หรือเปล่า?

ไม่ใช่ นี่คือ REST API ของ SEOcrawl AI เองที่ยืนยันตัวตนด้วย Bearer วางอยู่บนข้อมูล Search Console ที่คุณเชื่อมต่อกับบัญชีไว้แล้ว คุณเชื่อมต่อ GSC ครั้งเดียวภายใน SEOcrawl AI จากนั้นก็อ่านคลิก การแสดงผล CTR และตำแหน่งผ่านคีย์ sca_live_ เพียงคีย์เดียว — โดยไม่ต้องสร้างโปรเจกต์ Google Cloud หน้าจอขอความยินยอมแบบ OAuth หรือกลไกรีเฟรช token เอง ตัวเลขคือตัวเลข Search Console จริงของคุณ ส่วน API และการยืนยันตัวตนเป็นของเรา

วันนี้ดึงข้อมูล Search Console อะไรได้บ้าง?

ยอดรวมของช่วงวันที่ (คลิก การแสดงผล CTR ตำแหน่งเฉลี่ย), การเปรียบเทียบช่วงต่อช่วง, คำค้นและหน้ายอดนิยมพร้อมเมตริก และรายละเอียดรายวันแบบเต็มของคำค้นเดียวหรือหน้าเดียว รวมถึงรายการพร็อพเพอร์ตี้ที่คุณเชื่อมต่อไว้ ส่วนความครอบคลุมของดัชนีและ URL Inspection แบบสดนั้นใช้ได้แล้วผ่าน MCP และ endpoint ฝั่ง REST จะทยอยตามมา หากคุณอยากอ่านภาพรวมของบัญชีมากกว่าจะไล่เรียกทีละ endpoint การตรวจสอบ Google Search Console ครอบคลุมข้อมูลชุดเดียวกันนี้ได้ในพรอมป์ตเดียว

ยืนยันตัวตนอย่างไร?

ด้วย Bearer token สร้างคีย์ sca_live_ จากแดชบอร์ดของคุณ แล้วส่งเป็น Authorization: Bearer <key> ในทุกคำขอ สำหรับบัญชีของคุณเองไม่ต้องวนลูป OAuth ใด ๆ — มีแค่ header นี้ก็พอ

รองรับช่วงวันที่แบบไหนบ้าง?

ทุก endpoint ของ GSC รับได้ทั้ง range (last_7_days, last_28_days, last_3_months หรือ last_year) หรือคู่ from/to ที่ระบุเอง ส่วน endpoint gsc/compare จะคืนกรอบเวลาเดิมที่เทียบกับช่วงก่อนหน้าให้ คุณจึงได้ส่วนต่างโดยไม่ต้องเรียกรอบสอง

ขีดจำกัดการเรียกเป็นเท่าไร?

60 คำขอต่อนาที และ 1,000 คำขอต่อชั่วโมงต่อหนึ่ง token หากเกินจะได้รับ 429 พร้อม header Retry-After โควตาของ REST นับแยกจากการใช้งาน MCP ทั้งสองฝั่งจึงไม่แย่งงบประมาณเดียวกัน

ใช้คีย์และข้อมูลชุดเดียวกับ MCP ไหม?

ใช่ token sca_live_ ตัวเดียวกันยืนยันตัวตนได้ทั้ง REST API และ MCP server และทั้งคู่อ่านจากเลเยอร์ข้อมูลมาตรฐานชุดเดียวกัน ตัวเลข Search Console ที่คุณดึงผ่าน REST จึงเหมือนกับที่ AI agent ของคุณเห็นผ่าน MCP ทุกประการ หนึ่งข้อมูลรับรอง สองพื้นผิวการใช้งาน

พร้อมสร้างบนข้อมูล Search Console ของคุณแล้วหรือยัง?

เชื่อมต่อ GSC ครั้งเดียว สร้างคีย์ Bearer จากแดชบอร์ดของคุณ แล้วยิงคำขอ REST ไปที่ Search Console ครั้งแรกได้ในไม่กี่นาที — หรือจะไปสำรวจ MCP สำหรับ AI agent ก่อนก็ได้

รับ API key ของคุณอ่านเอกสาร APIจองเดโม