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 操作

post/v1/beta/dataforseo/business_data/business_listings/search/live

ライブビジネスリスティング検索タスク

categories、description、title、location_coordinate（緯度・経度・半径の 3 つ組）で DataForSEO 独自のローカルビジネスリスティングのインデックスを検索します。total_count、count、offset、offset_token、items を返し、トークンでページングします。DataForSEO のエンベロープ構造です。データは tasks[0].result、結果ステータスは tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。このエンドポイントはインデックスを読み取って即座に応答します。ここにある他のものはすべてソースのライブスクレイピングをキューに登録します。まずこれを使い、必要な箇所だけを掘り下げてください。

料金の参考情報

計量方式：レスポンスで報告されるコスト。
参考リクエスト見積もり：0.2428 USD。
参考顧客乗数：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 と組み合わせて、0 文字以上の任意の文字列に一致させることができます
  例:
  ["rating.value",">",3]
  別途 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 パラメータは "latitude,longitude,radius" 形式で指定します
  "latitude" と "longitude" の小数点以下の最大桁数: 7
  "radius" の値はキロメートル（km）で指定します
  "radius" の最小値: 1
  "radius" の最大値: 100000
  例:
  53.476225,-2.243572,200
  この API でロケーションパラメータを設定する方法については、ヘルプセンターをご覧ください
- offset
  型: integer | null
  
  返されるビジネスの結果配列内のオフセット
  任意フィールド
  デフォルト値: 0
  10 を指定すると、結果配列の最初の 10 件のエンティティがスキップされ、後続のエンティティのデータが返されます
  注意: このパラメータは最大 10,000 件の結果を取得する場合にのみ使用することをお勧めします
  10,000 件を超える結果を取得する場合は、代わりに offset_token を使用してください
- offset_token
  型: string | null
  
  後続のリクエスト用のトークン
  任意フィールド
  各リクエストのレスポンスの同じ名前のフィールドで提供されます
  このパラメーターは、1 回のリクエストで 100,000 件を超える結果を取得する際のタイムアウトを回避するために使用します
  レスポンス配列内の一意の offset_token 値を指定すると、最初のタスクの後続の結果を取得できます
  offset_token の値は後続のタスクごとに一意です
  注意: リクエストで offset_token を指定する場合、他のすべてのパラメーターは前回のリクエストと同一にする必要があります
  このパラメーターの詳細については、ヘルプセンターをご覧ください
- order_by
  型: array string[] | null
  
  結果の並び替えルール
  任意フィールド
  filters 配列と同じ値を使用して結果を並び替えられます
  指定可能な並び替えの種類:
  asc - 結果を昇順で並び替えます
  desc - 結果を降順で並び替えます
  並び替えパラメータはカンマで設定します
  例:
  ["rating.value,desc"]1 回のリクエストで設定できる並び替えルールは 3 つまでです
  複数の並び替えルールはカンマで区切ります
  例:
  ["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 が定義するクライアント ID
地域施設の一意の ID
識別子の詳細については、このヘルプセンターの記事をご覧ください

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 マップ上で所有者によって確認されているかどうかを示します

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 マップ内の地域施設の緯度座標
例：
"latitude": 51.584091

local_business_links
型: array (object | null)[] | null

ビジネスとの利用可能なインタラクション
検索結果から直接ビジネスとやり取りするためのオプションのリスト

type
型: string | null

要素の種類

logo
型: string | null

Google マイビジネスのプロフィールに表示されるロゴの URL

longitude
型: number | null

Google マップ内の地域施設の経度座標
例：
"longitude": -0.31365919999999997

main_image
型: string | null

Google My Business プロフィールに表示されるメイン画像の URL

original_title
型: string | null

要素の元のタイトル
Google によって翻訳されていない元のタイトル

people_also_search
型: array (object | null)[] | null

関連するビジネスエンティティ

cid
型: string | null

Google が定義するクライアント ID
地域施設の一意の ID
識別子の詳細については、このヘルプセンターの記事をご覧ください

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

一意のプレイス識別子
要素に表示される地域施設のプレイス 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

有効な Felo API キーが必要です。
402

請求要件が満たされていないため、リクエストを続行できません。
403

このアカウントにはこの操作を行う権限がありません。
429

リクエストまたは支出の上限に達しました。
502

サービスがリクエストを完了できませんでした。
503

API または請求サービスが一時的に利用できません。
504

リクエストの処理中にサービスがタイムアウトしました。
default

エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

application/json

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": "pizza",
    "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]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

操作成功

ヘルプが必要ですか？

API・請求・アカウントのご質問はサポートへ。
Discord で Felo の開発者と交流できます。
更新履歴をご覧ください。
ボリューム価格や購買についてのご相談は営業窓口へ。
LLM での構築をお考えですか？llms.txt をご覧ください。

ライブビジネスリスティング検索タスク

認証Required

DataForSEO

ライブビジネスリスティング検索タスク

料金の参考情報

ヘルプが必要ですか？