SEO Tools: Google Analytics 4

События GA4: количество событий и пользователей по eventName. keyEventsOnly=true — оставить ТОЛЬКО ключевые события (бывшие конверсии): фильтр по измерению isKeyEvent + метрика keyEvents (и измерение, и метрика есть не во всех свойствах — если API ответит ошибкой по полю, вызови с keyEventsOnly=false).

Воронка GA4 (Data API runFunnelReport, v1alpha): сколько пользователей дошло до каждого шага и где отвалились. Шаг задаётся событием (eventName) и/или условиями по измерениям. Минимум ДВА шага. openFunnel=false (по умолчанию) — закрытая воронка: считаются только те, кто вошёл через ПЕРВЫЙ шаг; true — пользователь может войти на любом шаге. isDirectlyFollowedBy — шаг обязан идти сразу за предыдущим. breakdownDimension разбивает воронку по измерению (deviceCategory, sessionSourceMedium…); у каждого шага появляется строка-ИТОГ с меткой "(всего)" — складывать её с остальными нельзя. ВНИМАНИЕ 1: вн…

География GA4: сессии/пользователи по стране, региону или городу.

Свойства GA4, доступные авторизации (Admin API accountSummaries, с полным обходом страниц). Возвращает { propertyId, displayName, account, accountName } — propertyId нужен всем остальным инструментам (это НЕ Measurement ID G-XXXXXXX). Заодно проверка доступов.

Какие измерения и метрики доступны В ЭТОМ свойстве GA4 (Data API getMetadata), включая КАСТОМНЫЕ (customEvent:… / customUser:…). ВЫЗЫВАТЬ ПЕРЕД ga4_report, если не уверен в именах полей: их сотни (порядка 375 измерений и 119 метрик), и точные API-имена не угадываются. search — подстрока по имени/описанию; customOnly — только кастомные поля свойства. ВАЖНО: у метрики может быть blockedReasons — по такой отчёт вернёт ОДНИ НУЛИ без ошибки, а metricFilters по ней упадёт с 400. Поле type подсказывает, целое или дробное класть в metricFilters.

Карточка свойства GA4 (Admin API): таймзона отчётов, валюта, отрасль, уровень сервиса (STANDARD или 360 — от него зависят квоты и сэмплирование), дата создания и ПОТОКИ ДАННЫХ с их Measurement ID (G-XXXXXXX). ВЫЗЫВАТЬ, когда даты в отчётах не сходятся с ожидаемыми (GA4 считает сутки в таймзоне свойства, не в UTC) или когда нужно сопоставить свойство с кодом счётчика на сайте.

Realtime-отчёт GA4 (последние 30 минут, runRealtimeReport): активные пользователи с разбивкой. Периода дат у него нет; доступен ограниченный набор измерений/метрик.

Произвольный отчёт GA4 (Data API runReport): любые измерения × метрики, фильтры по измерениям и по значениям метрик, сортировка, сравнение периодов (compareStartDate/compareEndDate) и итоги (includeTotals). Если не уверен в именах полей — сначала ga4_metadata; если боишься 400 «incompatible» — ga4_check_compatibility. Имена — как в API: измерения (date, sessionSourceMedium, pagePath, country, deviceCategory, eventName…), метрики (activeUsers, newUsers, sessions, screenPageViews, engagedSessions, engagementRate, bounceRate, averageSessionDuration, eventCount, keyEvents, totalRevenue…). ВНИМАНИЕ…

Топ страниц GA4: по URL страницы (pagePath), заголовку или странице входа. groupBy=landing использует landingPagePlusQueryString (у устаревшего landingPage с 2023 обрезается query string, и цифры расходятся с отчётом «Целевая страница» в интерфейсе GA4). organicOnly=true — только органический поиск (полезно для SEO-аналитики посадочных).

Источники трафика GA4: сессии/пользователи/вовлечённость по каналу или источнику-каналу. groupBy=channel — стандартные группы каналов (Organic Search, Direct, Referral…), source_medium — «google / organic».

Уровень доступа авторизации к конкретному свойству GSC (permissionLevel).

Детали одного сайтмапа свойства GSC (статус, ошибки/предупреждения, последний обход, содержимое по типам).

URL Inspection: индекс-статус конкретного URL в Google — verdict, coverageState, indexingState, robotsTxtState, время последнего обхода, canonical (Google vs заявленный), crawledAs, ссылки-источники, а также mobile usability и rich results. URL должен быть под указанным свойством GSC. Квота — порядка 2000 вызовов в день на свойство: не дёргать массово.

Список сайтмапов свойства GSC со статусом (path, отправлен/скачан, ошибки/предупреждения, содержимое по типам). sitemapIndex — опционально: перечислить сайтмапы внутри конкретного sitemap-индекса.

Список свойств GSC, доступных авторизации (OAuth-аккаунту или сервис-аккаунту) — проверка доступа.

Search Analytics по свойству GSC (по умолчанию GSC_SITE_URL из конфига). Возвращает строки {query|page|device..., clicks, impressions, ctr, position} (ctr — доля 0..1). Даты — в часовом поясе GSC (Pacific Time, НЕ МСК); история ~16 месяцев; финальные данные отстают на ~2-3 дня (свежие — через dataState=all, тогда в ответе firstIncompleteDate — с какой даты данные ещё не финальные). Пагинация собирается автоматически до rowLimit; truncated=true — данные могли остаться (truncatedBy: limit — упёрлись в rowLimit, deadline — общий дедлайн пагинации 5 мин). page — точный URL страницы для фильтра (ме…

Динамика метрик по времени (Stat API /bytime): каждая метрика — временной ряд. group: day | week | month | hour. Возвращает { time_intervals, series: [{ …измерения, metrics }], truncated (ряды обрезаны limit), sampled }.

Список счётчиков Метрики, доступных токену — для проверки доступа и выбора METRIKA_COUNTER_ID. Запрашивает до 10 000; если счётчиков больше — truncated: true.

Технологии визитов: распределение по устройствам/ОС/браузерам. by: device | os | browser. bounceRate — процент (0–100).

География визитов: распределение по странам/регионам/городам. level: country | region | city. bounceRate — процент (0–100).

Список целей счётчика (id, name, type) — для отчётов по конверсиям (метрика ym:s:goal<ID>reaches).

Поведение на странице входа: visits, bounceRate (процент отказов, 0–100), pageDepth, avgVisitDurationSeconds + достижения целей. source=organic фильтрует органический трафик (ym:s:lastTrafficSource — атрибуция по последнему значимому источнику). goalIds — список ID целей для goalReaches (без него цели подтягиваются автоматически из счётчика, максимум 10 — излишек отбрасывается с маркером goals_truncated).

Произвольный отчёт Stat API: любые измерения × метрики Метрики. Даёт полный доступ к отчётам. dimensions/metrics — имена вида ym:s:<name> (визиты) или ym:pv:<name> (просмотры), напр. ym:s:lastTrafficSource, ym:s:deviceCategory, ym:s:regionCity; метрики ym:s:visits, ym:s:users, ym:s:bounceRate. Ключи в ответе — короткие, без неймспейса (ym:s:regionCity → regionCity); bounceRate — процент отказов (0–100). Ответ: { rows, totals, totalRows, truncated, sampled }.

Поисковые фразы (в основном Яндекс — Google шифрует) c поведением по странице входа. Возвращает { landingPage, rowCount, totalRows, truncated, sampled, rows: [{ phrase, visits, bounceRate (процент отказов, 0–100), pageDepth, avgVisitDurationSeconds }] }; truncated: true — строки обрезаны limit.

Топ страниц входа из органики за период. Возвращает { rowCount, totalRows, truncated, sampled, rows: [{ landing, visits, bounceRate (процент отказов, 0–100), pageDepth, avgVisitDurationSeconds }] }; truncated: true — строки обрезаны limit.

Источники трафика: визиты/пользователи/отказы/глубина/длительность по ym:s:lastTrafficSource (organic/direct/ad/referral/social/…). bounceRate — процент отказов (0–100).

Динамика частотности фразы: { results: [{ date, count, share }] }. ВАЖНО: операторы («!», кавычки) работают только при period=daily; monthly требует fromDate = 1-е число и toDate = последний день месяца, weekly — fromDate понедельник. Данные weekly/monthly с 2018 года, daily — последние 60 дней. Даты валидируются до запроса.

Частотность фразы в Яндексе за последние 30 дней: широкая (freq_broad) и точная (freq_exact, «"!слово !слово"») + уточняющие запросы (related, «левая колонка» Вордстата) и похожие (associations, «правая колонка», ≤20). related_truncated=true — related обрезан по relatedLimit (за ответом могли остаться строки, увеличь relatedLimit). Официальный API — бесплатный, 2 запроса к API на вызов (квота 100/час). region: «Москва»/«Россия»/id, можно несколько через запятую.

Распределение частотности фразы по регионам за 30 дней: { results: [{ region_id, region_name, count, share, affinityIndex }] }. affinityIndex > 100 — интерес выше среднего по стране. regionType: cities | regions | all. Имена регионов резолвятся из дерева (кеш). Первый вызов за сутки — 2 запроса к API (regions + дерево имён), далее 1.

Дерево всех регионов Вордстата (id + название) — для поиска id нестандартного региона.

Баланс аккаунта XMLRiver (бесплатный сервисный вызов). Заодно проверка ключей.

Проверка индексации URL в Google/Яндексе через XMLRiver (ПЛАТНО за запрос). Ищет точный URL в выдаче по нему же (inindex). Возвращает { url, engine, indexed, matchedUrl, found }. strict=true — учитывать регистр URL.

Поиск по картинкам Google через XMLRiver (ПЛАТНО: каждые ~10 результатов = 1 платный запрос, пагинация). Возвращает { position, url (страница-источник), imageUrl (сама картинка), title, source, width, height }. Гео-таргетинг: location (город → loc, «Moscow»/«1011969») и country («RU»/«2643», автовыводится из города); применённое гео эхом возвращается в поле geo. truncated: true = выдача кончилась раньше запрошенного depth.

Поиск заведений по Google Maps через XMLRiver (setab=maps, ПЛАТНО за запрос). Обязательные query + coords (широта,долгота) + zoom (1–15); count (5–50) — сколько заведений вернуть. Возвращает { places: [{ title, stars?, type?, address?, url?, phone?, review?, features? (сервисы заведения), lat, lng, place_id?, reviews_count?, accessibility?, price? }], count, found, empty? }. Пустая выдача (код 15) ТАРИФИЦИРУЕТСЯ и помечается { places: [], empty: true, note }. ВАЖНО: формат ответа — по доке XMLRiver, лайвом не подтверждён (на тестовом аккаунте эндпоинт устойчиво отвечает кодом 500 — вероятно, т…

Поиск по новостям Google через XMLRiver (ПЛАТНО: каждые ~10 результатов = 1 платный запрос, пагинация). Возвращает { position, url, title, source (издание), date (часто относительная), snippet }. Гео-таргетинг: location (город → loc, «Moscow»/«1011969») и country («RU»/«2643», автовыводится из города); применённое гео эхом возвращается в поле geo. truncated: true = выдача кончилась раньше запрошенного depth. period — фильтр по времени (tbs).

Блок «Вопросы по теме» (People Also Ask) Google через XMLRiver (setab=rq, ПЛАТНО за запрос). Возвращает { questions: [{ question, title?, snippet?, url? }], count, answers_available, empty?, note? }. ВАЖНО: title/snippet/url (ответы на вопросы) заполняются только при включённой платной опции «Related Questions с ответами» в кабинете XMLRiver (настройки сбора); иначе они пустые (answers_available: false + note), сами вопросы доступны всегда. Отсутствие PAA-блока по запросу (код 15) ТАРИФИЦИРУЕТСЯ и помечается { questions: [], empty: true, note }.

Слепок органической выдачи Google/Yandex через XMLRiver (ПЛАТНО: каждые 10 результатов = 1 платный запрос, depth добирается пагинацией). Возвращает { found, truncated (true = выдача кончилась раньше depth), ai_overview: { present } — флаг присутствия AI Overview у Google; при includeAIOverview=true — { present, available, text?, links? } (полный текст AIO и цитируемые ссылки, ПЛАТНО — ai=1), results: [{ position, url, title, snippet, text_bolds }], serp_features: { sitelinks_top1, packs } }. includeAdditional (только Google) — доп. SERP-блоки из <addresults> в поле additional: knowledge_graph,…

Поисковые подсказки Google через XMLRiver (setab=tips). ПЛАТНО за КАЖДУЮ фразу: N фраз = N списаний, до 50 фраз за вызов. Возвращает { phrases: string[] — плоский список в порядке входных фраз (~10 подсказок на фразу), byPhrase: Record<фраза, string[]> — группировка по входным фразам, если подсказок поровну на фразу (иначе null + note), count, charged (число тарифицированных фраз) }. Гео подсказок: location (город → loc, «Moscow»/«1011969») и country («RU»/«2643») — применённое гео эхом возвращается в поле geo.

Баланс и дневной расход аккаунта XMLStock (бесплатный сервисный вызов). Заодно проверка ключей.

Поиск по картинкам Google через XMLStock (ПЛАТНО за запрос). Возвращает { position, url (страница-источник), imageUrl (сама картинка), title }. truncated: true = выдача кончилась раньше запрошенного depth.

Поиск по новостям Google через XMLStock (ПЛАТНО за запрос). Возвращает { position, url, title, source (издание), date (часто относительная), snippet }. truncated: true = выдача кончилась раньше запрошенного depth.

Слепок выдачи Google/Yandex через XMLStock (ПЛАТНО за запрос). Возвращает { found, truncated (true = выдача кончилась раньше запрошенного depth), count, results: [{ position, url, title, snippet, text_bolds (подсветки hlword) }], serp_features: { featured_snippet, paa (только Google), related, sitelinks_top1, packs } }. Пустая выдача (код 15) ТАРИФИЦИРУЕТСЯ и помечается { results: [], empty: true, note }. depth>10 добирается пагинацией (каждая страница — отдельный платный запрос; у yandex_xml — до 100/страница). region: ОДИН регион (название или числовой id Яндекса) — работает для ВСЕХ движков…

Поиск по видео Google через XMLStock (ПЛАТНО за запрос). Возвращает { position, url, title, thumbnail, host (YouTube...), channel, duration, snippet }. truncated: true = выдача кончилась раньше запрошенного depth.

Частотность и топ запросов Яндекс Wordstat через XMLStock (ПЛАТНО за запрос, ~19₽/1K). Возвращает { totalCount, results: [{ phrase, count }] (топ по фразе), associations: [{ phrase, count }] (похожие) }. Операторы Wordstat в query: "…" (точная), ! (форма слова), + (стоп-слово), - (минус), [ ] (порядок), | (или).

Динамика частотности фразы по времени (Яндекс Wordstat через XMLStock, ПЛАТНО за запрос). period: day/week/month. from/to — YYYY-MM-DD (для month период автоматически растягивается на целые месяцы). Возвращает [{ date, count, share }].

Распределение спроса по регионам для фразы (Яндекс Wordstat через XMLStock, ПЛАТНО — дороже топа/динамики). Возвращает [{ regionId, name, count, share, affinityIndex }]; имена регионов подставляются из дерева (кэш 24ч). ВНИМАНИЕ: при холодном кэше дерева (первый вызов за 24ч) делается дополнительный ПЛАТНЫЙ запрос regionsTree.

Дерево регионов Яндекс Wordstat через XMLStock (id + имя + путь) — id для параметра region в других запросах. ПЛАТНО за запрос.

Битые ссылки, выборка: внутренние (scope=internal) или внешние (external). { count, links: [{ source_url, destination_url, ... }] }. truncated=true — за выборкой есть ещё строки (добирай offset).

Диагностика сайта Вебмастером — список проблем: { problems: [{ ... severity, state, ... }] }.

Внешние ссылки на сайт (беклинки), выборка: { count (всего), links: [{ source_url, destination_url, discovery_date, source_last_access_date }] }. truncated=true — за выборкой есть ещё строки (добирай offset).

user_id токена и список сайтов в Вебмастере — для проверки доступа и настройки YWM_HOST_ID. Ответ: { user_id, hosts: [{ host_id, verified, ... }] } — host_id подставлять в параметр hostId других инструментов.

Мониторинг важных URL: { urls: [{ url, update_date, change_indicators, indexing_status, search_status }] } — статус индексации и изменения важных страниц.

Динамика числа страниц В ПОИСКЕ по датам (search-urls/in-search): { history: [{ date, value }] }. Окно по умолчанию — 30 дней.

Топ-запросы хоста за неделю (search-queries/popular, до 3000): { rows: [{ query, shows, clicks, avg_show_position, avg_click_position }] }. Фильтра по URL здесь нет. truncated=true — набран ровно limit: за ним могли остаться строки (увеличь limit).

История суммарной статистики запросов по хосту по датам (показы/клики/позиции): { indicators: {...} }. indicator: TOTAL_SHOWS | TOTAL_CLICKS | AVG_SHOW_POSITION | AVG_CLICK_POSITION. Окно по умолчанию — 30 дней.

Недобранные запросы по URL (аппроксимация: в API v4 нет «рекомендованных»). Берём запросы ТРЁХ категорий: показы без кликов, позиция за топ-10, любой запрос со спросом (DEMAND > 0) — категория указана в поле reason. Ответ: { queries: [{ query, demand, shows, clicks, position, reason }] }. truncated=true — запросов больше внутреннего капа (3000): фильтр применён к первым 3000 строкам выборки API.

Запросы Яндекса по конкретному URL (query-analytics, данные за ~2 недели по умолчанию — переопределяется dateFrom/dateTo): { rows: [{ query, shows, clicks, ctr, position, demand }] }. url — путь («/oae/dubai/») или полный URL; сопоставление TEXT_CONTAINS по умолчанию. Без url — топ запросов всего хоста. truncated=true — запросов больше внутреннего капа (3000): топ отсортирован по первым 3000 строкам выборки API.

Файлы Sitemap хоста со статусом: { sitemaps: [{ sitemap_id, sitemap_url, last_access_date, errors_count, urls_count, children_count, sources, sitemap_type }] }.

История ИКС (индекс качества сайта) по датам: { points: [{ date, value }] }. Окно по умолчанию — 180 дней.

Сводка по хосту. Ответ: { sqi (ИКС), searchable_pages_count (страниц в поиске), excluded_pages_count (исключено), site_problems (число проблем сайта по важности) }.