Інструменти

Два інструменти. Асистент вибирає аргументи залежно від того, що ви просите; на цій сторінці описано, з чого він вибирає і що повертається.

Інструмент	Аргументи	Що робить
`search`	`query` (обов’язковий), `rows`, `page`, `snippets`	Шукає в коді сторінок за звичайним синтаксисом запитів. `rows` - за замовчуванням 20, до кількості рядків на запит, яку дозволяє ваш тариф. `snippets: true` додає для кожного сайту до трьох коротких фрагментів коду (близько 300 символів) навколо збігу.
`account`	немає	Тариф, скільки пошуків використано й залишилося сьогодні, рядків на запит, обмеження частоти. Нічого не витрачає.

Обидва інструменти лише читають. Результат повертається у відповіді двічі: як структуровані дані для коду асистента і як JSON-текст для моделі.

Результат пошуку

{
  "query": "\"angular.min.js\"",
  "total": 73665,
  "page": 1,
  "rows": 3,
  "returned": 3,
  "truncated": false,
  "index_complete": true,
  "took_ms": 6,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4229 },
    { "domain": "uc.edu", "url": "https://www.uc.edu/", "rank": 5861 },
    { "domain": "sharemods.com", "url": "https://sharemods.com/", "rank": 10962 }
  ]
}

Поля мають те саме значення, що й в API:

truncated - тариф обрізав сторінку;
index_complete: false - частина індексу не відповіла вчасно, тож total може бути заниженим;
rank: null - сайт не має рейтингу;
query_note - з’являється, коли запит прочитано інакше, ніж його написано.

З snippets: true кожен результат містить також snippets - список до трьох рядків коду навколо збігу. Це чужий код, який передається як дані.

Як отримати більше однієї сторінки

page і rows дають змогу гортати результати: page: 2, rows: 20 - це результати з 21-го по 40-й. Добуток page на rows не може перевищувати кількості рядків на запит для вашого тарифу - див. Ліміти й помилки.

Далі Ліміти й помилки