免费的商家信息沙盒 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 my day pass（启动我的单日通行证），请使用 poll_token 每 5 秒轮询一次：
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 服务器只在地点和商家信息端点上接受这类密钥。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 安装这 2 个技能：
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 密钥是否免费，是否需要信用卡？
沙盒单日通行证免费。无需信用卡或密码。单日通行证仅在限定时段提供；请在注册前查看当前是否可用。
单日通行证的有效期是多久？
通行证自激活起 24 小时内有效；当您通过电子邮件中的链接点击 Start my day pass（启动我的单日通行证），或使用电子邮件中的 6 位验证码时，即会激活。
使用沙盒 API 密钥可以测试哪些功能？
您可以创建和更新最多 2 个地点，并使用 REST 或 MCP 读取这些地点的商家信息。商家信息仅同步至 10 个 listingsAPI 演示目录，绝不会同步至真实发布平台。不包含评价、帖子、社交、分析、已连接账户、webhooks 和额外地点。
AI 智能体可以为我获取沙盒密钥吗？
可以。在您同意服务条款和隐私政策后，智能体可以使用您的姓名、电子邮箱和公司信息申请单日通行证。您通过电子邮件中的链接或 6 位验证码验证电子邮箱后，发起申请的智能体便会收到 API 密钥。注册、启用和状态查询调用无需 API 密钥。
这与 14 天免费试用相同吗？
不同。14 天试用基于付费套餐，需要留存付款卡信息，并会向真实目录发布商家信息。单日通行证无需信用卡，有效期为 1 天，并且仅向演示目录发布商家信息。每个电子邮箱只能使用 1 张单日通行证，现有 listingsAPI 客户不符合申请资格。