Документация
Как работает PlaceGrid
Весь продукт на одной странице: регионы и типы мест, бесплатный пробный поиск, фильтры, обогащение, результаты, экспорт и цены. Есть и версия в простом Markdown для вашего ИИ.
Места из Google Maps в любом регионе вместе с контактами, которые публикуют их собственные сайты: вы находите, фильтруете, обогащаете и выгружаете их в одном веб-приложении.
PlaceGrid находит все компании выбранных видов в границах регионов, взятых с карты, ещё до любого списания сообщает, сколько их и во что они обойдутся, и добавляет к каждому месту то, что вы попросите: полную карточку места Google, контакты с его сайта, отзывы, фото, проверку сайта. С результатом вы работаете в таблице, на карте и в карточке каждого места, а затем экспортируете его.
Основные понятия
- Проект: одна задача с её регионами, типами мест, языком поиска, фильтрами, обогащением и всеми поисками, сделанными для неё. Проект хранит свои результаты, поэтому следующий поиск показывает, что изменилось.
- Регион: территория в границах самой карты (страна, регион, город, район). Отмеченный регион охватывает всё, что внутри него. Места за пределами ваших регионов никогда не показываются и не оплачиваются.
- Тип места: вид бизнеса, который нужно найти (стоматолог, кафе, отель …); его выбирают из списка распространённых типов или пишут своими словами. Вы также выбираете язык, на котором отвечает Google Maps.
- Пробный поиск: бесплатная проба поиска. Она показывает, сколько там мест, что добавляет каждый тип места, сколько будет стоить полный поиск и сколько времени он займёт, а также даёт выборку мест, на которой можно опробовать фильтры.
- Фильтры поиска: условия, по которым решается, за какие места поиск платит и какие обогащает.
- Обогащение: то, что добавляется к каждому месту, прошедшему фильтры. У каждого типа своя цена за результат.
- Поиск: полный сбор. Он проходит каждый регион участок за участком, поэтому не ограничен первой сотней результатов, которую выдаёт поиск по карте.
- Результаты: места, которые нашёл поиск и за которые вы заплатили.
- Кредиты: единица, в которой оценивается работа. Один кредит стоит 0,001 €. Новый аккаунт получает 1 000 бесплатных кредитов; остальные покупаются пакетами, картой (см. Цены).
- Организация: аккаунт, который оплачивает работу своих участников из собственных кредитов (см. Лимиты и контроль).
Этапы проекта
Приложение ведёт проект через восемь этапов, перечисленных рядом с ИИ-ассистентом. К любому из них можно вернуться в любой момент.
Приложение работает и в браузере телефона: все этапы, результаты (в виде карточек), экспорт и пополнение баланса. Его интерфейс говорит по-английски и на других европейских языках; выберите свой на странице аккаунта.
- Проект: дайте ему название и одной фразой скажите, для чего он; по этому описанию ассистент предлагает регионы и типы мест.
- Регионы: отметьте страны, регионы, города или районы в дереве, найдите их по названию и посмотрите на карте.
- Типы мест: что искать и язык поиска.
- Пробный поиск: бесплатно. Оценка приходит с диапазоном, стоимостью и временем, а также с тем, сколько мест каждый тип находит такого, чего не находит ни один другой. Если у найденных мест часто встречаются другие категории Google, они предлагаются как дополнительные типы мест.
- Фильтры: оставьте только нужные места. Фильтровать можно по статусу работы, категориям, словам в названии, сайту, телефону, онлайн-записи, подтверждённой карточке, рейтингу, числу отзывов и удобствам. Каждое изменение сразу пересчитывается на выборке пробного поиска: сколько мест остаётся и сколько отсекает каждый фильтр сам по себе.
- Обогащение: выберите типы (для контактов ещё и глубину), а для отзывов и фото укажите, сколько их брать на место. Каждый тип показывает свою стоимость и время.
- Поиск: выберите лимит расходов или обойдитесь без него и запустите поиск. Найденные места, потраченные кредиты и оставшееся время видны в реальном времени. После изменения настроек этот этап говорит, какой работы потребует изменение (доплаты к уже имеющемуся результату или нового поиска) и сколько она стоит.
- Результаты: таблица, карта, карточка каждого места, фильтры, колонки и экспорт.
Что есть у каждого места
| Поле | Значение |
|---|---|
| Название, категории | Как в карточке |
| Адрес, город, страна, координаты, часовой пояс | Местоположение |
| Телефон, сайт | Контакты из карточки |
| Рейтинг, число отзывов | Текущий рейтинг и количество отзывов |
| Статус работы | Работает, закрыто временно или навсегда |
| Подтверждённая карточка, ссылка на запись, зона обслуживания | Управляет ли карточкой владелец, ведёт ли она на онлайн-запись или онлайн-заказ, обслуживает ли место территорию без собственной точки |
| Удобства | Те, что перечисляет поисковый ответ Google (обычно только связанные с доступностью); Карточка места даёт их все |
| Place ID, CID, ссылка на Google Maps | Постоянные идентификаторы |
Часы работы по дням недели, описание и меню есть в полной карточке места (см. Карточка места ниже).
Обогащение
Карточка места
Полная карточка места даёт больше, чем поиск: все категории, описание, часы работы, меню или список услуг (с ценами, если компания их указывает), публикации владельца, время посещения, оценки по звёздам, все удобства, которые перечисляет Google, ссылки на запись и заказ, а также подтверждена ли карточка владельцем.
Контакты с сайта
Сайт из карточки места читается в поисках контактов: главная страница, затем страницы контактов, реквизитов и «О нас». Результат:
- email, каждый со своим типом, если адрес надёжно его выдаёт: общий (info@, office@ …), личный, отдел (продажи, заказы, бухгалтерия …) или филиал. Если не выдаёт, тип не указывается;
- дополнительные телефоны, профили в соцсетях и ссылки на запись, найденные на сайте;
- где найден каждый контакт: страница и то, было ли это ссылкой, текстом страницы, разметкой сайта или находкой ИИ;
- куда на самом деле ведёт сайт: на профиль в соцсети, систему записи, страницу в каталоге или на новый сайт той же компании. Каталог или сайт другой компании не читается в поисках контактов.
Четыре глубины, у каждой своя цена:
| Глубина | Что читает |
|---|---|
| Обычный | Страницы в том виде, как их отдаёт сайт |
| JavaScript | Те же страницы, но сначала открытые в браузере: находит контакты на сайтах, собранных скриптами |
| ИИ-поиск | Открытые в браузере страницы читает ИИ-агент: он выбирает контакты и решает, какие страницы открыть дальше |
| ИИ + соцсети | Агент может открыть ещё и профили компании в соцсетях, в пределах фиксированного бюджета на место; если сайт, указанный в Google Maps, сам является профилем, агент начинает с него. Прочитать страницу Facebook или Instagram, на которую ссылается сайт, обычно стоит дороже, чем позволяет этот бюджет |
Email нет в Google Maps: их берут с собственного сайта компании и находят примерно у 40–45 % мест, у которых он есть, в зависимости от ниши. Место оплачивается, только если найден email или профиль в соцсети.
Отзывы
Сначала новые, до заданного вами числа на место: текст, оценка и дата каждого отзыва и ответ владельца. Приходят и темы отзывов от Google.
Фото
До заданного вами числа на место, в том порядке, в каком их показывает галерея Google, вместе с собственным счётчиком галереи и её вкладками. Так видно, публиковал ли владелец фото и есть ли фото меню или видео.
Проверка сайта
Один взгляд на сайт каждого места:
- его состояние: работает; работает по новому адресу; работает, но закрыт от роботов; отвечает с ошибкой; не отвечает; домена нет; припаркован или продаётся; чужой сайт; своего сайта нет (страница в соцсети или системе записи); неверный адрес;
- HTTPS: действует, цепочка неполная, истёк, ещё не действует, выдан на другой адрес, самоподписанный, недоверенный или нет HTTPS; когда истекает сертификат; ведёт ли http на https;
- на чём он работает: CMS и её версия, рекламные пиксели (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), аналитика и менеджеры тегов, системы записи.
Каждый вердикт считается ответом и оплачивается, даже если сайт не работает: именно это проверка и находит.
Есть, нет, неизвестно
Каждое необязательное поле находится в одном из трёх состояний, и приложение говорит, в каком:
- есть: значение найдено;
- нет: его искали, и его не существует (например, в карточке нет сайта);
- неизвестно: его не проверяли или проверка не удалась.
«Нет сайта» и «не проверялось» означают разное, и база лидов, построенная на первом ответе, отличается от базы, построенной на втором. Когда отказывает собственный источник места (домена не существует, сайт не отвечает, место пропало из Google), приложение так и говорит, ничего за это не списывает и отличает это от ошибки на нашей стороне, после которой попытка повторяется.
Работа с результатами
- Таблица: выбирайте из примерно 80 колонок, расставляйте их в любом порядке, задавайте ширину и сортируйте по ним. Карта показывает те же места; щелчок открывает карточку места, устроенную как в Google Maps: обзор, меню и услуги, отзывы (с поиском и фильтром по оценке), фото. На телефоне места показываются карточками.
- Фильтры результата: сужайте показанное по любым собранным данным. Среди них личный email на собственном домене сайта, профили в выбранных соцсетях, меню с ценами, работа в выходные или допоздна, отзыв на 1–2★ без ответа владельца, рейтинг, отстающий от отзывов, слова, которые упоминаются в отзывах, состояние сайта, сертификат, CMS или пиксели, город. Эти фильтры бесплатны и ничего не меняют в оплаченном.
- Ваши колонки: текстовая колонка или список ваших значений (с цветами и значением по умолчанию); заполняются прямо в таблице, в карточке места или сразу для многих мест. По ним можно фильтровать и сортировать; они попадают в экспорт.
- AI-колонки: напишите задачу («Лечат ли здесь детей?»), и ИИ-агент заполнит колонку для каждого места значением из вашего списка, заполненным шаблоном или свободным текстом. Вы решаете, что агенту показать и чем ему можно пользоваться (только полями места, его сайтом, интернетом или веб-поиском), а также сколько обращений он может сделать. В каждой ячейке сохраняются объяснение агента и страницы, которые он прочитал.
- Пресеты: сохраните колонки, их ширину и порядок вместе с фильтрами как набор для одной задачи (обзвон, рассылка), для всех проектов или для одного, и применяйте одним щелчком.
- Обогащение результатов: добавьте обогащение к местам, которые показывает таблица, без нового поиска.
- История и сравнение: каждый поиск сохраняется. Откройте прошлый в том виде, каким он был, или сравните два: что появилось, что изменилось (и какие поля), что пропало.
Повторный поиск
- Добавить типы мест или регионы: результат дополняется. Ищется только новое, а за уже оплаченные места повторно не платят.
- Убрать часть: результат сужается бесплатно.
- Повторить поиск по типу: его места находятся заново и оплачиваются снова. Для каждого типа обогащения выберите, какие места обогащать: только новые, новые и изменившиеся или все заново.
- Поиск, остановленный лимитом: продолжите его с того места, где он остановился.
- Более широкие фильтры после поиска: места, которые поиск нашёл, но не оплатил, предлагаются как доплата с ценой по фактическим местам.
- Тип обогащения, включённый после поиска: доплата добавит его к уже имеющимся местам без нового поиска.
Экспорт
XLSX, CSV, HTML, JSON, XML или Parquet: те места, колонки и порядок, что показывает таблица, с её фильтрами. Табличные и страничные форматы используют названия колонок на языке вашего интерфейса, а форматы данных используют постоянные ключи и типизированные значения (числа, метки времени, списки, записи, например позиции меню или отзывы).
Цены
Цены указаны в кредитах; один кредит стоит 0,001 €, поэтому все цены ниже можно читать как евро за 1 000. Любой поиск показывает свою стоимость до запуска.
| Что | За что вы платите | За 1 000 |
|---|---|---|
| Пробный поиск | бесплатно | |
| Места | каждое отдельное место, найденное в ваших регионах | 1,00 € |
| Карточка места | каждое место | 1,00 € |
| Контакты с сайта: обычный | каждое место, где найден email или профиль в соцсети | 0,75 € |
| Контакты с сайта: JavaScript | то же | 4,25 € |
| Контакты с сайта: ИИ-поиск | то же | 17,50 € |
| Контакты с сайта: ИИ + соцсети | то же | 20,00 € |
| Отзывы | каждый собранный отзыв | 0,50 € |
| Фото | каждое собранное фото | 0,50 € |
| Проверка сайта | каждое место с сайтом | 2,25 € |
| AI-колонки | токены модели и страницы, которые она читает, по ценам, указанным в приложении | по факту |
| Ассистент | бесплатно |
Пример: 1 000 стоматологов в регионе, обычные контакты найдены у 430 из них. Стоимость: 1,00 € + 0,32 € = 1,32 €.
Правила:
- Пробный поиск бесплатен, как и просмотр того, сколько мест оставят ваши фильтры.
- Дубли, места за пределами ваших регионов и неудачные запросы не оплачиваются.
- Контакты оплачиваются, только если найден email или профиль в соцсети: сайт, который не удалось прочитать, ничего не стоит.
- За уже оплаченное место не платят повторно, когда вы добавляете типы мест или регионы или продолжаете поиск.
- Поиск оплачивает не менее 10 % мест, найденных в ваших регионах, сколько бы ни оставили фильтры, и это учитывается, когда вы позже расширите фильтры.
- Сужение результатов, ваши колонки, пресеты и экспорт ничего не стоят.
Пополнение баланса
Платите по мере надобности: подписки нет, и ничего не продлевается.
- 1 000 бесплатных кредитов получает каждый новый аккаунт. Это примерно 1 € работы, чтобы попробовать поиск по своим регионам.
- Пакеты: кредиты покупаются пакетами, от 10 € за 10 000 кредитов; крупные пакеты дают до 15 % кредитов сверху. Доступные пакеты и их цены показываются до оплаты.
- Оплата: картой, на странице оплаты Stripe; номер вашей карты мы никогда не видим. Цены указаны в евро. К каждому платежу прилагается чек Stripe.
- Сразу: кредиты зачисляются, как только проходит платёж. При оформлении вы просите предоставить их сразу и подтверждаете, что, если вы покупаете как потребитель, на этом заканчивается ваше право на отказ от покупки в течение 14 дней.
- Действуют 365 дней: кредиты, бесплатные или купленные, действуют 365 дней со дня зачисления; первыми тратятся те, что сгорают раньше. Не использованные к этому сроку кредиты сгорают.
- Возвраты: платежи не возвращаются, кроме случаев, когда этого требует закон. Если платёж возвращён или оспорен, зачисленные по нему кредиты списываются; если часть уже потрачена, баланс уходит в минус, и новую платную работу нельзя начать, пока покупка его не погасит.
Полные условия изложены в документе Условия использования.
Лимиты и контроль
- Лимит расходов на каждый поиск, а можно и без лимита. Без лимита поиск идёт, пока позволяют баланс и месячный лимит; с лимитом он никогда не потратит больше, а поднять лимит можно прямо во время поиска. В любом случае поиск останавливается, когда заканчиваются деньги, и сохраняет найденное.
- Месячный лимит на весь аккаунт задаётся на странице аккаунта.
- Организации: аккаунт может стать организацией и, как только купит кредиты, приглашать коллег по email. Организация оплачивает их работу из собственных кредитов: решает для каждого участника, может ли он их тратить, может задать ему месячный лимит и видит, сколько каждый потратил в этом месяце, но никогда не видит их проекты и результаты. Собственные кредиты участника заморожены, пока он не выйдет из организации.
- Страница «Расход» помесячно показывает каждый потраченный кредит по дням, видам работы, проектам и поискам, а также зачисленные кредиты.
Ассистент
ИИ-ассистент находится рядом с каждым этапом. Он предлагает регионы и типы мест по названию и заметкам проекта и сам их задаёт; меняет фильтры, обогащение и фильтры результата, заполняет ваши колонки и настраивает AI-колонки (каждое изменение показывается карточкой, из которой его можно открыть); считает места на пробном поиске и в результатах, ничего не тратя, и отвечает на вопросы о проекте и приложении. Он никогда не запускает поиск и не тратит кредиты. Он бесплатен.
API
Публичный API для вашего собственного кода сейчас в разработке. Пока он не готов, всё делается в веб-приложении; если вам нужен программный доступ, напишите нам.
Поддержка
Если вы вошли, откройте раздел Поддержка в верхней панели приложения: ваши обращения и наши ответы хранятся там, а после подтверждения адреса приходят и по email. Если нет, напишите нам со страницы контактов.