免費的商家資訊沙箱 API 金鑰
使用免費的 24 小時沙箱單日通行證，測試商家資訊 API 和 MCP 伺服器。不需信用卡。最多可建立 2 個地點，僅同步至 10 個示範目錄。
取得免費的沙箱 API 金鑰，為您的在地 SEO 整合測試 listingsAPI 商家資訊 REST API 和託管的 MCP 伺服器，不需信用卡。單日通行證自啟用起有效 24 小時，且僅在限定期間提供。您可以建立最多 2 個地點、更新地點資料，並觀察其商家資訊同步至 10 個 listingsAPI 示範目錄，這些目錄的樣式仿照 MapQuest、Apple Maps、Bing、Yelp 等平台。任何資料都不會傳送至真實的發布平台，因此您可以試用完整的建立、同步與更新流程，而不會影響真實的商家檔案。
即時狀態： GET /api/day-pass 會顯示單日通行證目前是否開放。
單日通行證僅在限定期間提供。未開放期間，註冊請求會傳回 403 與 sandbox_closed，您仍可選用付費方案，開始其 14 天免費試用。
您可獲得的內容
每次註冊都必須提供名字、姓氏、電子郵件地址和公司，並同意服務條款和隱私權政策。使用者與 AI 代理程式使用相同的單日通行證：代理程式可以替使用者啟用通行證，再由使用者證明該電子郵件地址屬於自己。
24 小時從通行證啟用時開始計算：也就是擁有者透過電子郵件中的連結按下 Start my day pass（啟用我的單日通行證），或使用電子郵件中的 6 位數驗證碼時。連結和驗證碼在註冊後 24 小時內有效。
14 天免費試用則有所不同。它適用於已留存付款卡片資料的付費方案，並會發布至真實目錄。單日通行證不需信用卡，有效期為 1 天，且僅發布至示範目錄。
在瀏覽器中啟用
- 開啟單日通行證註冊頁面，輸入您的姓名、電子郵件地址和公司，然後同意服務條款與隱私權政策。
- 我們會透過電子郵件寄給您一個連結和一組 6 位數驗證碼。
- 開啟連結並按下 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 同源，且其所有呼叫都不需要金鑰。檢查單日通行證是否開放申請，並查看其限制：
curl https://listingsapi.com/api/day-pass1. 申請單日通行證
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 帳戶，或已使用過單日通行證，我們會改在該封電子郵件中通知擁有者，而該申請不會啟動。
{ "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 一併傳送：
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
如果對方偏好按下電子郵件中的 Start my day pass（啟用我的單日通行證），請每隔 5 秒使用 poll_token 輪詢：
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'在對方按下按鈕之前，回應會是 {"status": "pending"}，並帶有 Retry-After 標頭。按下之後，回應就是啟用呼叫所傳回的同一組憑證。
憑證
{ "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 伺服器僅接受將這類金鑰用於 locations 和 listings 端點。limits 包含通行證的即時數值，而 demo_directories 列出全部 10 個目錄。如果回應遺失，在 10 分鐘內重試啟用呼叫或再次輪詢都會傳回相同的金鑰；超過這段時間後，請求便會關閉。每個驗證碼允許嘗試 5 次，只有輸入錯誤的驗證碼才會計入次數。擁有者隨時都能透過 Email me a sign-in link（以電子郵件寄送登入連結給我）登入儀表板。
錯誤
連結 MCP
託管的 MCP 伺服器使用與 REST API 相同的標頭接收單日通行證金鑰。Claude Code 的設定如下：
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Cursor、Windsurf、Codex 和其他用戶端的設定可在 MCP 頁面找到。使用 OAuth 登入的用戶端，例如 Claude 目錄中的 listingsAPI 連接器或 Claude 自訂連接器，則會開啟 listingsAPI 登入頁面：請使用申請單日通行證的電子郵件地址，選擇 Email me a sign-in link（以電子郵件寄送登入連結給我）。使用單日通行證時，伺服器提供 locations、listings、docs 和 account 工具，包括 locations_create、locations_update 和 listings_premium。
在 AI 工具目錄中尋找 listingsAPI
MCP 伺服器和 listingsAPI 代理程式技能已收錄於以下目錄，您或您的代理程式可以從用戶端已在使用的目錄安裝：
新增代理程式技能
5 個 listingsAPI 代理程式技能已發布於 skills.sh。使用單日通行證時，適合使用 listingsapi-integration 和 listingsapi-listing-audit：這兩個技能會使用通行證所包含的地點和商家資訊。評論、貼文發布和報表技能需要單日通行證未包含的功能。請使用 Skills CLI 安裝這兩個技能：
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-audit建立地點
地址必須真實且可供地理編碼，電話號碼必須為 10 位數，描述則至少須有 200 個字元。使用範例資料也可以，因為資料只會傳送至示範目錄。
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，供下方的呼叫使用。
觀察同步過程
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 則會先顯示 IN_PROGRESS，持續 30 至 90 秒，讓您觀察狀態變化。示範頁面均標示為沙箱，並對搜尋引擎和 AI 爬蟲隱藏。
變更欄位並再次檢查
僅傳送您變更的欄位。若要變更營業時間，請傳送完整一週的資料：
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 示範目錄，絕不會同步至真實的發布平台。不包含評論、貼文、社群、分析、已連結帳戶、webhooks 及額外地點。
AI 代理程式可以替我取得沙箱金鑰嗎？
可以。在您同意服務條款與隱私權政策後，代理程式可以使用您的姓名、電子郵件地址和公司名稱申請單日通行證。您透過電子郵件中的連結或 6 位數驗證碼驗證電子郵件地址後，提出申請的代理程式就會收到 API 金鑰。註冊、啟用和狀態查詢呼叫不需要 API 金鑰。
這與 14 天免費試用相同嗎？
不同。14 天試用使用的是付費方案，需要留存付款卡片資料，並會將商家資訊發布至真實目錄。單日通行證不需要信用卡，有效期限為 1 天，且只會將商家資訊發布至示範目錄。每個電子郵件地址只能使用 1 次單日通行證，現有的 listingsAPI 客戶不符合申請資格。