01

Domains API

Перевірка доменів: GET https://linktrust.pro/api/domain?token=< api token >&< ...params >

Доступні параметри:

• ?domain=[string] - домен для аналізу
• ?format=['csv' | 'json'] - формат відповіді аналізатора (csv застаріло, найближчим часом рекомендуємо користуватись лише json)

Документ для CSV API: https://docs.google.com/spreadsheets/d/1eHrHKwDedN35x5adfsNubH1etQUoY5AIUq8kM3QiqAk/edit?usp=sharing — домени

Розрахунок домену виконується синхронно під час першого запиту, тому відповідь повертається одразу — але не всі дані ще готові. Поле message містить статус розрахунку:

• partially_done — основні метрики (spam/trust score, беклінки, трафік, ключовики) вже готові, додаткові дані ще розраховуються у фоні
• done — всі дані готові, включно з DA, wiki-беклінком, віком домену, wayback-хронологією, темами ключовиків та контактами
• failed — помилка під час розрахунку

Щоб отримати повні дані, повторіть виклик через кілька секунд — поки message не стане done. Повторні запити на той самий домен безкоштовні — токени списуються лише один раз.

Типізований опис відповіді:

Успішна відповідь: HTTP 200

{
  message: 'pending' | 'processing' | 'partially_done' | 'done' | 'failed';
  check: {
    spamScore: number | null;
    trustScore: number | null;
    monthOrganicAmount: number | null;
    monthTrafficAmount: number | null;
    trafficTrend3mPercent: number | null;
    backlinksTotal: number | null;
    backlinksDomains: number | null;
    hasWikipediaBacklink: boolean | null;
    domainDa: number | null;
    majesticTf: number | null;
    majesticCf: number | null;
    domainRegisteredAt: string | null; // YYYY-MM-DD
    waybackOldestAt: string | null; // YYYY-MM-DD
    waybackHasGaps: boolean | null;
    waybackTimeline: { from: string; to: string; months: number }[] | null;
    keywordTopics: string[] | null;
    contacts: { email: string | null; socials: Record<string, string> } | null;
    categories: string[] | null;
    countries: { country: string; percent: number }[] | null;
    backlinks: {
      toUrl: string;
      fromUrl: string;
      nofollow: boolean;
      fromAnchor: string | null;
      fromDomain: string;
      fromDomainRank: number;
    }[];
    keywords: {
      serp_found_url: string;
      serp_position: number;
      keyword: string;
      country: string;
      volume: number;
    }[];
  };
}

Помилка валідації: HTTP 422

{
  message: string;                    // validation failed / invalid domain
  errors?: Record<string, string[]>;  // field => list of messages, absent for invalid domain
}

Помилка: HTTP 401 | 402

{
  message: string;   // 401 - authorization failed, 402 - no tokens
  status?: 'error';  // present when authorization failed
}

02

Serp API

Перевірка позицій google: GET https://linktrust.pro/api/serp?token=< api token >&< ...params >

Доступні параметри:

• ?q=[string] - ключ для зняття позицій
• ?hl=[string] - google hl
• ?gl=[string] - google gl
• ?uule=[string] - google uule
• ?depth=[int] - глибина сканування (10-100)

Типізований опис відповіді:

Успішна відповідь: HTTP 200

{
  status: 'success';
  serp: {
    position: number;
    title: string;
    url: string;
    description: string;
  }[];
}

Помилка валідації: HTTP 422

{
  status: 'error';
  errors: Record<string, string[]>;  // field => list of messages
}

Помилка: HTTP 401 | 402 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 402 - no tokens, 500 - system error
}

03

Check Indexation Single URL API

Перевірка індексації google: GET https://linktrust.pro/api/check-indexation?token=< api token >&< ...params >

Доступні параметри:

• ?url=[string] - url для перевірки

Типізований опис відповіді:

Успішна відповідь: HTTP 200

{
  status: 'success';
  url: string;
  is_indexed: boolean;
}

Помилка валідації: HTTP 422

{
  status: 'error';
  errors: Record<string, string[]>;  // field => list of messages
}

Помилка: HTTP 401 | 402 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 402 - no tokens, 500 - system error
}

04

Check Indexation Batch API

Пакетна перевірка індексації google:

Створення запиту:

POST https://linktrust.pro/api/check-indexation-batch?token=< api token >

Доступні параметри:

• token=[string] - API токен
• urls=[array] - масив URL для перевірки (1-5000)
• name=[string] (опціонально) - назва пакетного запиту

Типізований опис відповіді:

Успішна відповідь: HTTP 200

{
  status: 'success';
  id: number;
  check_status: 'pending';
  urls_count: number;
  message: string;
}

Помилка валідації: HTTP 422

{
  status: 'error';
  errors: Record<string, string[]>;  // field => list of messages
}

Помилка: HTTP 401 | 402 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 402 - no tokens, 500 - system error
}

Отримання результатів:

GET https://linktrust.pro/api/check-indexation-batch/{id}?token=< api token >

Статуси перевірки:

• pending - очікує обробки
• processing - виконується
• done - завершено, результати доступні
• failed - помилка виконання

Типізований опис відповіді:

Результати ще не готові: HTTP 200

{
  id: number;
  name: string;
  check_status: 'pending' | 'processing' | 'failed';
}

Результати готові: HTTP 200

{
  id: number;
  name: string;
  check_status: 'done';
  results: Record<string, boolean>;  // url => is indexed
  total_indexed: number;
  total_not_indexed: number;
}

Запит не знайдено: HTTP 404

{
  status: 'error';
  message: string;  // batch not found or belongs to another user
}

Помилка: HTTP 401 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 500 - system error
}

05

Indexation Request API

Відправка посилань на індексацію в google:

Створення запиту:

POST https://linktrust.pro/api/indexation-request?token=< api token >

Доступні параметри:

• token=[string] - API токен
• urls=[array] - масив URL для індексації (1-500)
• name=[string] (опціонально) - назва запиту на індексацію

Типізований опис відповіді:

Успішна відповідь: HTTP 200

{
  status: 'success';
  id: number;
  indexation_status: 'pending';
  urls_count: number;
  message: string;
}

Помилка валідації: HTTP 422

{
  status: 'error';
  errors: Record<string, string[]>;  // field => list of messages
}

Помилка: HTTP 401 | 402 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 402 - no tokens, 500 - system error
}

Перегляд запиту:

GET https://linktrust.pro/api/indexation-request/{id}?token=< api token >

Статуси запиту (indexation_status):

• pending - очікує обробки
• processing - виконується
• done - всі посилання відправлено на індексацію
• partially_done - на індексацію відправлено лише частину посилань
• failed - помилка виконання

Статуси перевірки індексації (indexation_check_status):

• pending - індексація ще не перевірялась
• done - індексацію перевірено, результати доступні

Перевіряємо автоматично один раз, на 10-й день після відправки.

Типізований опис відповіді:

Індексацію ще не перевірено: HTTP 200

{
  id: number;
  name: string;
  indexation_status: 'pending' | 'processing' | 'done' | 'partially_done' | 'failed';
  urls_count: number;
  indexation_requested_at: string | null;  // ISO 8601, when urls were sent to indexation
  indexation_check_status: 'pending';
  indexation_checked_at: null;
}

Індексацію перевірено: HTTP 200

{
  id: number;
  name: string;
  indexation_status: 'done' | 'partially_done';
  urls_count: number;
  indexation_requested_at: string;         // ISO 8601, when urls were sent to indexation
  indexation_check_status: 'done';
  indexation_checked_at: string;           // ISO 8601, when indexation was checked
  results: Record<string, boolean>;        // url => is indexed
  total_indexed: number;
  total_not_indexed: number;
}

Запит не знайдено: HTTP 404

{
  status: 'error';
  message: string;  // request not found or belongs to another user
}

Помилка: HTTP 401 | 500

{
  status: 'error';
  message: string;  // 401 - authorization failed, 500 - system error
}

06

Баланси користувача:

https://linktrust.pro/api/balance?token=< api token >