비즈니스 등록 정보용 무료 샌드박스 API 키
무료 24시간 샌드박스 1일 이용권으로 비즈니스 등록 정보 API와 MCP 서버를 테스트합니다. 신용카드가 필요하지 않습니다. 사업장은 최대 2개까지 생성할 수 있으며, 데모 디렉터리 10개에만 동기화됩니다.
신용카드 없이 무료 샌드박스 API 키를 받아 로컬 SEO 연동에 사용할 listingsAPI 비즈니스 등록 정보 REST API와 호스팅된 MCP 서버를 테스트할 수 있습니다. 1일 이용권은 활성화 시점부터 24시간 동안 유효하며, 한정된 기간에만 제공됩니다. 사업장을 최대 2개까지 생성하고 업데이트한 뒤, 해당 등록 정보가 MapQuest, Apple Maps, Bing, Yelp 등을 본떠 만든 listingsAPI 데모 디렉터리 10개에 동기화되는 과정을 확인할 수 있습니다. 실제 게시 플랫폼에는 아무것도 전송되지 않으므로, 실제 비즈니스 프로필에 영향을 주지 않고 생성, 동기화, 업데이트의 전체 과정을 시험할 수 있습니다.
실시간 상태: GET /api/day-pass 엔드포인트에서 지금 1일 이용권을 이용할 수 있는지 확인할 수 있습니다.
1일 이용권은 한정된 기간에만 제공됩니다. 신청이 마감된 동안에는 가입 요청에 403과 sandbox_closed가 반환되며, 이때도 14일 무료 체험이 포함된 유료 요금제로 시작할 수 있습니다.
제공 내용
가입할 때는 이름, 성, 이메일, 회사 정보를 입력하고 서비스 이용약관과 개인정보 처리방침에 동의합니다. 사람과 AI 에이전트는 동일한 1일 이용권을 사용합니다. 에이전트가 사용자를 대신해 이용권을 시작할 수 있으며, 사용자는 이메일이 본인 소유임을 인증합니다.
24시간은 이용권이 시작될 때부터 계산됩니다. 즉, 사용자가 이메일로 받은 링크에서 Start my day pass(1일 이용권 시작)를 누르거나 이메일로 받은 6자리 코드를 사용할 때부터입니다. 링크와 코드는 가입 후 24시간 동안 유효합니다.
14일 무료 체험은 1일 이용권과 다릅니다. 카드가 등록된 유료 요금제에서 이용하며 실제 디렉터리에 게시됩니다. 1일 이용권은 카드가 필요하지 않고, 1일 동안 유효하며, 데모 디렉터리에만 게시합니다.
브라우저에서 시작하기
- 1일 이용권 가입 페이지를 열어 이름, 이메일, 회사 정보를 입력한 다음 서비스 이용약관과 개인정보 처리방침에 동의합니다.
- 링크와 6자리 코드를 이메일로 보내드립니다.
- 링크를 열어 Start my day pass(1일 이용권 시작)를 누르거나 가입 페이지에서 코드를 입력합니다. 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.
에이전트는 다음 섹션의 호출을 수행합니다. 에이전트는 대시보드를 사용할 필요가 없으며, 키는 이용권을 요청한 에이전트에만 전달됩니다.
코드로 시작하기
1일 이용권 API는 REST API와 동일한 오리진에 있으며, 어떤 호출에도 키가 필요하지 않습니다. 1일 이용권 신청이 가능한지 확인하고 이용 한도를 조회합니다.
curl https://listingsapi.com/api/day-pass1. 1일 이용권 요청하기
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 계정이 있거나 해당 이메일로 1일 이용권을 이미 사용했다면, 요청은 시작되지 않고 그 이메일로 사용자에게 이 사실을 알립니다.
{ "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(1일 이용권 시작)를 직접 누르려 한다면, poll_token을 사용하여 5초마다 폴링합니다:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'사용자가 버튼을 누르기 전까지는 Retry-After 헤더가 포함된 {"status": "pending"}가 응답으로 반환됩니다. 버튼을 누른 후에는 시작 호출이 반환하는 것과 동일한 자격 증명이 반환됩니다.
자격 증명
{ "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 …"]}1일 이용권 키는 dp.로 시작하며, API와 MCP 서버는 사업장 및 등록 정보 엔드포인트에서만 이 키를 허용합니다. limits에는 이용권의 실시간 값이 포함되며, demo_directories에는 10개 디렉터리가 모두 나열됩니다. 응답을 받지 못한 경우 10분 동안은 시작 호출을 재시도하거나 다시 폴링하여 동일한 키를 받을 수 있으며, 그 이후에는 요청이 종료됩니다. 코드 하나당 시도는 5회까지 허용되며, 잘못된 코드를 입력한 경우만 횟수에 포함됩니다. 사용자는 언제든지 Email me a sign-in link(이메일로 로그인 링크 받기)를 사용하여 대시보드에 로그인할 수 있습니다.
오류
MCP 연결하기
호스팅된 MCP 서버는 REST API와 동일한 헤더로 1일 이용권 키를 받습니다. Claude Code의 경우:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Cursor, Windsurf, Codex 및 기타 클라이언트의 설정은 MCP 페이지에 있습니다. Claude 디렉터리의 listingsAPI 커넥터나 Claude 사용자 지정 커넥터처럼 OAuth로 로그인하는 클라이언트는 대신 listingsAPI 로그인 페이지를 엽니다. 이 페이지에서 1일 이용권에 사용한 이메일로 Email me a sign-in link(이메일로 로그인 링크 받기)를 선택합니다. 1일 이용권에서는 서버가 locations_create, locations_update, listings_premium 등 사업장, 등록 정보, 문서, 계정 도구를 제공합니다.
AI 도구 디렉터리에서 listingsAPI 찾기
MCP 서버와 listingsAPI 에이전트 스킬이 다음 디렉터리에 등록되어 있으므로, 사용자나 에이전트가 클라이언트에서 이미 사용하는 디렉터리를 통해 설치할 수 있습니다:
에이전트 스킬 추가하기
listingsAPI 에이전트 스킬 5개가 skills.sh에 게시되어 있습니다. 1일 이용권에는 listingsapi-integration과 listingsapi-listing-audit가 적합하며, 이 스킬들은 이용권에 포함된 사업장과 등록 정보를 사용합니다. 리뷰, 게시 및 보고 스킬에는 1일 이용권에 포함되지 않은 기능이 필요합니다. 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는 처음 30~90초 동안 IN_PROGRESS를 표시하므로 상태가 바뀌는 과정을 확인할 수 있습니다. 데모 페이지에는 샌드박스라는 표시가 있으며, 검색 엔진과 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 키는 무료이며, 신용카드가 필요한가요?
샌드박스 1일 이용권은 무료입니다. 신용카드나 비밀번호는 필요하지 않습니다. 한정된 기간에만 제공되므로 가입하기 전에 현재 이용 가능 여부를 확인합니다.
1일 이용권은 얼마 동안 유효한가요?
이용권은 이메일로 받은 링크에서 Start my day pass(1일 이용권 시작)를 누르거나 이메일로 받은 6자리 코드를 사용하여 활성화한 시점부터 24시간 동안 유효합니다.
샌드박스 API 키로 무엇을 테스트할 수 있나요?
REST 또는 MCP를 사용하여 최대 2개의 사업장을 생성하고 업데이트하며 해당 사업장의 등록 정보를 조회할 수 있습니다. 등록 정보는 10개의 listingsAPI 데모 디렉터리에만 동기화되며, 실제 게시 플랫폼에는 절대 동기화되지 않습니다. 리뷰, 게시물, 소셜, 분석, 연결된 계정, 웹훅 및 추가 사업장은 포함되지 않습니다.
AI 에이전트가 대신 샌드박스 키를 발급받을 수 있나요?
가능합니다. 서비스 이용약관과 개인정보 처리방침에 동의하면 에이전트가 이름, 이메일 및 회사 정보를 사용하여 1일 이용권을 요청할 수 있습니다. 이메일로 받은 링크 또는 6자리 코드로 이메일을 인증하면 요청한 에이전트가 API 키를 받습니다. 가입, 시작 및 상태 확인 호출에는 API 키가 필요하지 않습니다.
14일 무료 체험과 동일한가요?
아닙니다. 14일 체험은 카드가 등록된 유료 요금제에서 진행되며 실제 디렉터리에 게시합니다. 1일 이용권은 카드가 필요하지 않고 하루 동안 유효하며 데모 디렉터리에만 게시합니다. 이메일 주소당 1일 이용권을 1회만 사용할 수 있으며, 기존 listingsAPI 고객은 이용 대상이 아닙니다.