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

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

ข้อมูล SEO และการมองเห็นบน AI ของคุณ ผ่าน REST endpoint ที่สะอาดตา

ดึงข้อมูล Google Search Console อันดับ และ AI Tracker เข้าสู่โปรดักต์ แดชบอร์ด หรือดาต้าแวร์เฮาส์ของคุณได้โดยตรง ยืนยันตัวตนด้วย Bearer key จากแดชบอร์ดของคุณ เรียก REST `/v1` แล้วรับ JSON ที่มีชนิดข้อมูลชัดเจนกลับมา — เลเยอร์ข้อมูลมาตรฐานเดียวกับที่ขับเคลื่อน SEOcrawl AI MCP ส่วน GA4 การส่งออกผลตรวจสอบไซต์แบบเต็ม และ OAuth พาร์ทเนอร์แบบมัลติเทนแนนต์ กำลังทยอยเปิดตัวถัดไป

รับ API key ของคุณสำรวจ MCP

ยืนยันตัวตนด้วย Bearer · 60 req/min · เลเยอร์ข้อมูลเดียวกับ MCP · ไม่มีการสแครป

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

},

"metrics_diff": { "clicks": 584, … }

} }

ยืนยันตัวตนครั้งเดียว แล้วเรียก REST

สร้าง Bearer token จากแดชบอร์ดของคุณแล้วส่งใน Authorization header คีย์เดียวกันใช้ได้ทั้งกับ 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
cURLJavaScriptPython
# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())
Endpoints

เลเยอร์ข้อมูลเดียว สองพื้นผิวการใช้งาน

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

Properties

แสดงรายการพร็อพเพอร์ตี้ Search Console ที่คุณเข้าถึงได้ ใช้ `id` ของแต่ละพร็อพเพอร์ตี้ใน path ของทุก data endpoint

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

Google Search Console

คลิก การแสดงผล 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/top-pagesพร้อมใช้
  • GET/v1/properties/{id}/gsc/keywords/detailพร้อมใช้
  • GET/v1/properties/{id}/gsc/pages/detailพร้อมใช้

AI Tracker

อ่านพรอมป์ตที่คุณเฝ้าติดตามการกล่าวถึงแบรนด์ครอบคลุม ChatGPT, Claude, Gemini และ Perplexity

  • GET/v1/properties/{id}/ai-tracker/promptsพร้อมใช้

Tasks

อ่านและเขียนงาน SEO — เชื่อมบอร์ดงานของคุณเข้ากับสแตกการจัดการโปรเจกต์ของคุณเอง

  • GET/v1/properties/{id}/tasksพร้อมใช้
  • POST/v1/properties/{id}/tasksพร้อมใช้
  • GET/v1/properties/{id}/tasks/{ticketId}พร้อมใช้
  • PATCH/v1/properties/{id}/tasks/{ticketId}พร้อมใช้
  • POST/v1/properties/{id}/tasks/{ticketId}/commentsพร้อมใช้

GA4 & การจัดทำดัชนี

ทราฟฟิก ผู้อ้างอิงจาก AI และสถานะการจัดทำดัชนี ส่วนเชื่อมต่อพร้อมแล้ว REST endpoint กำลังทยอยเปิดตัว

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

การตรวจสอบไซต์

สุขภาพการรวบรวมข้อมูล องค์ประกอบบนหน้า เทคนิค และรายการปัญหา — ชุดข้อมูลการตรวจสอบเต็มรูปแบบ เปิดผ่าน REST

  • GET/v1/properties/{id}/audit/summaryเร็ว ๆ นี้
  • GET/v1/properties/{id}/audit/issuesเร็ว ๆ นี้
ทำไมต้อง API นี้

สร้างมาเพื่อโปรดักต์ ไม่ใช่นักสแครป

REST API ตัวจริงพร้อมการยืนยันตัวตนด้วย Bearer สโคป และเรตลิมิต — ใช้เลเยอร์ข้อมูลมาตรฐานเดียวร่วมกับ MCP เพื่อให้ตัวเลขไม่มีวันขัดแย้งกัน

REST ที่สะอาด, JSON ที่มีชนิดข้อมูลชัดเจน

รีซอร์สที่คาดเดาได้ HTTP verb มาตรฐาน การตอบกลับเป็น JSON ที่มีชนิดข้อมูลชัดเจน และข้อผิดพลาดตามมาตรฐาน RFC (401 unauthenticated, 403 scope_required, 429 พร้อม Retry-After) ไม่มีการสแครป HTML ไม่มีการส่งออกที่เปราะบาง

เลเยอร์ข้อมูลมาตรฐานหนึ่งเดียว

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

คีย์แบบบริการตนเอง

สร้างและเพิกถอน Bearer token จากแดชบอร์ดของคุณได้ในไม่กี่วินาที คีย์ sca_live_ เดียวกันยืนยันตัวตนได้ทั้ง REST API และ MCP server — ข้อมูลรับรองเดียว สองพื้นผิว

เรตลิมิตที่มีเอกสารกำกับ

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

การเข้าถึงแบบมีสโคป

สโคปอ่านและเขียนแบบหยาบควบคุมทุก endpoint บังคับใช้ที่ firewall พร้อมการตอบกลับ step-up มาตรฐาน มอบสิทธิ์ให้คีย์เท่าที่จำเป็นเท่านั้น

มัลติเทนแนนต์ กำลังจะมา

ฟลว์ Google OAuth ต่อเทนแนนต์ ให้พาร์ทเนอร์เชื่อมต่อพร็อพเพอร์ตี้ GSC ของลูกค้าแต่ละรายไว้ภายใต้บัญชีเดียว — พร้อมการแยกข้อมูลอย่างเข้มงวด อยู่ระหว่างการพัฒนา ติดต่อเราเพื่อขอสิทธิ์เข้าถึงก่อนใคร

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

จากศูนย์สู่การเรียกที่ยืนยันตัวตนครั้งแรกภายในไม่กี่นาที

1

สร้างคีย์

เปิดAPI tokensในแดชบอร์ดของคุณแล้วสร้าง Bearer token คัดลอกไว้ครั้งเดียว — มันขึ้นต้นด้วย `sca_live_`

2

ส่ง header

ส่ง `Authorization: Bearer sca_live_…` ในทุกคำขอไปยัง `https://api.seocrawl.ai/v1` คีย์เดียวกันนี้ยังใช้ได้กับ MCP server ด้วย

3

ดึงข้อมูล

เรียก `GET /v1/properties` เพื่อรับ `id` ของพร็อพเพอร์ตี้ จากนั้นเรียก `/v1/properties/{id}/…` เพื่อดึงประสิทธิภาพ GSC พรอมป์ต AI Tracker หรืองาน — แล้วป้อน JSON เข้าสู่โปรดักต์ แดชบอร์ด หรือแวร์เฮาส์ของคุณได้ทันที

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

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

REST API

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

MCP server

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

สำรวจ MCP

เทอร์มินัล & CLI

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

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

ใครบ้างที่สร้างบน API นี้

ทีมที่ต้องการข้อมูล SEO และการมองเห็นบน AI อยู่ภายในระบบของตนเอง

SaaS & พาร์ทเนอร์

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

เอเจนซี

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

ทีมข้อมูล

นำข้อมูล GSC อันดับ และ AI Tracker ลงแวร์เฮาส์ของคุณตามตารางเวลา เชื่อมกับรายได้แล้วสร้างโมเดลที่แดชบอร์ดของคุณต้องการ

นักพัฒนา

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

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

มี SEO API สาธารณะจริง ๆ หรือ?

ใช่ — REST `/v1` API ที่ยืนยันตัวตนด้วย Bearer พร้อมใช้งานแล้ว ครอบคลุมประสิทธิภาพ Search Console, พร็อพเพอร์ตี้, พรอมป์ต AI Tracker และงาน พร้อมเอกสารอ้างอิงสาธารณะฉบับเต็มที่เผยแพร่ไว้ที่ api.seocrawl.ai/docs ความครอบคลุมที่กว้างขึ้น (GA4, การส่งออกผลตรวจสอบไซต์แบบเต็ม) และ OAuth พาร์ทเนอร์แบบมัลติเทนแนนต์ กำลังทยอยเปิดตัวถัดไป ต้องการสิ่งที่ยังไม่พร้อมใช้งานใช่ไหม? ติดต่อเราเพื่อขอสิทธิ์เข้าถึงก่อนใคร

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

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

เป็นคีย์เดียวกับ MCP ไหม?

ใช่ โทเคนเดียวกันยืนยันตัวตนได้ทั้ง REST API และ MCP server เพราะทั้งคู่อ่านจากเลเยอร์ข้อมูลมาตรฐานหนึ่งเดียว ข้อมูลรับรองเดียว สองพื้นผิว — และตัวเลขที่ตรงกันทั้งสองฝั่ง

เรตลิมิตเป็นอย่างไร?

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

ฉันเชื่อมต่อพร็อพเพอร์ตี้ Search Console ของลูกค้าได้ไหม?

ฟลว์พาร์ทเนอร์แบบมัลติเทนแนนต์นั้น — Google OAuth ต่อเทนแนนต์ ที่ให้คุณเชื่อมต่อพร็อพเพอร์ตี้ GSC ของลูกค้าแต่ละรายไว้ภายใต้บัญชีของคุณเอง พร้อมการแยกข้อมูลอย่างเข้มงวด — อยู่ระหว่างการพัฒนา หากคุณกำลังสร้างการเชื่อมต่อแบบพาร์ทเนอร์ ติดต่อเราเพื่อขอสิทธิ์เข้าถึงก่อนใคร

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

สรุปและการเปรียบเทียบช่วงเวลาของ Search Console, คำค้นและหน้ายอดนิยม, รายละเอียดคำค้น/หน้าเดียว, รายการพร็อพเพอร์ตี้ของคุณ, พรอมป์ต AI Tracker และการอ่าน/เขียนงานแบบเต็ม มันสะท้อนสิ่งที่ MCP เปิดให้ใช้ ผ่าน REST

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

สร้าง Bearer key จากแดชบอร์ดของคุณแล้วเรียก REST ครั้งแรกได้ในไม่กี่นาที — หรือพูดคุยกับเราเกี่ยวกับการเข้าถึงแบบพาร์ทเนอร์และมัลติเทนแนนต์

รับ API key ของคุณจองเดโม