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

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

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

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

Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

ยืนยันตัวตนครั้งเดียว แล้วเรียก 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

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

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

Properties

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

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

Google Search Console

คลิก การแสดงผล CTR และตำแหน่งเฉลี่ย — แยกตามคำค้น หน้าเว็บ ช่วงวันที่ และเทียบช่วงต่อช่วง รายละเอียดทั้งหมดอยู่ในหน้า Google Search Console API โดยเฉพาะ

  • 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เร็ว ๆ นี้

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

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 ครั้งแรกได้ในไม่กี่นาที — หรือพูดคุยกับเราเกี่ยวกับการเข้าถึงแบบพาร์ทเนอร์และมัลติเทนแนนต์