Документація

Як працює IndexFast

Повний посібник з налаштування та використання IndexFast — від отримання ключа API до автоматичної щоденної індексації.

⚡ Швидкий старт

Щоб почати роботу з IndexFast вам потрібно виконати 3 кроки. Весь процес займає близько 10–15 хвилин.

✅ Вимоги

Перед початком роботи переконайтеся, що у вас є:

☁️ Налаштування Google Cloud

Увімкнення API

Перейдіть до Google Cloud Console → APIs & Services → Library. Знайдіть «Web Search Indexing API» і натисніть Enable.

Створення Service Account

Service Account — це технічний обліковий запис без пароля, який IndexFast використовує для авторизації в Google API. Щоб його створити, потрібен проєкт у Google Cloud.

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "abc123...",
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\n...",
  "client_email": "[email protected]",
  "client_id": "123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token"
}

🔗 Підключення Search Console

Без цього кроку API буде повертати помилку 403 Forbidden навіть при правильному ключі. Service Account має отримати статус власника сайту в Google Search Console.

🗺 Sitemap.xml

IndexFast читає ваш sitemap.xml для отримання URL-адрес, які потрібно відправити на індексацію. Підтримуються всі формати.

Підтримувані формати

• ✅ sitemap.xml — стандартний файл з URL
• ✅ sitemap_index.xml — батьківський файл з посиланнями на дочірні sitemap (будь-яка глибина вкладеності)
• ✅ Sitemap з тегами <lastmod> — фільтрація за датою оновлення

Де знайти URL sitemap

⚙️ Як працює сервіс

IndexFast автоматично зчитує ваш sitemap.xml і відправляє URL через Google Indexing API. Ніякого скрипта встановлювати не потрібно — всі операції виконуються на серверах IndexFast.

🤖 Автоматичний розклад

IndexFast запускає індексацію автоматично — налаштовувати cron або тримати сервер не потрібно. Сервіс працює цілодобово на стороні IndexFast.

Як керувати індексацією

🖱 Ручна індексація

Крім автоматичного режиму, IndexFast дозволяє запустити індексацію вручну в будь-який момент — прямо з особистого кабінету.

📊 Ліміти API

Google безкоштовно надає ліміт у 200 URL на добу на один Service Account. IndexFast автоматично відстежує ліміт і зупиняється при його вичерпанні.

🔧 Інтеграції з платформами

WordPress

Якщо ви використовуєте Yoast SEO або Rank Math — sitemap вже готовий:

Потрібна допомога з інтеграцією? Зверніться в підтримку.

Shopify

Shopify автоматично генерує sitemap за адресою /sitemap.xml. Він включає сторінки, товари, колекції та блог-пости.

Потрібна допомога з інтеграцією? Зверніться в підтримку.

Laravel

Для генерації sitemap у Laravel рекомендуємо пакет spatie/laravel-sitemap:

composer require spatie/laravel-sitemap

use Spatie\Sitemap\SitemapGenerator;

SitemapGenerator::create('https://your-site.com')
    ->writeToFile(public_path('sitemap.xml'));

Потрібна допомога з інтеграцією? Зверніться в підтримку.

Інші платформи

Потрібна допомога з інтеграцією? Зверніться в підтримку.

📡 API Reference

Авторизація

Google Indexing API використовує OAuth 2.0 через Service Account. IndexFast обробляє авторизацію автоматично — вам потрібен лише JSON-ключ.

Endpoint для отримання токена:

POST https://oauth2.googleapis.com/token

Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
&assertion={JWT_TOKEN}

Відправка URL на індексацію

POST https://indexing.googleapis.com/v3/urlNotifications:publish

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "url": "https://your-site.com/new-page",
  "type": "URL_UPDATED"
}

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

{
  "urlNotificationMetadata": {
    "url": "https://your-site.com/new-page",
    "latestUpdate": {
      "url": "https://your-site.com/new-page",
      "type": "URL_UPDATED",
      "notifyTime": "2026-01-20T10:30:00Z"
    }
  }
}

Перевірка статусу URL

GET https://indexing.googleapis.com/v3/urlNotifications/metadata
    ?url=https://your-site.com/page

Authorization: Bearer {ACCESS_TOKEN}

Коди помилок

❓ FAQ

Скільки часу займає індексація після відправки?

Google зазвичай обробляє запити протягом 24–48 годин. В більшості випадків сторінки з'являються в пошуку вже наступного ранку після відправки.

Чи можна відправляти більше 200 URL на день?

200 URL — стандартний безкоштовний ліміт Google. При потребі можна подати заявку на збільшення ліміту через Google Cloud Console. IndexFast автоматично зупиняється при досягненні ліміту і продовжує на наступний день.

Чи безпечно для SEO використовувати Indexing API?

Так, це офіційний метод, рекомендований самим Google. Жодних ризиків пенальті чи зниження позицій — навпаки, швидша індексація покращує конкурентоздатність.

Sitemap Index чи звичайний sitemap?

IndexFast підтримує обидва типи. Якщо передати посилання на sitemap_index.xml — скрипт автоматично обійде всі вкладені файли і зберезе всі URL.

📋 Changelog

v2.4 — Червень 2026

— Інтеграція з IndexNow: автоматична відправка URL у Bing, Naver, Seznam.cz та Yep.
— Запущено партнерську програму (Affiliate Program).
— Додано інтерактивний ROI-калькулятор на головну сторінку.

v2.3 — Березень 2026

— Авторизація через Google (OAuth): вхід в один клік без паролів.
— Багатомовність: додано підтримку 8 нових мов.
— Запущено тариф Agency з підтримкою до 50 сайтів та White-label звітами.

v2.2 — Січень 2026

— Підтримка Sitemap Index (автоматичний обхід вкладених файлів будь-якої глибини).
— Публічне REST API для розробників.
— Покращене логування та відображення статусів 200/403 в реальному часі.

v2.0 — Грудень 2024

— Запуск хмарної платформи SaaS (раніше сервіс працював як локальний скрипт).
— Автоматичний добовий планувальник з керуванням лімітами.

v1.0 — Вересень 2024

— Перший запуск сервісу.
— Базова відправка URL через Google Indexing API.

💬 Підтримка

Якщо у вас є питання або виникли проблеми — ми готові допомогти: