Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Пошук бізнес-лістингів у реальному часі

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

Пошук бізнес-лістингів у реальному часі

​

Шукає у власному індексі локальних бізнес-лістингів DataForSEO за categories, description, title і location_coordinate — трійкою «широта, довгота, радіус». Повертає total_count, count, offset, offset_token і items, посторінково за токеном. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Він читає індекс і відповідає одразу; усе інше тут ставить у чергу живий скрапінг джерела. Починайте з цього й заглиблюйтеся лише там, де це потрібно.

Довідкові ціни

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: USD 0.2428.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло
application/json
  • Тип: array (object | null)[]
    • categories
      Тип: array string[] | null

      категорії бізнесу
      необов'язкове поле
      вказані категорії використовуються для пошуку бізнес-листингів;
      якщо не використовувати це поле, ми повернемо бізнес-листинги, знайдені в вказаному місцеположенні;
      можна вказати до 10 категорій

    • description
      Тип: string | null

      опис елемента в SERP
      необов'язкове поле
      опис бізнес-сутності, для якої збираються результати;
      може містити до 200 символів

    • filters
      Тип: array (object | null)[] | null

      масив параметрів фільтрації результатів
      необов'язкове поле
      можна додати кілька фільтрів одразу (не більше 8)
      між умовами потрібно вказати логічний оператор and або or
      підтримуються такі оператори:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
      оператор % можна використовувати з like і not_like, щоб зіставити будь-який рядок із нуля або більше символів
      приклад:
      ["rating.value",">",3]
      список доступних filters_by можна отримати окремим запитом до https://api.dataforseo.com/v3/business_data/business_listings/available_filters
      Повний список можливих фільтрів доступний тут.

      Порожній об'єкт
    • is_claimed
      Тип: boolean | null

      вказує, чи підтверджено бізнес його власником у Google Maps
      необов'язкове поле

    • limit
      Тип: integer | null

      максимальна кількість бізнесів, що повертаються
      необов'язкове поле
      значення за замовчуванням: 100
      максимальне значення: 1000

    • location_coordinate
      Тип: string | null

      GPS-координати місцеположення
      необов'язкове поле
      параметр location_coordinate вказується у форматі "широта,довгота,радіус"
      максимальна кількість десяткових знаків для "широти" і "довготи": 7
      значення "радіуса" вказується в кілометрах (км)
      мінімальне значення для "радіуса": 1
      максимальне значення для "радіуса": 100000
      приклад:
      53.476225,-2.243572,200
      Докладніше про налаштування параметрів місцеположення в цьому API — у Help Center

    • offset
      Тип: integer | null

      зміщення в масиві результатів бізнесів, що повертаються
      необов'язкове поле
      значення за замовчуванням: 0
      якщо вказати значення 10, перші десять сутностей у масиві результатів буде пропущено, а дані буде надано для наступних сутностей
      Примітка: цей параметр рекомендується використовувати лише під час отримання до 10 000 результатів
      для отримання понад 10 000 результатів використовуйте offset_token

    • offset_token
      Тип: string | null

      токен для наступних запитів
      необов'язкове поле
      надається в тому самому полі відповіді на кожен запит;
      використовуйте цей параметр, щоб уникнути тайм-аутів під час спроби отримати понад 100 000 результатів в одному запиті;
      вказавши унікальне значення offset_token з масиву відповіді, ви отримаєте наступні результати початкового завдання;
      значення offset_token унікальні для кожного наступного завдання
      Примітка: якщо в запиті вказано offset_token, усі інші параметри мають бути ідентичні попередньому запиту
      Докладніше про цей параметр у нашому Help Center

    • order_by
      Тип: array string[] | null

      правила сортування результатів
      необов'язкове поле
      для сортування результатів можна використовувати ті самі значення, що й у масиві filters
      можливі типи сортування:
      asc — результати сортуються за зростанням
      desc — результати сортуються за спаданням
      параметр сортування вказується через кому
      приклад:
      ["rating.value,desc"]в одному запиті можна задати не більше трьох правил сортування
      кілька правил сортування розділяються комою
      приклад:
      ["rating.value,desc","rating.votes_count,desc"]

    • tag
      Тип: string | null

      визначений користувачем ідентифікатор завдання
      необов'язкове поле
      обмеження — 255 символів
      цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
      вказане значення tag ви знайдете в об'єкті data відповіді

    • title
      Тип: string | null

      заголовок елемента в SERP
      необов'язкове поле
      назва бізнес-сутності, для якої збираються результати;
      може містити до 200 символів

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
    • cost
      Тип: number | null Формат: double

      загальна вартість завдань, USD

    • status_code
      Тип: integer | null

      загальний код стану. Повний список кодів відповіді можна знайти тут.

    • status_message
      Тип: string | null

      загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

    • tasks
      Тип: array (object | null)[] | null

      масив завдань

      • Тип: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
        • cost
          Тип: number | null Формат: double

          загальна вартість завдань, USD

        • data
          Тип: object | null

          містить ті самі параметри, які ви вказали в POST-запиті

          • propertyName
            Тип: object | null
        • id
          Тип: string | null

          ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

        • path
          Тип: array (string | null)[] | null

          шлях URL

        • result
          Тип: array (object | null)[] | null

          масив результатів

          • count
            Тип: integer | null Формат: int64

            типи елементів
            кількість елементів у масиві items

          • items
            Тип: array (object | null)[] | null

            виявлені типи елементів
            типи результатів пошукової системи, що трапляються в масиві items;
            можливі типи елементів: business_listing

            • additional_categories
              Тип: array (string | null)[] | null

              додаткові категорії бізнесу
              додаткові категорії Google My Business, які докладніше описують послуги, що надає організація

            • address
              Тип: string | null

              адреса бізнес-сутності

            • address_info
              Тип: object | null · Response36Afe1097B20_AddressInfo

              об'єкт, що містить компоненти адреси бізнес-сутності

              • address
                Тип: string | null

                адреса місцевого закладу

              • borough
                Тип: string | null

                адміністративна одиниця або район, до якого належить місцевий заклад

              • city
                Тип: string | null

                назва міста, у якому розташований місцевий заклад

              • country_code
                Тип: string | null

                код країни ISO місцевого закладу

              • region
                Тип: string | null

                регіон DMA, до якого належить місцевий заклад

              • zip
                Тип: string | null

                поштовий індекс місцевого закладу

            • attributes
              Тип: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

              відомості про послуги у вигляді пунктів, перевірених користувачами;
              відомості про послуги бізнес-сутності, показані у вигляді пунктів і на основі відгуків користувачів і category бізнесу

              • available_attributes
                Тип: object | null

                доступні атрибути
                указує атрибути, які може надати бізнес-сутність

                • propertyName
                  Тип: array (string | null)[] | null
              • unavailable_attributes
                Тип: object | null

                недоступні атрибути
                указує атрибути, які бізнес-сутність не може надати

                • propertyName
                  Тип: array (string | null)[] | null
            • category
              Тип: string | null

              категорія бізнесу
              загальна категорія Google My Business, яка найкраще описує послуги, що надає організація

            • category_ids
              Тип: array (string | null)[] | null

              глобальні ID категорій
              універсальні ID категорій, які не змінюються залежно від вибраної країни

            • check_url
              Тип: string | null

              прямий URL до результатів пошукової системи
              за його допомогою можна переконатися, що ми надали точні результати

            • cid
              Тип: string | null

              ідентифікатор клієнта, визначений Google
              унікальний ідентифікатор локального закладу
              докладніше про ідентифікатор — у цій статті довідкового центру

            • contact_info
              Тип: array (object | null)[] | null

              доступні контакти компанії
              список контактів для взаємодії з компанією

              • source
                Тип: string | null

                джерело даних

              • type
                Тип: string | null

                тип елемента

              • value
                Тип: string | null

                значення рейтингу

            • description
              Тип: string | null

              опис елемента в SERP
              опис бізнес-сутності, для якої збираються результати

            • domain
              Тип: string | null

              домен бізнес-сутності

            • feature_id
              Тип: string | null

              унікальний ідентифікатор елемента в SERP
              докладніше про ідентифікатор — у цій статті довідкового центру

            • first_seen
              Тип: string | null

              дата й час, коли наш краулер уперше виявив елемент бізнес-лістингу
              у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              приклад:
              2023-03-11 10:04:11 +00:00

            • hotel_rating
              Тип: integer | null

              класовий рейтинг готелю
              класові рейтинги варіюються від 1 до 5 зірок, докладніше
              якщо інформації про класовий рейтинг готелю немає, значення буде null

            • is_claimed
              Тип: boolean | null

              показує, чи підтверджена сутність її власником у Google Maps

            • last_updated_time
              Тип: string | null

              дата й час останнього оновлення даних
              у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              приклад:
              2023-01-26 09:03:15 +00:00

            • latitude
              Тип: number | null

              координата широти місцевих закладів у google maps
              приклад:
              "latitude": 51.584091

            • local_business_links
              Тип: array (object | null)[] | null

              доступні способи взаємодії з бізнесом
              список варіантів взаємодії з бізнесом безпосередньо з результатів пошуку

              • type
                Тип: string | null

                тип елемента

            • logo
              Тип: string | null

              URL логотипа, показаного в профілі Google My Business

            • longitude
              Тип: number | null

              координата довготи місцевого закладу в google maps
              приклад:
              "longitude": -0.31365919999999997

            • main_image
              Тип: string | null

              URL основного зображення в профілі Google My Business

            • original_title
              Тип: string | null

              вихідний заголовок елемента
              вихідний заголовок, не перекладений Google

            • people_also_search
              Тип: array (object | null)[] | null

              пов'язані бізнес-сутності

              • cid
                Тип: string | null

                ідентифікатор клієнта, визначений Google
                унікальний ідентифікатор локального закладу
                докладніше про ідентифікатор — у цій статті довідкового центру

              • feature_id
                Тип: string | null

                унікальний ідентифікатор елемента в SERP
                докладніше про ідентифікатор — у цій статті довідкового центру

              • rating
                Тип: object | null · Response36Afe1097B20_RatingInfo

                рейтинг елемента
                показник популярності на основі відгуків, що відображається в SERP

                • rating_max
                  Тип: integer | null

                  максимальне значення для rating_type

                • rating_type
                  Тип: string | null

                  тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax

                • value
                  Тип: number | null Формат: double

                  значення рейтингу

                • votes_count
                  Тип: integer | null Формат: int64

                  кількість відгуків

              • title
                Тип: string | null

                заголовок елемента в SERP
                назва бізнес-сутності, для якої збираються результати

            • phone
              Тип: string | null

              номер телефону бізнес-сутності

            • place_id
              Тип: string | null

              унікальний ідентифікатор місця
              place id місцевого закладу, представленого в елементі
              Докладніше про ідентифікатор — у цій статті довідкового центру

            • place_topics
              Тип: object | null

              ключові слова, згадані у відгуках клієнтів
              містить найпопулярніші ключові слова, пов'язані з продуктами та послугами, згаданими у відгуках клієнтів про бізнес-сутність, і кількість відгуків, у яких згадується кожне ключове слово
              приклад:
              "place_topics": {
              "egg roll": 48,
              "birthday": 33
              }

              • propertyName
                Тип: integer | null Формат: int64

                Signed 64-bit integers (long type).

            • popular_times
              Тип: object | null · Response36Afe1097B20_PopularTimes

              популярні години
              інформація про години високого навантаження бізнес-сутності

              • popular_times_by_days
                Тип: object | null

                популярні години
                інформація про завантажені години локального закладу для кожного дня тижня

                • propertyName
                  Тип: array (object | null)[] | null

                  години роботи в неділю

                  • popular_index
                    Тип: integer | null

                    індекс популярності відносний прив'язаний до часу індекс популярності від 0 до 100; вище значення відповідає більш завантаженому часу дня

                  • time
                    Тип: object | null · Response36Afe1097B20_TimeInfo

                    години в 24-годинному форматі

                    • hour
                      Тип: integer | null

                      години в 24-годинному форматі

                    • minute
                      Тип: integer | null

                      хвилини

            • price_level
              Тип: string | null

              рівень цін
              може набувати значень: inexpensive, moderate, expensive, very_expensive
              якщо інформації про рівень цін немає, значення буде null

            • rating
              Тип: object | null · Response36Afe1097B20_RatingInfo

              рейтинг елемента
              показник популярності на основі відгуків, що відображається в SERP

              • rating_max
                Тип: number | null Формат: double

                максимальне значення для rating_type

              • rating_type
                Тип: string | null

                тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax

              • value
                Тип: number | null Формат: double

                значення рейтингу

              • votes_count
                Тип: integer | null Формат: int64

                кількість відгуків

            • rating_distribution
              Тип: object | null

              розподіл рейтингів бізнес-сутності
              об'єкт показує кількість оцінок від 1 до 5 зірок за відгуками користувачів

              • propertyName
                Тип: integer | null Формат: Int64
            • services
              Тип: array (object | null)[] | null
              • category
                Тип: string | null

                категорія бізнесу
                загальна категорія Google My Business, яка найкраще описує послуги, що надає організація

              • price
                Тип: object | null · Response36Afe1097B20_PriceInfo
                • currency
                  Тип: string | null

                  валюта зазначеної ціни ISO-код валюти, застосованої до ціни

                • current
                  Тип: number | null Формат: double

                  поточна ціна указує поточну ціну товару або послуги, представлених у результаті

                • displayed_price
                  Тип: string | null

                  рядок ціни в результаті вихідний рядок ціни, як надано в результаті

                • is_price_range
                  Тип: boolean | null

                  ціна надана як діапазон указує, чи надається ціна як діапазон

                • max_value
                  Тип: number | null Формат: double

                  максимальна ціна максимальна ціна товару або послуги, зазначена в результаті

                • regular
                  Тип: number | null Формат: double

                  звичайна ціна указує звичайну ціну товару або послуги без знижок

              • snippet
                Тип: string | null

                додаткова інформація про бізнес-сутність

              • title
                Тип: string | null

                заголовок елемента в SERP
                назва бізнес-сутності, для якої збираються результати

            • snippet
              Тип: string | null

              додаткова інформація про бізнес-сутність

            • title
              Тип: string | null

              заголовок елемента в SERP
              назва бізнес-сутності, для якої збираються результати

            • total_photos
              Тип: integer | null Формат: int64

              загальна кількість зображень у профілі Google My Business

            • type
              Тип: string | null

              тип елемента

            • url
              Тип: string | null

              абсолютний URL бізнес-сутності

            • work_time
              Тип: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

              відомості про робочі години
              інформація про години роботи бізнес-сутності

              • work_hours
                Тип: object | null · Response36Afe1097B20_WorkHours

                години роботи
                інформація про робочі години місцевого закладу

                • current_status
                  Тип: string | null

                  поточний статус закладу
                  вказує, чи заклад відчинено чи зачинено

                • timetable
                  Тип: object | null

                  графік роботи

                  • propertyName
                    Тип: array (object | null)[] | null

                    години роботи в неділю

                    • close
                      Тип: object | null · Response36Afe1097B20_TimeInfo

                      час закриття

                      • hour
                        Тип: integer | null

                        години в 24-годинному форматі

                      • minute
                        Тип: integer | null

                        хвилини

                    • open
                      Тип: object | null · Response36Afe1097B20_TimeInfo

                      час відкриття

                      • hour
                        Тип: integer | null

                        години в 24-годинному форматі

                      • minute
                        Тип: integer | null

                        хвилини

          • offset
            Тип: integer | null Формат: int64

            Signed 64-bit integers (long type).

          • offset_token
            Тип: string | null
          • total_count
            Тип: integer | null Формат: int64

            загальна кількість результатів у нашій базі даних, що відповідають вашому запиту

        • result_count
          Тип: integer | null Формат: int64

          кількість елементів у масиві result

        • status_code
          Тип: integer | null

          код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

        • status_message
          Тип: string | null

          інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

        • time
          Тип: string | null

          час виконання, секунди

    • tasks_count
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks

    • tasks_error
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks, повернутих з помилкою

    • time
      Тип: string | null

      загальний час виконання, секунди

    • version
      Тип: string | null

      поточна версія API

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    application/json
Request Example for post/v1/beta/dataforseo/business_data/business_listings/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/business_listings/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "categories": [
      "pizza_restaurant"
    ],
    "description": "піца",
    "title": "pizza",
    "is_claimed": true,
    "location_coordinate": "53.476225,-2.243572,10",
    "order_by": [
      "rating.value,desc"
    ],
    "filters": [
      [
        "rating.value",
        ">",
        3
      ]
    ],
    "limit": 3
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "total_count": null,
          "count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "rating_type": "[Max Depth Exceeded]",
                "value": "[Max Depth Exceeded]",
                "votes_count": "[Max Depth Exceeded]",
                "rating_max": "[Max Depth Exceeded]"
              },
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "contact_info": [
                "[Max Depth Exceeded]"
              ],
              "check_url": null,
              "last_updated_time": null,
              "first_seen": null,
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Live Business Listings Search Tasks