EverySearch場所API
POST
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好／正常
- 利用可能
- 制限あり
- ほぼ停止
正常
過去24時間
過去30日間
場所とローカルビジネスの検索
料金は1,000リクエストあたり$0.69（1回あたり$0.000694）です。失敗した呼び出しと空の結果には課金されません。
AIプロンプト
EveryInfraの「場所」APIを呼び出すスクリプトの作成を手伝ってください。
APIの仕様：
- リクエスト：POST https://api.everyinfra.com/api/v1/search、ヘッダーはAuthorization: Bearer <API Key>。キーは環境変数EVERYINFRA_API_KEYから読み込み、コードには直接書かないでください。
- リクエストボディでは、toolをplacesに設定し、パラメータはparamsに入れてください。
- 必須パラメータ：
- q: 検索クエリ。
- 任意パラメータ：
- location: 都市や地区などの場所。クエリと組み合わせて検索されます。
- num: 場所の件数。最大20件で、それより大きい値を指定しても20件が返されます。
- リクエストボディの例：
{
"tool": "places",
"params": {
"q": "coffee",
"location": "New York",
"num": 3
}
}
- 課金：料金は1,000リクエストあたり$0.69（1回あたり$0.000694）です。失敗した呼び出しと空の結果には課金されません。
- 422の場合は、エラーに含まれる提案と指定可能な値をもとにパラメータを修正してください。429または503の場合は、Retry-Afterで指定された時間だけ待ってから再試行してください。
コードを書く前に、処理する件数と結果の保存形式を私に確認し、そのうえで、計画と概算費用について私の了承を得てください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
tool | body | string | はい | places | ツール名です（固定値）。 |
q | body.params | string | はい | - | 検索クエリ。 |
location | body.params | string | いいえ | - | 都市や地区などの場所。クエリと組み合わせて検索されます。 |
num | body.params | integer (1–20) | いいえ | 10 | 場所の件数。最大20件で、それより大きい値を指定しても20件が返されます。 |
コードサンプル
bash
curl -X POST 'https://api.everyinfra.com/api/v1/search' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"tool": "places",
"params": {
"q": "coffee",
"location": "New York",
"num": 3
}
}'OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
実際のレスポンス
October 24, 2026 at 22:01（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
json
{
"id": "req_…",
"tool": "places",
"results": [
{
"title": "Dam Roast House & Browder Bookstore",
"address": "554 Nevada Way, Boulder City, NV 89005",
"latitude": 35.9771895,
"longitude": -114.838469,
"rating": 4.8,
"rating_count": 561,
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Book store"
],
"phone": "•••",
"website": "http://www.damroasthousebc.com/",
"opening_hours": {
"Saturday": "6 AM–5 PM",
"Sunday": "6 AM–5 PM",
"Monday": "6 AM–5 PM",
"Tuesday": "6 AM–5 PM",
"Wednesday": "6 AM–5 PM",
"Thursday": "6 AM–5 PM",
"Friday": "6 AM–5 PM"
},
"thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLf4-cpUw7kELwRhr17jbq5mKywqGj6YQcgRTRCjzyrp1IwiTyzk9E5y9cqSHfEc-gOK7eaWAMR1ahVoIM-rJ8Jfq50GDUFqSlYvRjJ9SXzrafaOW42dbzfD3_ex1ZfWf2Pw5YpJqad8nn7C",
"place_id": "ChIJu5l4IRYryYARDeIpoXxvZEs"
},
{
"title": "The Coffee Cup Cafe",
"address": "512 Nevada Way, Boulder City, NV 89005",
"latitude": 35.9776607,
"longitude": -114.8379609,
"rating": 4.8,
"rating_count": 3948,
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Bar",
"Cafe"
],
"phone": "•••",
"website": "http://worldfamouscoffeecup.com/",
"opening_hours": {
"Saturday": "6 AM–2 PM",
"Sunday": "6 AM–2 PM",
"Monday": "6 AM–2 PM",
"Tuesday": "6 AM–2 PM",
"Wednesday": "6 AM–2 PM",
"Thursday": "6 AM–2 PM",
"Friday": "6 AM–2 PM"
},
"thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLeandCndjsMrUCyaMWX17I-LspQ9FviwQnndWDPuRWDs3PT8wAG99vD5KHNvjIafGiRp3A7rEUaZuNkxHXdOabApOI1onpOxhYZKMqNseQeiO3w-0IMKZvyMrIR4PjR9L_ayKY",
"place_id": "ChIJ_92jHDQryYARn-GaGEjl2fw"
}
],
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200（空）
- データがありません。課金はされません。