Listings APIListings API
サインイン

ビジネスの掲載情報向けの無料サンドボックスAPIキー

24時間有効の無料サンドボックスデイパスで、ビジネスの掲載情報APIとMCPサーバーをテストできます。クレジットカードは不要です。最大2拠点を作成でき、同期先は10のデモディレクトリに限られます。

無料のサンドボックスAPIキーを取得すると、ローカルSEO連携に使うlistingsAPIのビジネス掲載情報REST APIとホスト型MCPサーバーを、クレジットカードなしでテストできます。デイパスは有効化から24時間利用でき、期間限定で提供されます。最大2拠点を作成して更新し、その掲載情報がMapQuest、Apple Maps、Bing、Yelpなどを模した10のlistingsAPIデモディレクトリに同期される様子を確認できます。実際の掲載先には一切送信されないため、実際のビジネスプロフィールに影響を与えずに、作成、同期、更新の一連の流れを試せます。

リアルタイムの状態： GET /api/day-pass で、デイパスが現在利用できるかを確認できます。

デイパスは期間限定で提供されます。受付期間外は、登録時に403とsandbox_closedが返されますが、有料プランの14日間の無料トライアルは引き続き開始できます。

利用できる内容

機能デイパス
料金無料です。カードもパスワードも不要です。
有効期間デイパスの開始時点から24時間です。
拠点最大2拠点です。
エンドポイントRESTおよびMCP経由で拠点と掲載情報を利用できます。
公開先10のlistingsAPIデモディレクトリのみです。
含まれないものレビュー、投稿、ソーシャル、分析、接続済みアカウント、Webhook、追加の拠点です。
利用対象者まだlistingsAPIのお客様ではない方が対象で、メールアドレスごとに1回デイパスを利用できます。

登録時には、名、姓、メールアドレス、会社名を入力し、利用規約とプライバシーポリシーに同意します。人もAIエージェントも同じデイパスを利用します。エージェントがユーザーの代わりにデイパスを開始でき、メールアドレスが本人のものであることはユーザー自身が確認します。

24時間の有効期間は、デイパスが開始した時点、つまり本人がメールのリンクからStart my day pass（デイパスを開始）を押した時点か、メールで届いた6桁のコードが使用された時点から始まります。リンクとコードは登録後24時間有効です。

14日間の無料トライアルはデイパスとは異なります。カードを登録した有料プランで利用し、実際のディレクトリに公開されます。デイパスはカードが不要で、有効期間は1日、公開先はデモディレクトリのみです。

ブラウザーで開始する

  1. デイパスの登録ページを開き、氏名、メールアドレス、会社名を入力して、利用規約とプライバシーポリシーに同意します。
  2. リンクと6桁のコードをメールでお送りします。
  3. リンクを開いてStart my day pass（デイパスを開始）を押すか、登録ページでコードを入力します。ダッシュボードが開き、APIキーが表示されます。

AIエージェントに開始してもらう

次のプロンプトをClaude、ChatGPT、Cursor、またはHTTPリクエストを送信できる任意のエージェントに貼り付けます。

エージェントでデイパスを開始する

Read https://listingsapi.com/docs/day-pass.md and start a listingsAPI sandbox day pass for me. Ask me for my first name, last name, email and company, and confirm that I accept the Terms of Service and Privacy Policy before you sign up. Then ask me for the 6-digit code from the email, or wait while I press Start my day pass in it. With the API key, create one sample location, show me which demo directories it synced to with their links, change its opening hours, and read the listings back. Use only the day pass sandbox, and show me the integration code you used.

エージェントは次のセクションの呼び出しを実行します。エージェントがダッシュボードを使う必要はなく、キーはデイパスをリクエストしたエージェントにだけ渡されます。

コードから開始する

デイパスAPIはREST APIと同じオリジンにあり、どの呼び出しにもキーは必要ありません。デイパスが受付中かどうかと、その制限を確認します。

Shell
curl https://listingsapi.com/api/day-pass

1. デイパスをリクエストする

Shell
curl -X POST https://listingsapi.com/api/day-pass/signup \  -H "Content-Type: application/json" \  -d '{    "first_name": "Ada",    "last_name": "Lovelace",    "email": "ada@example.com",    "company": "Analytical Engines",    "accept_terms": true  }'

本人が利用規約とプライバシーポリシーに同意してから、accept_termsを設定してください。レスポンスは202で、本人にリンクと6桁のコードをメールでお送りします。プライバシーを保護するため、許可されたすべてのリクエストに同じレスポンスを返します。メールアドレスにすでにlistingsAPIのアカウントがある場合や、デイパスを使用済みの場合は、その旨を本人にメールで通知し、リクエストは開始されません。

JSON
{  "status": "verification_sent",  "email": "ada@example.com",  "expires_in": 86400,  "poll_token": "9f2c…64 hexadecimal characters…",  "poll_interval_seconds": 5,  "next": {    "tell_the_user": "We emailed ada@example.com a link and a 6-digit code. …",    "with_code": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/start" },    "or_poll": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/status" }  },  "docs": "https://listingsapi.com/docs/day-pass"}

poll_tokenは秘密にしてください。このトークンはコードとキーをこのリクエストに紐付けるもので、これを知っている人は誰でも、デイパスの開始後にAPIキーを取得できてしまいます。

2. メールで届いたコードで開始する

メールに記載された6桁のコードを本人に確認し、poll_tokenとともに送信します。

Shell
curl -X POST https://listingsapi.com/api/day-pass/start \  -H "Content-Type: application/json" \  -d '{ "poll_token": "<poll_token>", "code": "482913" }'

コードは、そのコードを発行したリクエストのpoll_tokenと組み合わせた場合にのみ使えます。そのため、ウェブサイトに入力して使うことはできません。

または、本人が開始ボタンを押すのを待つ

本人がメール内の Start my day pass（デイパスを開始）を押すことを希望する場合は、poll_tokenを使って5秒ごとにポーリングします。

Shell
curl -X POST https://listingsapi.com/api/day-pass/status \  -H "Content-Type: application/json" \  -d '{ "poll_token": "<poll_token>" }'

本人がボタンを押すまでは、レスポンスは{"status": "pending"}で、Retry-Afterヘッダーが付きます。押した後は、開始の呼び出しが返すものと同じ認証情報が返されます。

認証情報

JSON
{  "status": "active",  "api_key": "dp.…",  "authorization_header": "API dp.…",  "api_base_url": "https://listingsapi.com",  "mcp_url": "https://listingsapi.com/mcp",  "expires_at": "2026-09-26T10:04:11Z",  "limits": { "locations": 2, "requests_per_minute": 30, "requests_per_day": 1500 },  "includes": ["locations", "listings"],  "demo_directories": [    { "name": "MapQuest", "sync": "instant" },    { "name": "N49", "sync": "delayed" }  ],  "dashboard_url": "https://listingsapi.com/dashboard",  "docs": "https://listingsapi.com/docs/day-pass",  "next_steps": ["Create a location: POST https://listingsapi.com/api/v4/locations …"]}

デイパスのキーはdp.で始まり、APIとMCPサーバーは、拠点と掲載情報のエンドポイントでのみこのキーを受け付けます。limitsにはデイパスの現在の値が含まれ、demo_directoriesには10のディレクトリすべてが一覧表示されます。レスポンスを受け取れなかった場合は、10分以内であれば開始の呼び出しを再試行するか再度ポーリングすると、同じキーが返されます。10分を過ぎるとリクエストは終了します。1つのコードで試せるのは5回までで、回数に数えられるのは誤ったコードだけです。本人は、Email me a sign-in link（サインインリンクをメールで受け取る）を使って、いつでもダッシュボードにサインインできます。

エラー

ステータスerror対処方法
400invalid_requestissuesに記載されたフィールドを修正してください。
403sandbox_closed現在、デイパスの受け付けは行っていません。
409sandbox_already_used開始時：このメールアドレスでは、すでにデイパスを利用しています。
409email_in_use開始時：このメールアドレスには、すでにlistingsAPIプランがあります。代わりにサインインしてください。
410code_expiredまたはpoll_token_expiredリクエストの有効期限が切れているか、認証情報がすでに取得されています。もう一度申し込んでください。
410sandbox_expiredデイパスは終了しました。開発を続けるには、プランを選択してください。
422email_not_allowed使い捨てメールサービスはブロックされています。
422invalid_codeコードが間違っているか、有効期限が切れています。最新のメールに記載されたコードを使用してください。
429too_many_attemptsコードを5回間違えました。代わりにメール内のリンクを使用してください。
429rate_limit_exceeded、daily_limit_reached、またはdomain_limit_reachedリクエストが多すぎます。後でもう一度お試しください。
503pass_not_startedデイパスを開始できませんでした。同じ呼び出しを再試行してください。

MCPに接続する

ホスト型MCPサーバーは、REST APIと同じヘッダーでデイパスのキーを受け取ります。Claude Codeの場合は、次のように設定します。

Shell
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"

Cursor、Windsurf、Codex、およびその他のクライアントの設定は、MCPページにあります。ClaudeのディレクトリにあるlistingsAPIコネクターやClaudeのカスタムコネクターなど、OAuthでサインインするクライアントでは、代わりにlistingsAPIのサインインページが開きます。そこで、デイパスに使用したメールアドレスを入力し、Email me a sign-in link（サインインリンクをメールで受け取る）を選択してください。デイパスでは、サーバーは拠点、掲載情報、ドキュメント、アカウントのツール（locations_create、locations_update、listings_premiumなど）を提供します。

AIツールのディレクトリでlistingsAPIを探す

MCPサーバーとlistingsAPIエージェントスキルは、以下のディレクトリに登録されているため、ご自身またはエージェントが、お使いのクライアントですでに利用しているディレクトリからインストールできます。

ディレクトリ登録されているもの
ClaudeコネクターディレクトリClaudeコネクターとしてのMCPサーバーです。Connect（接続）をクリックしてサインインしてください。
公式MCPレジストリcom.listingsapi/mcpとして登録されているMCPサーバーです。
Cursor DirectoryCursorプラグインとしてのMCPサーバーです。
GlamaMCPサーバーです。
SmitheryMCPサーバーです。
MCP.soMCPサーバーです。
mcpservers.orgMCPサーバーです。
ClawHub (OpenClaw)listingsAPIエージェントスキルです。
skills.shlistingsAPIエージェントスキルです。

エージェントスキルを追加する

5つのlistingsAPIエージェントスキルがskills.shで公開されています。デイパスでは、listingsapi-integrationとlistingsapi-listing-auditが適しています。どちらも、デイパスに含まれる拠点と掲載情報を使います。レビュー、投稿、レポートのスキルには、デイパスに含まれない機能が必要です。Skills CLIを使って、この2つをインストールします。

Shell
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-audit

拠点を作成する

住所はジオコーディングできる実在の住所、電話番号は10桁の番号、説明は200文字以上にしてください。送信先はデモ用ディレクトリのみなので、サンプルでも問題ありません。

Shell
curl -X POST https://listingsapi.com/api/v4/locations \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "name": "Acme Kitchen",      "description": "Acme Kitchen is a family-owned neighborhood restaurant in downtown New York serving wood-fired pizza, hand-rolled pasta, and a short seasonal menu built around produce from nearby growers. Our dining room seats forty, takeout and delivery run until close.",      "street": "350 5th Ave",      "city": "New York",      "stateIso": "NY",      "postalCode": "10118",      "countryIso": "US",      "phone": "6443859313",      "bizUrl": "https://acmekitchen.example.com",      "subCategoryId": 1432    }  }'

レスポンスでは、data.createLocation.locationの下に新しい拠点が返されます。以下の呼び出しで使用するため、その拠点のbase64のidを保存してください。

同期の様子を確認する

Shell
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \  -H "Authorization: API $LISTINGSAPI_KEY"

data.listingsForLocationの各レコードには、デモディレクトリの名前とそのsyncStatusが含まれます。7つのディレクトリでは、数秒以内にSYNCEDが表示され、デモページを開くlistingUrlも表示されます。N49、Chamber of Commerce、Hotfrogでは、最初の30〜90秒間はIN_PROGRESSが表示されるため、ステータスの変化を確認できます。デモページにはサンドボックスであることが明記されており、検索エンジンやAIクローラーからは非表示になっています。

フィールドを変更して再確認する

変更するフィールドだけを送信してください。営業時間については、1週間分をすべて送信してください。

Shell
curl -X POST https://listingsapi.com/api/v4/locations/update \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "id": "<location-id>",      "businessHours": [        { "day": "MONDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] },        { "day": "TUESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] },        { "day": "WEDNESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] },        { "day": "THURSDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] },        { "day": "FRIDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] },        { "day": "SATURDAY", "type": "CLOSED", "slots": [] },        { "day": "SUNDAY", "type": "CLOSED", "slots": [] }      ]    }  }'

更新処理はバリデーションに失敗した場合でもHTTP 200を返すため、本文のsuccessを確認してから、プレミアム掲載情報を再度取得してください。

試せるプロンプト

MCPサーバーに接続した状態で、次のいずれかをエージェントに貼り付けてください。

拠点を作成する

Use the listingsAPI tools to create a sample location for a coffee shop at a real street address in Austin, TX, with a 10-digit phone number, a website and a description of at least 200 characters. Then show its premium listings as a table of directory, syncStatus and listingUrl.

同期の様子を確認する

Show the premium listings for my listingsAPI location again. Tell me which demo directories are synced and which are still in progress, and give me the link to each demo listing page.

営業時間を変更する

Update my listingsAPI location's opening hours to 8am to 6pm on weekdays and closed on weekends, sending the full seven-day week. Then check its premium listings again and tell me what changed.

24時間後

APIキーが使用できなくなり、ダッシュボードにアップグレードを求めるメッセージが表示されます。その後48時間以内であれば、同じメールアドレスでLaunchまたはGrowthに申し込めます。パスワード設定用のリンクがメールで届き、新しいアカウントが作成されると同時にサンドボックスアカウントが削除されます。その48時間以内にアップグレードしなかった場合、サンドボックスアカウントとそのデータは削除されます。サンドボックスの拠点が有料プランに引き継がれることはありません。

よくある質問

サンドボックスのAPIキーは無料ですか？クレジットカードは必要ですか？

サンドボックスのデイパスは無料です。クレジットカードもパスワードも必要ありません。期間限定で提供されるため、申し込む前に現在の提供状況を確認してください。

デイパスの有効期間はどのくらいですか？

デイパスは、メールで届いたリンクからStart my day pass（デイパスを開始）を押すか、メールで届いた6桁のコードを使用して有効化した時点から24時間有効です。

サンドボックスのAPIキーでは何をテストできますか？

RESTまたはMCPを使用して、最大2拠点を作成・更新し、その掲載情報を取得できます。掲載情報は10のlistingsAPIデモディレクトリにのみ同期され、実際の掲載先に同期されることはありません。レビュー、投稿、ソーシャル、分析、接続済みアカウント、Webhook、追加の拠点は含まれません。

AIエージェントにサンドボックスのキーを取得してもらえますか？

はい。利用規約とプライバシーポリシーに同意いただいた後、エージェントがお名前、メールアドレス、会社名を使ってデイパスを申請できます。メールで届いたリンクまたは6桁のコードでメールアドレスを確認していただくと、申請したエージェントがAPIキーを受け取ります。signup、start、statusの呼び出しにはAPIキーは必要ありません。

これは14日間の無料トライアルと同じですか？

いいえ。14日間のトライアルは、カード情報を登録した有料プランで利用でき、実際のディレクトリに公開します。デイパスはカードが不要で、有効期間は1日間、公開先はデモディレクトリのみです。各メールアドレスで利用できるデイパスは1回限りで、既存のlistingsAPIのお客様は対象外です。