Иштеп чыгуучуларга

SERPHub REST API

35+ эндпоинттер. JSON-жооптор. Sanctum токендери. SEO маалыматтарыңызды каалаган куралга, дашбордго же жумуш процессине өткөрүңүз.

API Токенин алуу Сатуу бөлүмү менен байланыш

Тез баштоо

Аккаунттун жөндөөлөрүнөн Sanctum API токенин түзүп, аны ар бир суроо-талапта Bearer токен катары колдонуңуз.

1 Кирүү → Жөндөөлөр → Коопсуздук → API Токендер → Токен түзүү
2 Ар бир суроо-талапта токенди Authorization: Bearer СИЗДИН_ТОКЕН башкы сабында (header) жөнөтүңүз
3 Базалык URL: https://serphub.io/api/v1

curl

curl https://serphub.io/api/v1/sites \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Жооп (Response) (200)

{
  "data": [
    {
      "id": 42,
      "domain": "example.com",
      "health_score": 91,
      "last_audit_at": "2026-05-20T08:15:00Z"
    }
  ]
}

API Справочник

Бардык эндпоинттер JSON кайтарат. POST/PUT операциялары үчүн JSON форматындагы POST денеси (body) Content-Type: application/json менен талап кылынат.

Сайттар

GET /sites Бардык сайттардын тизмеси

GET /sites/{id} Сайттын маалыматтары

POST /sites Сайт кошуу

DELETE /sites/{id} Сайтты өчүрүү

Аудиттер

GET /sites/{id}/audits Сайттын аудиттеринин тизмеси

GET /sites/{id}/audits/latest Акыркы аудит

POST /sites/{id}/audits Жаңы аудитти баштоо

GET /sites/{id}/issues Ачык SEO каталар

Ачкыч сөздөр

GET /sites/{id}/keywords Позициялар (GSC)

GET /sites/{id}/keywords/top Басуулар (клики) боюнча топ сөздөр

GET /sites/{id}/cannibalization Ачкыч сөздөрдүн каннибализациясы

GET /sites/{id}/search-intent Издөө интенти (ниети)

Бэклинкттер

GET /sites/{id}/backlinks Шилтеме берген баракчалар (referring pages)

POST /sites/{id}/backlinks/verify Шилтемелерди текшерүү

GET /sites/{id}/backlinks/stats Бэклинкттердин статистикасы

ИИ-эскерүүлөр

GET /sites/{id}/ai-mentions ИИ-эскерүүлөр тизмеси

GET /sites/{id}/ai-mentions/sov Share of Voice маалыматтары

POST /sites/{id}/ai-mentions/run ИИ-эскерүүлөрдү текшерүү

Атаандаштар

GET /sites/{id}/competitors Атаандаштардын тизмеси

POST /sites/{id}/competitors Атаандаш кошуу

DELETE /sites/{id}/competitors/{competitorId} Атаандашты өчүрүү

Аутентификация жана Лимиттер

Bearer Токени (Sanctum)

Бардык API суроо-талаптарында жарактуу Sanctum access-токени болушу керек. Токендер Жөндөөлөр → Коопсуздук → API Токендер бөлүмүнөн түзүлөт. Токендердин мөөнөтү бүтпөйт, бирок аларды каалаган убакта жокко чыгарууга болот.

Лимиттер (Rate Limits)

API'ге мүмкүнчүлүк Agency жана Enterprise пландарында гана берилет.

Тариф	Мүнөтүнө суроо-талап	Күнүнө суроо-талап
Agency	120	50,000
Enterprise	Жекече	Жекече

Каталар (Error Responses)

API стандарттуу HTTP статус коддорун колдонот. Ката болгон учурда message талаасы бар JSON кайтарылат. 401 = туура эмес токен, 403 = уруксат жок, 422 = валидация катасы, 429 = лимиттен ашты.

Ката мисалы

HTTP/1.1 422
{
  "message": "Validation error",
  "errors": {
    "domain": [
      "The domain field is required."
    ]
  }
}

Интеграцияга даярсызбы?

API'ге мүмкүнчүлүк Agency жана Enterprise пландарында бар. Баштоо үчүн катталыңыз.

Баштоо Enterprise үчүн суроо