Kunci API sandbox gratis untuk profil bisnis
Uji API profil bisnis dan server MCP: akses harian sandbox gratis 24 jam. Tanpa kartu kredit. Hingga 2 lokasi, sinkronisasi hanya ke 10 direktori demo.
Dapatkan kunci API sandbox gratis untuk menguji REST API profil bisnis listingsAPI dan server MCP yang dihosting untuk integrasi SEO lokal Anda, tanpa kartu kredit. Akses harian berlaku selama 24 jam sejak aktivasi dan ditawarkan dalam periode terbatas. Anda dapat membuat hingga 2 lokasi, memperbaruinya, dan melihat profil bisnisnya disinkronkan ke 10 direktori demo listingsAPI yang dirancang menyerupai MapQuest, Apple Maps, Bing, Yelp, dan lainnya. Tidak ada data yang pernah dikirim ke platform publikasi sungguhan, sehingga Anda dapat mencoba seluruh siklus pembuatan, sinkronisasi, dan pembaruan tanpa menyentuh profil bisnis sungguhan.
Status langsung: GET /api/day-pass menunjukkan apakah akses harian sedang tersedia saat ini.
Akses harian ditawarkan dalam periode terbatas. Saat penawaran ditutup, pendaftaran mengembalikan 403 dengan sandbox_closed, dan Anda tetap dapat memulai dengan paket berbayar yang menyertakan uji coba gratis selama 14 hari.
Yang Anda dapatkan
Setiap pendaftar memberikan nama depan, nama belakang, email, dan perusahaan, serta menyetujui Ketentuan Layanan dan Kebijakan Privasi. Orang dan agen AI menggunakan akses harian yang sama: agen dapat memulainya untuk penggunanya, dan pengguna membuktikan bahwa alamat email tersebut miliknya.
Periode 24 jam dimulai saat akses dimulai: ketika pemilik menekan Start my day pass (Mulai akses harian saya) melalui tautan yang dikirim lewat email, atau ketika kode 6 digit yang dikirim lewat email digunakan. Tautan dan kode tersebut berlaku selama 24 jam setelah pendaftaran.
Uji coba gratis selama 14 hari berbeda. Uji coba tersebut berjalan pada paket berbayar dengan kartu yang tersimpan dan memublikasikan ke direktori sungguhan. Akses harian tidak memerlukan kartu, berlaku selama 1 hari, dan hanya memublikasikan ke direktori demo.
Mulai melalui browser Anda
- Buka pendaftaran akses harian dan masukkan nama, email, serta perusahaan Anda, lalu setujui Ketentuan Layanan dan Kebijakan Privasi.
- Kami mengirimkan tautan dan kode 6 digit kepada Anda melalui email.
- Buka tautan dan tekan Start my day pass (Mulai akses harian saya), atau ketik kode di halaman pendaftaran. Dasbor Anda akan terbuka dan menampilkan kunci API Anda.
Biarkan agen AI Anda memulainya
Tempelkan instruksi untuk agen ini ke Claude, ChatGPT, Cursor, atau agen apa pun yang dapat membuat permintaan 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.
Agen melakukan panggilan yang dijelaskan di bagian berikutnya. Agen tidak pernah memerlukan dasbor, dan kunci hanya diberikan kepada agen yang meminta akses harian tersebut.
Mulai melalui kode
API akses harian berada pada origin yang sama dengan REST API, dan tidak ada panggilannya yang memerlukan kunci. Periksa apakah akses harian sedang tersedia, dan baca batasannya:
curl https://listingsapi.com/api/day-pass1. Minta akses harian
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 }'Tetapkan accept_terms hanya setelah orang tersebut menyetujui Ketentuan Layanan dan Kebijakan Privasi. Responsnya adalah 202, dan kami mengirimkan tautan serta kode 6 digit kepada orang tersebut melalui email. Untuk melindungi privasi, setiap permintaan yang diizinkan mendapatkan respons yang sama: jika alamat email tersebut sudah memiliki akun listingsAPI atau sudah digunakan untuk akses harian, kami memberi tahu pemiliknya melalui email tersebut, dan permintaan itu tidak pernah dimulai.
{ "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"}Jaga kerahasiaan poll_token. Nilai ini mengaitkan kode dan kunci dengan permintaan Anda, sehingga siapa pun yang memilikinya dapat mengambil kunci API setelah akses dimulai.
2. Mulai dengan kode yang dikirim melalui email
Minta kode 6 digit dari email kepada orang tersebut, lalu kirimkan kode itu bersama poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'Kode hanya berfungsi bersama poll_token dari permintaan yang terkait dengan pengiriman kode tersebut melalui email, sehingga kode tidak dapat dimasukkan ke situs web sebagai alternatif.
Atau tunggu pemilik menekan Start
Jika orang tersebut lebih memilih menekan Start my day pass (Mulai akses harian saya) di email, lakukan polling dengan poll_token setiap 5 detik:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Sampai orang tersebut menekannya, responsnya adalah {"status": "pending"} dengan header Retry-After. Setelah itu, responsnya berisi kredensial yang sama dengan yang dikembalikan oleh pemanggilan start.
Kredensial
{ "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 …"]}Kunci akses harian diawali dengan dp., dan API serta server MCP menerimanya hanya untuk endpoint lokasi dan profil bisnis. limits memuat nilai terkini dari akses harian, dan demo_directories mencantumkan seluruh 10 direktori. Jika respons hilang, mengulangi pemanggilan start atau melakukan polling lagi akan mengembalikan kunci yang sama selama 10 menit; setelah itu, permintaan ditutup. Hanya kode yang salah yang dihitung dalam batas 5 percobaan yang diizinkan untuk suatu kode. Pemilik dapat masuk ke dasbor kapan saja dengan Email me a sign-in link (Kirim tautan masuk melalui email kepada saya).
Kesalahan
Hubungkan MCP
Server MCP yang dihosting menerima kunci akses harian melalui header yang sama dengan REST API. Untuk Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Konfigurasi untuk Cursor, Windsurf, Codex, dan klien lainnya tersedia di halaman MCP. Klien yang masuk dengan OAuth, seperti konektor listingsAPI di direktori Claude atau konektor kustom Claude, membuka halaman masuk listingsAPI sebagai gantinya: pilih Email me a sign-in link (Kirim tautan masuk melalui email kepada saya) dengan alamat email akses harian. Dengan akses harian, server menyediakan alat lokasi, profil bisnis, dokumentasi, dan akun, termasuk locations_create, locations_update, dan listings_premium.
Temukan listingsAPI di direktori alat AI
Server MCP dan skill agen listingsAPI tercantum dalam direktori berikut, sehingga Anda atau agen Anda dapat menginstalnya dari direktori yang sudah digunakan oleh klien Anda:
Tambahkan skill agen
Sebanyak 5 skill agen listingsAPI dipublikasikan di skills.sh. Untuk akses harian, listingsapi-integration dan listingsapi-listing-audit sesuai: keduanya menggunakan lokasi dan profil bisnis yang termasuk dalam akses harian. Skill ulasan, posting, dan pelaporan memerlukan fitur yang tidak termasuk dalam akses harian. Instal keduanya dengan Skills CLI:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditBuat lokasi
Alamat harus benar-benar ada dan dapat dikonversi menjadi koordinat geografis, nomor telepon harus terdiri dari 10 digit, dan deskripsi harus berisi setidaknya 200 karakter. Data contoh boleh digunakan karena hanya dikirim ke direktori demo.
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 } }'Respons memuat lokasi baru di bawah data.createLocation.location. Simpan id lokasi tersebut dalam format base64 untuk pemanggilan di bawah ini.
Amati proses sinkronisasinya
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Setiap rekaman di bawah data.listingsForLocation memuat nama direktori demo beserta syncStatus direktori tersebut. Tujuh direktori menampilkan SYNCED dalam hitungan detik, disertai listingUrl yang membuka halaman demo. N49, Chamber of Commerce, dan Hotfrog terlebih dahulu menampilkan IN_PROGRESS selama 30 hingga 90 detik, sehingga Anda dapat mengamati perubahan statusnya. Halaman demo diberi label sebagai sandbox dan disembunyikan dari mesin pencari serta perayap AI.
Ubah satu field dan periksa lagi
Kirim hanya field yang Anda ubah. Untuk jam buka, kirim data untuk satu minggu penuh:
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": [] } ] } }'Pembaruan mengembalikan HTTP 200 meskipun validasi gagal, jadi periksa success dalam body respons, lalu baca kembali profil bisnis premium.
Instruksi untuk agen yang dapat dicoba
Setelah server MCP terhubung, tempelkan salah satu instruksi berikut ke agen Anda:
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.
Setelah 24 jam
Kunci API berhenti berfungsi dan dasbor meminta Anda untuk meningkatkan paket. Setelah itu, Anda memiliki waktu 48 jam untuk mendaftar paket Launch atau Growth dengan alamat email yang sama; kami mengirimkan tautan melalui email untuk mengatur kata sandi, dan akun sandbox dihapus segera setelah akun baru dibuat. Jika Anda tidak meningkatkan paket dalam waktu 48 jam tersebut, akun sandbox beserta datanya akan dihapus. Lokasi sandbox tidak pernah dipindahkan ke paket berbayar.
Pertanyaan yang sering diajukan
Apakah kunci API sandbox gratis, dan apakah saya memerlukan kartu kredit?
Akses harian sandbox gratis. Kartu kredit atau kata sandi tidak diperlukan. Akses ini ditawarkan selama periode terbatas; periksa ketersediaan saat ini sebelum mendaftar.
Berapa lama akses harian berlaku?
Akses ini berlaku selama 24 jam sejak aktivasi, yaitu saat Anda menekan Start my day pass (Mulai akses harian saya) melalui tautan yang dikirim lewat email atau menggunakan kode 6 digit yang dikirim lewat email.
Apa yang dapat saya uji dengan kunci API sandbox?
Anda dapat membuat dan memperbarui hingga 2 lokasi serta membaca profil bisnisnya menggunakan REST atau MCP. Profil bisnis hanya disinkronkan ke 10 direktori demo listingsAPI, tidak pernah ke platform publikasi sungguhan. Ulasan, postingan, fitur sosial, analitik, akun terhubung, webhook, dan lokasi tambahan tidak disertakan.
Bisakah agen AI mendapatkan kunci sandbox untuk saya?
Ya. Agen dapat meminta akses harian dengan nama, email, dan perusahaan Anda setelah Anda menyetujui Ketentuan Layanan dan Kebijakan Privasi. Anda memverifikasi email menggunakan tautan atau kode 6 digit yang dikirim lewat email, dan agen yang mengajukan permintaan menerima kunci API. Panggilan signup, start, dan status tidak memerlukan kunci API.
Apakah ini sama dengan uji coba gratis 14 hari?
Tidak. Uji coba 14 hari menggunakan paket berbayar dengan kartu yang tersimpan dan memublikasikan profil bisnis ke direktori sungguhan. Akses harian tidak memerlukan kartu, berlaku selama satu hari, dan hanya memublikasikan profil bisnis ke direktori demo. Setiap alamat email dapat menggunakan satu akses harian, dan pelanggan listingsAPI yang sudah terdaftar tidak memenuhi syarat.