Перейти до основного вмісту
Google SERP (Search Engine Results Page) — це сторінка результатів, яку користувачі бачать після введення запиту в пошуковій системі Google. Вона відображає органічні результати пошуку, рекламу, рекомендовані фрагменти, граф знань, а також зображення, відео та інші типи контенту, прагнучи надати користувачам найбільш релевантну інформацію. У цій статті буде докладно представлено Google SERP API, який може надавати результати за запитами, введеними в пошуковій системі Google; вміст результатів також включає багато типів, наприклад рекомендовані фрагменти, граф знань і зображення та інші результати. У цьому документі буде представлено інструкцію з інтеграції Google SERP API.

Процес подання заявки

Щоб використовувати Google SERP API, спочатку отримайте ваш API Token у консолі Ace Data Cloud і збережіть його для подальшого використання. Якщо ви ще не ввійшли або не зареєструвалися, вас буде автоматично перенаправлено на сторінку входу із запрошенням зареєструватися та ввійти, після завершення ви автоматично повернетеся на поточну сторінку. Один API Token може викликати всі сервіси платформи, не потрібно подавати заявку окремо для кожного сервісу. Після першого подання заявки буде надано безкоштовний ліміт, який можна безкоштовно випробувати; коли ліміту недостатньо, ви можете поповнити універсальний баланс у консолі.
📘 Повна документація: Google SERP API →

Базове використання

Введіть ключове слово та тип ресурсу пошуку, щоб отримати результати: використовуйте query для передавання ключового слова, а type — для вибору типу пошуку, як-от вебсторінки, зображення, новини тощо; цьому інтерфейсу не потрібно передавати model. Наприклад, щоб знайти: інформацію про «apple inc», далі ми можемо заповнити відповідний вміст в інтерфейсі, як показано на зображенні:

Тут можна побачити, що ми налаштували Request Headers, зокрема:
  • accept: який формат результату відповіді ви хочете отримати, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подання заявки його можна безпосередньо вибрати зі спадного списку.
Також налаштовано Request Body, зокрема:
  • type: тип пошукового ресурсу, наразі підтримується лише шість типів, за замовчуванням — search.
  • query: ключове слово для пошуку.
  • country: країна, у якій відображатимуться користувацькі результати пошуку, за замовчуванням — США (US).
  • language: мова користувацьких результатів пошуку, за замовчуванням — англійська (en).
  • range: часовий діапазон користувацьких результатів пошуку, за замовчуванням — без обмежень.
  • number: розмір сторінки пагінації користувацьких результатів пошуку, за замовчуванням — 10.
  • page: номер сторінки пагінації користувацьких результатів пошуку, за замовчуванням — 1.
Після вибору можна побачити, що праворуч також згенеровано відповідний код, як показано на зображенні:

Натисніть кнопку «Try», щоб виконати тестування; як показано на зображенні вище, тут ми отримали такі результати:
Повернений результат містить кілька полів, опис яких наведено нижче:
  • knowledge_graph — граф знань результатів пошуку.
  • organic — детальна інформація про результати пошуку.
  • people_also_ask — питання, пов’язані з ключовими словами пошуку.
  • related_searches — пов’язані пошуки за ключовими словами пошуку.
Як видно, у поверненому результаті є поле organic, яке переважно містить результати за ключовими словами пошуку. Крім того, якщо потрібно згенерувати відповідний код інтеграції, його можна безпосередньо скопіювати й згенерувати, наприклад, код CURL наведено нижче:
Код інтеграції для Python наведено нижче:

Налаштування типу пошуку

Якщо ви налаштовуєте тип пошукових ресурсів, ми можемо змінити параметр type, який відповідно містить звичайні ресурси search, ресурси зображень images, ресурси новин news, ресурси карт maps, регіональні ресурси places і відеоресурси videos; у цій статті буде наведено демонстрацію на прикладі відеоресурсів videos. Нижче ми продемонструємо конкретні кроки. Спочатку встановіть для параметра type значення videos і звичайним чином передайте параметр query, як показано на рисунку:

Відповідний код наведено нижче:
Можна отримати таку відповідь:
Результат, що повертається, містить кілька полів, описаних нижче:
  • news — список відеоінформації в результатах пошуку.
Можна побачити, що серед результатів, повернутих тут, є поле videos, яке переважно містить результати за ключовими словами пошуку.

Налаштування країни, у якій розташовані ресурси пошуку

Цей API також підтримує обмеження країни, у якій розташовані результати пошуку. Ми можемо додати параметр country, щоб обмежити країну; введений параметр є скороченням країни, наприклад cn (China), us (United States). У цій статті буде наведено такий приклад із China. Нижче наведено детальну інформацію:

Ефект виводу наведено нижче:
Можна побачити, що в результатах наведено результати пошуку в країні China, конкретний вміст подібний до наведеного вище.

Налаштування мови результатів пошуку

Ми також можемо налаштувати мову результатів пошуку, тут ми додатково додаємо поле language зі значенням zh-cn, де воно означає мову спрощеної китайської, також підтримуються інші мови, але потрібно вводити скорочення мови, наприклад en(English)、fr(French)、zh-cn(Chinese(Simplified))та інші мови, як показано на зображенні:

Відповідний код наведено нижче:
Результат виконання наведено нижче:
Можна побачити, що результати, показані тут, усі подано спрощеною китайською мовою, а вміст результатів схожий на наведений вище.

Налаштування часового діапазону результатів пошуку

У цій статті також можна налаштувати часовий діапазон результатів пошуку, включно з п’ятьма варіантами: qdr:h (за минулу годину), qdr:d (за минулий день), qdr:w (за минулий тиждень), qdr:m (за минулий місяць), за замовчуванням без обмежень. Ми можемо передати відповідний часовий діапазон через range, наприклад, тут установлено qdr:d, що означає пошук результатів за минулий день, тому введення має такий вигляд:

Відповідний код такий:
Результат виконання такий:
Як можна побачити, ми успішно отримали результати пошуку за минулий день, а вміст результатів подібний до наведеного вище.

Налаштування пагінації результатів пошуку

Цей API також підтримує налаштування посторінкового відображення результатів пошуку; number і page позначають розмір сторінки та номер сторінки для пагінації. У цій статті буде налаштовано пагінацію з 20 результатами пошуку на одній сторінці; конкретну інформацію показано на зображенні:

Примітка: коли кількість результатів на сторінці перевищує 10, списані бали подвоюються.
Код такий:
Результат виконання такий:
Можна побачити, що тут він відображає результати пошуку з пагінацією, на одній сторінці показано 20 результатів, а вміст результатів подібний до наведеного вище.