# ライブビジネスリスティング検索タスク **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/business_data/business_listings/search/live` **Tags:** DataForSEO `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 の請求記録に従います。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "categories": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "ビジネスカテゴリ
任意フィールド
指定したカテゴリはビジネスリスティングの検索に使用されます
このフィールドを使用しない場合、指定したロケーションで見つかったビジネスリスティングが返されます
最大 10 個のカテゴリを指定できます" }, "description": { "type": [ "string", "null" ], "description": "SERP に表示される要素の説明
任意フィールド
結果を収集する対象のビジネスエンティティの説明
最大 200 文字まで指定できます" }, "title": { "type": [ "string", "null" ], "description": "SERP に表示される要素のタイトル
任意フィールド
結果を収集する対象のビジネスエンティティの名前
最大 200 文字まで指定できます" }, "is_claimed": { "type": [ "boolean", "null" ], "description": "ビジネスが所有者によって Google Maps 上で確認済みかどうかを示します
任意フィールド" }, "location_coordinate": { "type": [ "string", "null" ], "description": "位置の GPS 座標
任意フィールド
location_coordinate パラメータは \"latitude,longitude,radius\" 形式で指定します
\"latitude\" と \"longitude\" の小数点以下の最大桁数: 7
\"radius\" の値はキロメートル（km）で指定します
\"radius\" の最小値: 1
\"radius\" の最大値: 100000
例:
53.476225,-2.243572,200
この API でロケーションパラメータを設定する方法については、ヘルプセンターをご覧ください" }, "filters": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ] }, "description": "結果フィルタリングパラメータの配列
任意フィールド
複数のフィルターを同時に追加できます（最大 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 にリクエストを送信すると、利用可能なフィルターの一覧を取得できます
使用可能なフィルターの完全な一覧はこちらをご覧ください。" }, "order_by": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "結果の並び替えルール
任意フィールド
filters 配列と同じ値を使用して結果を並び替えられます
指定可能な並び替えの種類:
asc - 結果を昇順で並び替えます
desc - 結果を降順で並び替えます
並び替えパラメータはカンマで設定します
例:
[\"rating.value,desc\"]1 回のリクエストで設定できる並び替えルールは 3 つまでです
複数の並び替えルールはカンマで区切ります
例:
[\"rating.value,desc\",\"rating.votes_count,desc\"]" }, "limit": { "type": [ "integer", "null" ], "description": "返されるビジネスの最大数
任意フィールド
デフォルト値: 100
最大値: 1000" }, "offset": { "type": [ "integer", "null" ], "description": "返されるビジネスの結果配列内のオフセット
任意フィールド
デフォルト値: 0
10 を指定すると、結果配列の最初の 10 件のエンティティがスキップされ、後続のエンティティのデータが返されます
注意: このパラメータは最大 10,000 件の結果を取得する場合にのみ使用することをお勧めします
10,000 件を超える結果を取得する場合は、代わりに offset_token を使用してください" }, "offset_token": { "type": [ "string", "null" ], "description": "後続のリクエスト用のトークン
任意フィールド
各リクエストのレスポンスの同じ名前のフィールドで提供されます
このパラメーターは、1 回のリクエストで 100,000 件を超える結果を取得する際のタイムアウトを回避するために使用します
レスポンス配列内の一意の offset_token 値を指定すると、最初のタスクの後続の結果を取得できます
offset_token の値は後続のタスクごとに一意です
注意: リクエストで offset_token を指定する場合、他のすべてのパラメーターは前回のリクエストと同一にする必要があります
このパラメーターの詳細については、ヘルプセンターをご覧ください" }, "tag": { "type": [ "string", "null" ], "description": "ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定した tag の値は、レスポンスの data オブジェクトに含まれます" } }, "example": [ { "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 } ] } ] }, "example": [ { "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 } ] } ``` ## Responses ### 200 — 操作成功 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo" } ] } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AddressInfo `#/components/schemas/Response36Afe1097B20_AddressInfo` ```json { "type": "object", "properties": { "borough": { "type": [ "string", "null" ], "description": "ローカル施設が属する行政単位または地区" }, "address": { "type": [ "string", "null" ], "description": "ローカル施設の番地" }, "city": { "type": [ "string", "null" ], "description": "ローカル施設がある都市の名前" }, "zip": { "type": [ "string", "null" ], "description": "ローカル施設の郵便番号" }, "region": { "type": [ "string", "null" ], "description": "ローカル施設が属する DMA 地域" }, "country_code": { "type": [ "string", "null" ], "description": "ローカル施設の ISO 国コード" } } } ``` ### Response36Afe1097B20_BaseLocalBusinessLink `#/components/schemas/Response36Afe1097B20_BaseLocalBusinessLink` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "reservation": "#/components/schemas/Response36Afe1097B20_LocalBusinessReservationLink", "order": "#/components/schemas/Response36Afe1097B20_LocalBusinessOrderLink", "menu": "#/components/schemas/Response36Afe1097B20_LocalBusinessMenuLink" } } } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API の現在のバージョン" }, "status_code": { "type": [ "integer", "null" ], "description": "一般的なステータスコード\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "一般的な情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "合計実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 配列内のタスク数", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "エラーで返された tasks 配列内のタスク数", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "タスク識別子\n当社システム内で UUID 形式の一意のタスク識別子" }, "status_code": { "type": [ "integer", "null" ], "description": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 配列内の要素数", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL パス" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST リクエストで指定したものと同じパラメーターを含みます" } } } ``` ### Response36Afe1097B20_BusinessDataAttributesInfo `#/components/schemas/Response36Afe1097B20_BusinessDataAttributesInfo` ```json { "type": "object", "properties": { "available_attributes": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "description": "利用可能な属性
ビジネスエンティティが提供できる属性を示します" }, "unavailable_attributes": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "description": "利用できない属性
ビジネスエンティティが提供できない属性を示します" } } } ``` ### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem `#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "title": { "type": [ "string", "null" ], "description": "SERP 内の要素のタイトル
結果の収集対象となるビジネスエンティティの名前" }, "original_title": { "type": [ "string", "null" ], "description": "要素の元のタイトル
Google によって翻訳されていない元のタイトル" }, "description": { "type": [ "string", "null" ], "description": "SERP における要素の説明
結果の収集対象となるビジネスエンティティの説明" }, "category": { "type": [ "string", "null" ], "description": "ビジネスカテゴリ
ビジネスエンティティが提供するサービスを最もよく表す Google My Business の一般カテゴリ" }, "category_ids": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "グローバルカテゴリ ID
選択した国に応じて変わらない汎用カテゴリ ID" }, "additional_categories": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "追加のビジネスカテゴリ
ビジネスエンティティが提供するサービスをより詳細に説明する追加の Google My Business カテゴリ" }, "cid": { "type": [ "string", "null" ], "description": "Google が定義するクライアント ID
地域施設の一意の ID
識別子の詳細については、このヘルプセンターの記事をご覧ください" }, "feature_id": { "type": [ "string", "null" ], "description": "SERP における要素の一意の識別子
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "address": { "type": [ "string", "null" ], "description": "ビジネスエンティティの住所" }, "address_info": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AddressInfo" } ], "description": "ビジネスエンティティの住所構成要素を含むオブジェクト" }, "place_id": { "type": [ "string", "null" ], "description": "一意のプレイス識別子
要素に表示される地域施設のプレイス ID
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "phone": { "type": [ "string", "null" ], "description": "ビジネスエンティティの電話番号" }, "url": { "type": [ "string", "null" ], "description": "ビジネスエンティティの絶対 URL" }, "domain": { "type": [ "string", "null" ], "description": "ビジネスエンティティのドメイン" }, "logo": { "type": [ "string", "null" ], "description": "Google マイビジネスのプロフィールに表示されるロゴの URL" }, "main_image": { "type": [ "string", "null" ], "description": "Google My Business プロフィールに表示されるメイン画像の URL" }, "total_photos": { "type": [ "integer", "null" ], "description": "Google My Business プロフィールに表示される画像の総数", "format": "int64" }, "snippet": { "type": [ "string", "null" ], "description": "ビジネスエンティティに関する追加情報" }, "latitude": { "type": [ "number", "null" ], "description": "Google マップ内の地域施設の緯度座標
例：
\"latitude\": 51.584091" }, "longitude": { "type": [ "number", "null" ], "description": "Google マップ内の地域施設の経度座標
例：
\"longitude\": -0.31365919999999997" }, "is_claimed": { "type": [ "boolean", "null" ], "description": "エンティティが Google マップ上で所有者によって確認されているかどうかを示します" }, "attributes": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataAttributesInfo" } ], "description": "ユーザーレビューのチェック項目形式のサービス詳細
チェック項目形式で表示され、ユーザーのフィードバックとビジネスの category に基づくビジネスエンティティのサービス詳細" }, "place_topics": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "integer", "null" ], "format": "int64" }, "description": "顧客レビューで言及されているキーワード
ビジネスエンティティの顧客レビューで言及されている製品/サービスに関連する最も人気のあるキーワードと、各キーワードに言及したレビュー数が含まれます
例：
\"place_topics\": {
\"egg roll\": 48,
\"birthday\": 33
}" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "properties": { "rating_type": { "type": [ "string", "null" ], "description": "評価の種類\nここには次の要素があります：Max5、Percents、CustomMax" }, "value": { "type": [ "number", "null" ], "description": "評価の値", "format": "double" }, "votes_count": { "type": [ "integer", "null" ], "description": "フィードバックの量", "format": "int64" }, "rating_max": { "type": [ "number", "null" ], "description": "rating_type の最大値", "format": "double" } }, "description": "要素の評価
レビューに基づき SERP に表示される人気度" }, "hotel_rating": { "type": [ "integer", "null" ], "description": "ホテルの星評価
星評価は 1〜5 つ星の範囲です。詳細
ホテルの星評価情報がない場合、値は null になります" }, "price_level": { "type": [ "string", "null" ], "description": "施設の価格帯
次の値を取ることができます：inexpensive、moderate、expensive、very_expensive
価格帯の情報がない場合、値は null になります" }, "rating_distribution": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "integer", "null" ], "format": "Int64" }, "description": "ビジネスエンティティの評価の分布
このオブジェクトは、ユーザーによるレビューに基づく 1 星から 5 星の評価数を表示します" }, "people_also_search": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch" } ] }, "description": "関連するビジネスエンティティ" }, "work_time": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessWorkHoursInfo" } ], "description": "営業時間の詳細
ビジネスエンティティの営業時間に関する情報" }, "popular_times": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PopularTimes" } ], "description": "人気の時間帯
ビジネスエンティティの混雑時間帯に関する情報" }, "local_business_links": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseLocalBusinessLink" } ] }, "description": "ビジネスとの利用可能なインタラクション
検索結果から直接ビジネスとやり取りするためのオプションのリスト" }, "contact_info": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo" } ] }, "description": "ビジネスの連絡先
ビジネスとやり取りするための連絡先の一覧" }, "check_url": { "type": [ "string", "null" ], "description": "検索エンジン結果への直接 URL
正確な結果が提供されていることを確認するために使用できます" }, "last_updated_time": { "type": [ "string", "null" ], "description": "データが最後に更新された日時
UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例:
2023-01-26 09:03:15 +00:00" }, "first_seen": { "type": [ "string", "null" ], "description": "クローラーがビジネス情報要素を初めて検出した日時
UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例:
2023-03-11 10:04:11 +00:00" }, "services": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataServiceInfo" } ] } } } } ``` ### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo `#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo" } ] }, "description": "タスクの配列" } } } ] } ``` ### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo `#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo` ```json { "type": "object", "properties": { "total_count": { "type": [ "integer", "null" ], "description": "当社データベース内のリクエストに関連する結果の総数", "format": "int64" }, "count": { "type": [ "integer", "null" ], "description": "項目タイプ
items 配列の項目数", "format": "int64" }, "offset": { "type": [ "integer", "null" ], "format": "int64" }, "offset_token": { "type": [ "string", "null" ] }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem" } ] }, "description": "出現した項目タイプ
items 配列で検出された検索エンジン結果のタイプ；
可能な項目タイプ: business_listing" } } } ``` ### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo `#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo" } ] }, "description": "結果の配列" } } } ] } ``` ### Response36Afe1097B20_BusinessDataContactInfo `#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "value": { "type": [ "string", "null" ], "description": "評価の値" }, "source": { "type": [ "string", "null" ], "description": "データソース" } } } ``` ### Response36Afe1097B20_BusinessDataServiceInfo `#/components/schemas/Response36Afe1097B20_BusinessDataServiceInfo` ```json { "type": "object", "properties": { "category": { "type": [ "string", "null" ], "description": "ビジネスカテゴリ
ビジネスエンティティが提供するサービスを最もよく表す Google My Business の一般カテゴリ" }, "title": { "type": [ "string", "null" ], "description": "SERP 内の要素のタイトル
結果の収集対象となるビジネスエンティティの名前" }, "snippet": { "type": [ "string", "null" ], "description": "ビジネスエンティティに関する追加情報" }, "price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ] } } } ``` ### Response36Afe1097B20_BusinessWorkHoursInfo `#/components/schemas/Response36Afe1097B20_BusinessWorkHoursInfo` ```json { "type": "object", "properties": { "work_hours": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_WorkHours" } ], "description": "営業時間
地域施設の営業時間に関する情報" } } } ``` ### Response36Afe1097B20_PeopleAlsoSearch `#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch` ```json { "type": "object", "properties": { "cid": { "type": [ "string", "null" ], "description": "Google が定義するクライアント ID
地域施設の一意の ID
識別子の詳細については、このヘルプセンターの記事をご覧ください" }, "feature_id": { "type": [ "string", "null" ], "description": "SERP における要素の一意の識別子
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "title": { "type": [ "string", "null" ], "description": "SERP 内の要素のタイトル
結果の収集対象となるビジネスエンティティの名前" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "description": "要素の評価
レビューに基づき SERP に表示される人気度" } } } ``` ### Response36Afe1097B20_PopularTimes `#/components/schemas/Response36Afe1097B20_PopularTimes` ```json { "type": "object", "properties": { "popular_times_by_days": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PopularWorkTimeInfo" } ], "description": "日曜日の営業時間" } }, "description": "人気の時間帯
地域施設の曜日ごとの混雑時間帯に関する情報" } } } ``` ### Response36Afe1097B20_PopularWorkTimeInfo `#/components/schemas/Response36Afe1097B20_PopularWorkTimeInfo` ```json { "type": "object", "properties": { "time": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo" } ], "description": "24 時間形式の時間" }, "popular_index": { "type": [ "integer", "null" ], "description": "人気指数\n0 から 100 の範囲で測定される、時間に基づく相対的な人気指数。\n値が高いほど、その日の時間帯が混雑していることを示します" } } } ``` ### Response36Afe1097B20_PriceInfo `#/components/schemas/Response36Afe1097B20_PriceInfo` ```json { "type": "object", "properties": { "current": { "type": [ "number", "null" ], "description": "現在の価格\n結果に掲載されている製品またはサービスの現在の価格を示します", "format": "double" }, "regular": { "type": [ "number", "null" ], "description": "通常価格\n割引が適用されていない製品またはサービスの通常価格を示します", "format": "double" }, "max_value": { "type": [ "number", "null" ], "description": "最高価格\n結果に示されている製品またはサービスの最高価格", "format": "double" }, "currency": { "type": [ "string", "null" ], "description": "表示価格の通貨\n価格に適用される通貨の ISO コード" }, "is_price_range": { "type": [ "boolean", "null" ], "description": "価格が範囲で提供されている\n価格が範囲で提供されているかどうかを示します" }, "displayed_price": { "type": [ "string", "null" ], "description": "結果の価格文字列\n結果で提供される生の価格文字列" } } } ``` ### Response36Afe1097B20_RatingInfo `#/components/schemas/Response36Afe1097B20_RatingInfo` ```json { "properties": { "rating_type": { "type": [ "string", "null" ], "description": "評価の種類\nここには次の要素があります：Max5、Percents、CustomMax" }, "value": { "type": [ "number", "null" ], "description": "評価の値", "format": "double" }, "votes_count": { "type": [ "integer", "null" ], "description": "フィードバックの量", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "rating_type の最大値" } } } ``` ### Response36Afe1097B20_TimeInfo `#/components/schemas/Response36Afe1097B20_TimeInfo` ```json { "type": "object", "properties": { "hour": { "type": [ "integer", "null" ], "description": "24 時間形式の時間" }, "minute": { "type": [ "integer", "null" ], "description": "分" } } } ``` ### Response36Afe1097B20_WorkDayInfo `#/components/schemas/Response36Afe1097B20_WorkDayInfo` ```json { "type": "object", "properties": { "open": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo" } ], "description": "開店時間" }, "close": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo" } ], "description": "閉店時間" } } } ``` ### Response36Afe1097B20_WorkHours `#/components/schemas/Response36Afe1097B20_WorkHours` ```json { "type": "object", "properties": { "timetable": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_WorkDayInfo" } ], "description": "日曜日の営業時間" } }, "description": "営業時間表" }, "current_status": { "type": [ "string", "null" ], "description": "店舗の現在のステータス
店舗が営業中か閉店中かを示します" } } } ```