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

SERPHub REST API

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

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

Тез баштоо

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

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

curl

curl https://dev.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 Сайт кошуу

Аудиттер

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

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

GET /sites/{id}/audit/progress Аудиттин жүрүшү

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

Ачкыч сөздөр

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

GET /sites/{id}/pages Барактардын көрсөткүчтөрү

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

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

Бэклинкттер

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

GET /sites/{id}/internal-links Ички шилтеме мүмкүнчүлүктөрү

GET /sites/{id}/content-decay Контенттин эскириши боюнча отчет

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

GET /sites/{id}/aeo AEO даярдык абалы

POST /sites/{id}/ai/chat AI чатка билдирүү жөнөтүү

Атаандаштар

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

GET /sites/{id}/visibility Көрүнүү обзору

GET /sites/{id}/search-overview Издөө обзору

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

Bearer Токени (Sanctum)

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

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

API мүмкүнчүлүгү API квотасы бар тарифтерде жеткиликтүү — Pro, Agency жана Enterprise.

Тариф	Мүнөтүнө суроо-талап	Чакыруу/ай
Pro	60	1,000
Agency	60	10,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'ге мүмкүнчүлүк Pro жана андан жогорку пландарда бар. Баштоо үчүн катталыңыз.

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