jsonseo 1.0.0

package/dist/cjs/responses.d.ts

@@ -0,0 +1,352 @@
+/** Органический результат выдачи. */
+export interface SearchResult {
+    /** Адрес страницы в выдаче. */
+    url: string;
+    /** Домен страницы. */
+    domain: string;
+    /** Заголовок результата. */
+    title: string;
+    /** Текст сниппета. */
+    passage: string;
+    /** Хлебные крошки результата. */
+    breadcrumbs?: string;
+    /** Тип документа: pdf, doc, xls. Отсутствует у обычных страниц. */
+    mime?: string;
+    /** Тот же тип полностью: application/pdf. */
+    mime_type?: string;
+}
+/** Источник, на который опирается ответ нейросети. */
+export interface AiAnswerSource {
+    /** Номер источника: им подписаны сноски у Яндекса и Bing. */
+    id: number;
+    url: string;
+    domain: string;
+    /** У Google обрезан многоточием — так его показывает сам Google. */
+    title?: string;
+    /** Только Яндекс. */
+    description?: string;
+    /** Сколько сносок ведёт на источник. Только Яндекс и Bing. */
+    citations?: number;
+}
+/**
+ * Блок нейросети над выдачей: Алиса AI, AI Overview, Copilot. Приходит
+ * только при `ai: 1` и только если поисковик его показал.
+ */
+export interface AiAnswer {
+    /** Текст ответа; у Яндекса и Bing сноски — markdown-ссылки. */
+    markdown: string;
+    /** Источники. У Google список не отдаётся, если он пуст. */
+    sources?: AiAnswerSource[];
+    /** Только Яндекс: уточняющие вопросы под ответом. */
+    followUps?: string[];
+}
+/** Быстрая ссылка под текстом объявления. */
+export interface AdSitelink {
+    /** Подпись ссылки. */
+    title: string;
+    /** Адрес, очищенный от кликовых меток. Приходит не всегда. */
+    url?: string;
+    /** Пояснение под ссылкой. Показывает только Яндекс. */
+    description?: string;
+}
+/** Рекламное объявление со страницы выдачи. */
+export interface Ad {
+    /** Где стоял блок относительно органики. */
+    block: 'top' | 'bottom' | 'inline';
+    /** Место среди объявлений своего блока, с единицы. */
+    position: number;
+    /** Страница выдачи, на которой объявление нашлось. Нумерация с нуля, абсолютная. */
+    page: number;
+    /** Домен рекламодателя. */
+    domain: string;
+    /** Посадочная страница без меток. Нет, если адрес не вычислен. */
+    url?: string;
+    /** Адрес в том виде, в каком его показывают человеку. */
+    displayUrl?: string;
+    /** Заголовок объявления. */
+    title?: string;
+    /** Текст объявления. */
+    description?: string;
+    /** Чем поисковик пометил объявление: «Реклама», Sponsored, ArrowTop. */
+    label?: string;
+    /** Как объявление свёрстано. Только Яндекс. */
+    format?: 'text' | 'gallery';
+    /** Номер карусели, только у `format: 'gallery'`. Только Яндекс. */
+    group?: number;
+    /** Быстрые ссылки. */
+    sitelinks?: AdSitelink[];
+}
+/** Ответ органической выдачи — общий для Яндекса, Google и Bing. */
+export interface SearchResponse {
+    /** Сколько страниц получено — ровно за них и списано. */
+    pages: number;
+    /** Выдача закончилась, повторять с большим `pages` незачем. */
+    exhausted: boolean;
+    /** Поиск остановлен доменом из `break_domain`. */
+    breakDomainHit: boolean;
+    /** Запрос после исправления поисковиком. */
+    query: string;
+    /** Запрос, как его отправил клиент. */
+    rawQuery: string;
+    /** Подпись региона выдачи, если поисковик её отдал. */
+    region?: string;
+    /** Только Google: почему часть результатов скрыта. */
+    filter_description?: string;
+    /** Только Яндекс: сколько нашлось, округлённо самим поисковиком. */
+    found?: number | null;
+    /** Только Яндекс: та же величина словами. */
+    found_human?: string;
+    /** Только Bing: фактический рынок выдачи. */
+    mkt?: string;
+    /** Только Bing: фактический язык интерфейса выдачи. */
+    lang?: string;
+    /** Только Яндекс: регион, в котором фактически выполнен поиск. */
+    lr?: number;
+    /** Адрес страницы выдачи в поисковике. */
+    url?: string;
+    results: SearchResult[];
+    /** Только при `ai: 1` и только если поисковик ответ показал. */
+    aiAnswer?: AiAnswer;
+    /** Только при `ads: 1`. Пустой массив — просили, но рекламы не было. */
+    ads?: Ad[];
+}
+/** Карточка картинки: первые четыре поля есть всегда. */
+export interface ImageResult {
+    /** Адрес самого файла картинки у первоисточника. */
+    url: string;
+    /** Заголовок карточки — обычно заголовок страницы-источника. */
+    title: string;
+    /** Домен страницы-источника, а не CDN картинки. */
+    domain: string;
+    /** Страница, на которой картинка стоит. */
+    sourceUrl: string;
+    /** Превью поисковика; у Google первые карточки приходят как data:. */
+    thumbnail?: string;
+    /** Ширина оригинала. Нет, если размер не назван. */
+    width?: number;
+    /** Высота оригинала. */
+    height?: number;
+    /** Ширина превью. Только Яндекс. */
+    thumbnailWidth?: number;
+    /** Высота превью. Только Яндекс. */
+    thumbnailHeight?: number;
+    /** Вес оригинала в байтах. Только Яндекс. */
+    bytes?: number;
+}
+/** Ответ поиска по картинкам — общий для всех трёх поисковиков. */
+export interface ImagesResponse {
+    /** Сколько страниц получено. */
+    pages: number;
+    /** Выдача закончилась. */
+    exhausted: boolean;
+    query: string;
+    /** Адрес страницы выдачи в поисковике. */
+    url?: string;
+    results: ImageResult[];
+    /** Только при `ads: 1` и только у картинок Яндекса. */
+    ads?: Ad[];
+}
+/** Карточка видео. url, title и domain есть всегда. */
+export interface VideoResult {
+    /** Страница с роликом у первоисточника. */
+    url: string;
+    title: string;
+    domain: string;
+    /** Кадр-заставка на CDN поисковика. */
+    thumbnail?: string;
+    /** Длительность в секундах. Нет поля — длина неизвестна, а не ноль. */
+    duration?: number;
+    /** Длительность подписью поисковика: 31:18, 1:02:44. */
+    durationText?: string;
+    /** Дата публикации в unix-секундах. Только Яндекс. */
+    published?: number;
+    /** Дата публикации словами поисковика, на языке выдачи. */
+    publishedText?: string;
+    /** Просмотры подписью: 6,8K. Точного значения за ними нет. */
+    views?: string;
+    /** Площадка: YouTube, VK Видео. */
+    provider?: string;
+    /** Канал или автор внутри площадки. Только Bing. */
+    channel?: string;
+    /** Текст сниппета. Только Яндекс. */
+    description?: string;
+    /** Путь под заголовком. Только Google. */
+    breadcrumbs?: string;
+}
+/** Ответ поиска по видео — общий для всех трёх поисковиков. */
+export interface VideoResponse {
+    pages: number;
+    exhausted: boolean;
+    query: string;
+    url?: string;
+    results: VideoResult[];
+}
+/** Ответ поисковых подсказок. */
+export interface SuggestResponse {
+    query: string;
+    results: string[];
+    /** Только Яндекс: регион, в котором собраны подсказки. */
+    lr?: string;
+}
+/** Регион Яндекса из справочника. */
+export interface YandexRegion {
+    id: number;
+    name: string;
+    /** Что это за регион: область, республика, страна. */
+    subname: string;
+    lat: number;
+    lon: number;
+}
+/** Ответ справочника регионов Яндекса. */
+export interface YandexRegionsResponse {
+    name: string;
+    lang: string;
+    regions: YandexRegion[];
+}
+/** Регион Google из справочника: вместе с ID приходит готовый uule. */
+export interface GoogleRegion {
+    id: number;
+    name: string;
+    subname: string;
+    type: string;
+    type_name: string;
+    canonical_name: string;
+    /** Готовая строка UULE для параметра `uule`. */
+    uule: string;
+    lat: number;
+    lon: number;
+}
+/** Ответ справочника регионов Google. */
+export interface GoogleRegionsResponse {
+    name: string;
+    lang: string;
+    regions: GoogleRegion[];
+}
+/** Строка списка запросов Вордстата. */
+export interface WordstatPhrase {
+    text: string;
+    value: number;
+}
+/** Ответ со списками популярных и похожих запросов. */
+export interface WordstatResponse {
+    text: string;
+    region: string;
+    device: string;
+    results: {
+        /** Что ищут вместе с этой фразой. */
+        popular: WordstatPhrase[];
+        /** Соседняя семантика. */
+        associations: WordstatPhrase[];
+    };
+}
+/** Ответ с частотой запроса. */
+export interface WordstatFrequencyResponse {
+    text: string;
+    region: string;
+    device: string;
+    results: {
+        /** Частота запроса одним числом. */
+        totalValue: number;
+    };
+}
+/** Точка динамики показов. */
+export interface WordstatGraphPoint {
+    /** Дата начала периода. */
+    date: string;
+    /** Подпись периода словами: «июнь 2026». */
+    text: string;
+    /** Показы за период. */
+    absolute: number;
+    /** Доля среди всех показов Яндекса. */
+    relative: number;
+}
+/** Ответ с динамикой запроса. */
+export interface WordstatGraphResponse {
+    text: string;
+    region: string;
+    device: string;
+    /** Шаг динамики, который применился. */
+    type: string;
+    results: {
+        graph: WordstatGraphPoint[];
+    };
+}
+/** Строка географии показов. */
+export interface WordstatMapRow {
+    /** Разрез строки: regions или cities. */
+    type: string;
+    /** Название региона или города. */
+    text: string;
+    /** Показы. */
+    absolute: number;
+    /** Affinity-индекс: 100 — средний интерес, выше — повышенный. */
+    popularity: number;
+    /** Доля среди всех показов Яндекса. */
+    relative: number;
+    /** ID региона для `region`; null, если название неоднозначно. */
+    region_id: number | null;
+}
+/** Ответ с географией запроса. */
+export interface WordstatMapResponse {
+    text: string;
+    device: string;
+    type: string;
+    results: {
+        rows: WordstatMapRow[];
+    };
+}
+/** Прогноз по одному месту аукциона. */
+export interface DirectPosition {
+    /** Ставка. */
+    bid: number;
+    /** Бюджет за период. */
+    budget: number;
+    /** Прогноз кликов. */
+    clicks: number;
+    /** Прогноз CTR в процентах. */
+    ctr: number;
+    /** Прогноз показов. */
+    shows: number;
+}
+/** Прогноз по одной фразе. */
+export interface DirectForecast {
+    phrase: string;
+    /** Сколько раз объявление будет показано за период. */
+    shows: number;
+    /** Места аукциона: набор задаёт сам Директ. */
+    positions: Record<string, DirectPosition>;
+}
+/** Ответ прогноза показов Яндекс Директа. */
+export interface DirectResponse {
+    /** Регион, по которому считался прогноз. */
+    geo: number;
+    period: string;
+    /** На сколько пачек разбит список — по ним считается стоимость. */
+    batches: number;
+    /** Сколько пачек посчитано. */
+    processed: number;
+    results: DirectForecast[];
+    /** Ошибки Директа по отдельным фразам. */
+    errors: string[];
+}
+/** Ответ геолокации по IP. */
+export interface GeoipResponse {
+    ip: string;
+    latitude: number;
+    longitude: number;
+    /** ID тот же, что у Яндекса: годится для `region`. */
+    region: {
+        id: number;
+        name: string;
+    };
+    country: {
+        id: number;
+        name: string;
+        iso_name: string;
+    };
+}
+/** Ответ с остатком на счёте. */
+export interface BalanceResponse {
+    balance: number;
+    currency: string;
+}

package/dist/cjs/responses.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/client.d.ts

@@ -0,0 +1,71 @@
+import type { ParamValue } from './common.js';
+import { type ClientOptions, type RequestOptions } from './http.js';
+import type { BingImagesParams, BingSearchParams, BingSuggestParams, BingVideoParams, DirectParams, GeoipParams, GoogleImagesParams, GoogleSearchParams, GoogleSuggestParams, GoogleVideoParams, RegionsParams, WordstatGraphParams, WordstatMapParams, WordstatParams, YandexImagesParams, YandexSearchParams, YandexSuggestParams, YandexVideoParams } from './params.js';
+import type { BalanceResponse, DirectResponse, GeoipResponse, GoogleRegionsResponse, ImagesResponse, SearchResponse, SuggestResponse, VideoResponse, WordstatFrequencyResponse, WordstatGraphResponse, WordstatMapResponse, WordstatResponse, YandexRegionsResponse } from './responses.js';
+/**
+ * Клиент JSON SEO API.
+ *
+ * ```ts
+ * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
+ * ```
+ */
+export declare class JsonSeoClient {
+    private readonly http;
+    constructor(apiKey: string, options?: Omit<ClientOptions, 'apiKey'>);
+    constructor(options: ClientOptions);
+    /** Органическая выдача Яндекса: мобильная, регион 213. 0.01 ₽ за страницу. */
+    yandex(params: string | YandexSearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /** Подсказки Яндекса: до 50 фраз с учётом региона. 0.01 ₽ за запрос. */
+    yandexSuggest(params: string | YandexSuggestParams, options?: RequestOptions): Promise<SuggestResponse>;
+    /** Код региона (lr) по названию города или области. Бесплатно, нужен ключ. */
+    yandexRegions(params: string | RegionsParams, options?: RequestOptions): Promise<YandexRegionsResponse>;
+    /** Картинки Яндекса: 20 карточек на страницу, 0.01 ₽ за страницу. */
+    yandexImages(params: string | YandexImagesParams, options?: RequestOptions): Promise<ImagesResponse>;
+    /** Видео Яндекса: 20 карточек на страницу, 0.01 ₽ за страницу. */
+    yandexVideo(params: string | YandexVideoParams, options?: RequestOptions): Promise<VideoResponse>;
+    /** Органическая выдача google.com: мобильная, 0.01 ₽ за страницу. */
+    google(params: string | GoogleSearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /** Подсказки Google: до ~15 фраз. 0.01 ₽ за запрос. */
+    googleSuggest(params: string | GoogleSuggestParams, options?: RequestOptions): Promise<SuggestResponse>;
+    /** ID региона Google по названию и готовый `uule`. Бесплатно, нужен ключ. */
+    googleRegions(params: string | RegionsParams, options?: RequestOptions): Promise<GoogleRegionsResponse>;
+    /** Картинки Google: 100 карточек на страницу, 0.01 ₽ за страницу. */
+    googleImages(params: string | GoogleImagesParams, options?: RequestOptions): Promise<ImagesResponse>;
+    /** Видео Google: 10 карточек на страницу, 0.01 ₽ за страницу. */
+    googleVideo(params: string | GoogleVideoParams, options?: RequestOptions): Promise<VideoResponse>;
+    /** Органическая выдача bing.com: без локации — Россия, 0.01 ₽ за страницу. */
+    bing(params: string | BingSearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /** Подсказки Bing. 0.01 ₽ за запрос. */
+    bingSuggest(params: string | BingSuggestParams, options?: RequestOptions): Promise<SuggestResponse>;
+    /** Картинки Bing: `count` карточек (по умолчанию 35), дальше 700-й не листает. */
+    bingImages(params: string | BingImagesParams, options?: RequestOptions): Promise<ImagesResponse>;
+    /** Видео Bing: `count` карточек на страницу, по умолчанию 105. */
+    bingVideo(params: string | BingVideoParams, options?: RequestOptions): Promise<VideoResponse>;
+    /** Популярные и похожие запросы. 0.01 ₽ за запрос. */
+    wordstat(params: string | WordstatParams, options?: RequestOptions): Promise<WordstatResponse>;
+    /** Частота запроса одним числом — `results.totalValue`. 0.01 ₽ за запрос. */
+    wordstatFrequency(params: string | WordstatParams, options?: RequestOptions): Promise<WordstatFrequencyResponse>;
+    /** Динамика показов по месяцам, неделям или дням. 0.01 ₽ за запрос. */
+    wordstatGraph(params: string | WordstatGraphParams, options?: RequestOptions): Promise<WordstatGraphResponse>;
+    /**
+     * Показы по регионам и городам. `popularity` — affinity-индекс: 100 —
+     * средний интерес. 0.01 ₽ за запрос.
+     */
+    wordstatMap(params: string | WordstatMapParams, options?: RequestOptions): Promise<WordstatMapResponse>;
+    /**
+     * Прогноз показов Директа со ставками и бюджетом. Кабинет не нужен.
+     *
+     * 0.01 ₽ за пачку до 4000 символов (около 150 фраз). До 1000 фраз за
+     * запрос, 100 запросов в час.
+     */
+    direct(params: string | ReadonlyArray<string> | DirectParams, options?: RequestOptions): Promise<DirectResponse>;
+    /** Страна, регион и координаты по IPv4. Бесплатно, нужен ключ. */
+    geoip(params: string | GeoipParams, options?: RequestOptions): Promise<GeoipResponse>;
+    /** Текущий баланс. Бесплатно, нужен ключ. */
+    balance(options?: RequestOptions): Promise<BalanceResponse>;
+    /** Произвольный метод API — если в сервисе появился новый. */
+    call<T = unknown>(path: string, params?: Record<string, ParamValue>, options?: RequestOptions): Promise<T>;
+    /** То же, но ответ возвращается строкой без разбора. */
+    callRaw(path: string, params?: Record<string, ParamValue>, options?: RequestOptions): Promise<string>;
+}

package/dist/esm/client.js

@@ -0,0 +1,131 @@
+import { InvalidArgumentError } from './errors.js';
+import { HttpClient } from './http.js';
+/**
+ * Клиент JSON SEO API.
+ *
+ * ```ts
+ * const client = new JsonSeoClient('ВАШ_КЛЮЧ');
+ * const serp = await client.yandex({ text: 'купить ноутбук', region: 213 });
+ * ```
+ */
+export class JsonSeoClient {
+    constructor(first, second = {}) {
+        this.http = new HttpClient(typeof first === 'string' ? { ...second, apiKey: first } : first);
+    }
+    // Яндекс
+    /** Органическая выдача Яндекса: мобильная, регион 213. 0.01 ₽ за страницу. */
+    async yandex(params, options) {
+        return this.http.json('yandex', primary(params, 'text'), options);
+    }
+    /** Подсказки Яндекса: до 50 фраз с учётом региона. 0.01 ₽ за запрос. */
+    async yandexSuggest(params, options) {
+        return this.http.json('yandex/suggest', primary(params, 'text'), options);
+    }
+    /** Код региона (lr) по названию города или области. Бесплатно, нужен ключ. */
+    async yandexRegions(params, options) {
+        return this.http.json('yandex/regions', primary(params, 'name'), options);
+    }
+    /** Картинки Яндекса: 20 карточек на страницу, 0.01 ₽ за страницу. */
+    async yandexImages(params, options) {
+        return this.http.json('yandex/images', primary(params, 'q'), options);
+    }
+    /** Видео Яндекса: 20 карточек на страницу, 0.01 ₽ за страницу. */
+    async yandexVideo(params, options) {
+        return this.http.json('yandex/video', primary(params, 'q'), options);
+    }
+    // Google
+    /** Органическая выдача google.com: мобильная, 0.01 ₽ за страницу. */
+    async google(params, options) {
+        return this.http.json('google', primary(params, 'q'), options);
+    }
+    /** Подсказки Google: до ~15 фраз. 0.01 ₽ за запрос. */
+    async googleSuggest(params, options) {
+        return this.http.json('google/suggest', primary(params, 'q'), options);
+    }
+    /** ID региона Google по названию и готовый `uule`. Бесплатно, нужен ключ. */
+    async googleRegions(params, options) {
+        return this.http.json('google/regions', primary(params, 'name'), options);
+    }
+    /** Картинки Google: 100 карточек на страницу, 0.01 ₽ за страницу. */
+    async googleImages(params, options) {
+        return this.http.json('google/images', primary(params, 'q'), options);
+    }
+    /** Видео Google: 10 карточек на страницу, 0.01 ₽ за страницу. */
+    async googleVideo(params, options) {
+        return this.http.json('google/video', primary(params, 'q'), options);
+    }
+    // Bing
+    /** Органическая выдача bing.com: без локации — Россия, 0.01 ₽ за страницу. */
+    async bing(params, options) {
+        return this.http.json('bing', primary(params, 'q'), options);
+    }
+    /** Подсказки Bing. 0.01 ₽ за запрос. */
+    async bingSuggest(params, options) {
+        return this.http.json('bing/suggest', primary(params, 'q'), options);
+    }
+    /** Картинки Bing: `count` карточек (по умолчанию 35), дальше 700-й не листает. */
+    async bingImages(params, options) {
+        return this.http.json('bing/images', primary(params, 'q'), options);
+    }
+    /** Видео Bing: `count` карточек на страницу, по умолчанию 105. */
+    async bingVideo(params, options) {
+        return this.http.json('bing/video', primary(params, 'q'), options);
+    }
+    // Вордстат
+    /** Популярные и похожие запросы. 0.01 ₽ за запрос. */
+    async wordstat(params, options) {
+        return this.http.json('wordstat', primary(params, 'text'), options);
+    }
+    /** Частота запроса одним числом — `results.totalValue`. 0.01 ₽ за запрос. */
+    async wordstatFrequency(params, options) {
+        return this.http.json('wordstat/frequency', primary(params, 'text'), options);
+    }
+    /** Динамика показов по месяцам, неделям или дням. 0.01 ₽ за запрос. */
+    async wordstatGraph(params, options) {
+        return this.http.json('wordstat/graph', primary(params, 'text'), options);
+    }
+    /**
+     * Показы по регионам и городам. `popularity` — affinity-индекс: 100 —
+     * средний интерес. 0.01 ₽ за запрос.
+     */
+    async wordstatMap(params, options) {
+        return this.http.json('wordstat/map', primary(params, 'text'), options);
+    }
+    // Директ и служебные методы
+    /**
+     * Прогноз показов Директа со ставками и бюджетом. Кабинет не нужен.
+     *
+     * 0.01 ₽ за пачку до 4000 символов (около 150 фраз). До 1000 фраз за
+     * запрос, 100 запросов в час.
+     */
+    async direct(params, options) {
+        return this.http.json('direct', primary(params, 'phrases'), options);
+    }
+    /** Страна, регион и координаты по IPv4. Бесплатно, нужен ключ. */
+    async geoip(params, options) {
+        return this.http.json('geoip', primary(params, 'ip'), options);
+    }
+    /** Текущий баланс. Бесплатно, нужен ключ. */
+    async balance(options) {
+        return this.http.json('balance', {}, options);
+    }
+    // Запасной выход
+    /** Произвольный метод API — если в сервисе появился новый. */
+    async call(path, params = {}, options) {
+        return this.http.json(path, params, options);
+    }
+    /** То же, но ответ возвращается строкой без разбора. */
+    async callRaw(path, params = {}, options) {
+        return this.http.text(path, params, options);
+    }
+}
+/** Даёт вызывать метод строкой или, для `direct()`, списком фраз. */
+function primary(params, key) {
+    if (typeof params === 'string' || Array.isArray(params)) {
+        return { [key]: params };
+    }
+    if (params === null || typeof params !== 'object') {
+        throw new InvalidArgumentError('Параметры метода передаются строкой, массивом или объектом.');
+    }
+    return params;
+}

package/dist/esm/common.d.ts

@@ -0,0 +1,40 @@
+/** Значение параметра: массив склеивается, флаг даёт 1/0, null не уедет. */
+export type ParamValue = string | number | boolean | ReadonlyArray<string | number> | null | undefined;
+/** Переключатель: API принимает и 1/0, и true/false. */
+export type Flag = boolean | 0 | 1;
+/** Устройство, с которого снимается выдача. */
+export type Device = 'mobile' | 'desktop' | 'tablet';
+/** У Google и Bing планшетной выдачи нет. */
+export type MobileDevice = 'mobile' | 'desktop';
+/** Фильтрация взрослого контента у Яндекса. */
+export type AdultFilter = 'none' | 'moderate' | 'strict';
+/** Она же у Bing — значения называются иначе. */
+export type BingSafeSearch = 'off' | 'moderate' | 'strict';
+/** SafeSearch Google. */
+export type GoogleSafeSearch = 'active' | 'off';
+/** Доменная зона Яндекса. */
+export type YandexZone = 'ru' | 'tr' | 'com' | 'kz' | 'by' | 'be' | 'kk' | 'uz' | 'com.tr';
+/** Язык названий в справочниках регионов. */
+export type RegionLanguage = 'ru' | 'en';
+/** Размер картинки. У Google меньшая ступень — это значки ровно 256 px. */
+export type ImageSize = 'large' | 'medium' | 'small';
+/** Ориентация картинки. Есть у всех трёх поисковиков. */
+export type ImageOrientation = 'horizontal' | 'vertical' | 'square';
+/** Цвет: color — полноцветные, mono — чёрно-белые, остальное — основной. */
+export type ImageColor = 'color' | 'mono' | 'red' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'purple' | 'white' | 'black' | 'pink' | 'brown';
+/** Тип изображения: transparent нет у Яндекса, demotivator есть только у него. */
+export type ImageType = 'photo' | 'clipart' | 'lineart' | 'face' | 'animated' | 'transparent' | 'demotivator';
+/** Формат файла. У Bing поддерживается только gif. */
+export type ImageFormat = 'jpg' | 'png' | 'gif';
+/** Насколько свежий результат. Окна у поисковиков свои. */
+export type Freshness = 'day' | 'week' | 'month' | 'year';
+/** Длительность ролика. Границы ступеней у каждого поисковика свои. */
+export type VideoDuration = 'short' | 'medium' | 'long';
+/** Вид частотности: операторы расставит сервис, кавычки не нужны. */
+export type WordstatKind = 'base' | 'phrase' | 'exact' | 'superexact';
+/** Шаг динамики: month и week — история с 2018 года, day — последние 60 дней. */
+export type WordstatGraphType = 'day' | 'week' | 'month';
+/** Разрез географии показов. */
+export type WordstatMapType = 'all' | 'regions' | 'cities';
+/** Период прогноза Яндекс Директа. */
+export type DirectPeriod = 'week' | 'month' | 'quarter' | 'year';

package/dist/esm/common.js

@@ -0,0 +1 @@
+export {};