İşletme kayıtları için ücretsiz test ortamı API anahtarı
İşletme kaydı API'si ve MCP sunucusu: ücretsiz 24 saatlik test ortamı günlük erişimi. Kredi kartsız. En çok 2 konum yalnızca 10 demo dizinle eşitlenir.
Yerel SEO entegrasyonunuz için listingsAPI işletme kayıtları REST API'sini ve barındırılan MCP sunucusunu test etmek üzere kredi kartı gerekmeden ücretsiz bir test ortamı API anahtarı edinin. Günlük erişim, etkinleştirildiği andan itibaren 24 saat sürer ve sınırlı dönemlerde sunulur. En fazla 2 konum oluşturabilir, bunları güncelleyebilir ve işletme kayıtlarının MapQuest, Apple Maps, Bing, Yelp ve diğerlerine benzer şekilde tasarlanmış 10 listingsAPI demo dizinle senkronize edilmesini izleyebilirsiniz. Gerçek yayın platformlarına hiçbir zaman hiçbir şey gönderilmez; böylece gerçek bir işletme profiline dokunmadan oluşturma, senkronizasyon ve güncelleme döngüsünün tamamını deneyebilirsiniz.
Canlı durum: GET /api/day-pass uç noktası, günlük erişimin şu anda açık olup olmadığını gösterir.
Günlük erişim sınırlı dönemlerde sunulur. Kullanıma kapalı olduğu dönemlerde kayıt işlemi sandbox_closed ile birlikte 403 döndürür; yine de ücretli bir planın 14 günlük ücretsiz deneme süresiyle başlayabilirsiniz.
Sunulan olanaklar
Her kayıt sırasında ad, soyad, e-posta adresi ve şirket bilgisi verilir, Hizmet Koşulları ve Gizlilik Politikası kabul edilir. İnsanlar ve yapay zekâ ajanları aynı günlük erişimi kullanır: bir ajan, kullanıcısı adına günlük erişimi başlatabilir ve kullanıcı e-posta adresinin kendisine ait olduğunu doğrular.
24 saatlik süre, günlük erişim başladığında işlemeye başlar: erişim sahibi e-postayla gönderilen bağlantı üzerinden Start my day pass (Günlük erişimimi başlat) düğmesine bastığında veya e-postayla gönderilen 6 haneli kod kullanıldığında. Bağlantı ve kod, kayıttan sonra 24 saat boyunca geçerlidir.
14 günlük ücretsiz deneme farklıdır. Kayıtlı bir kart gerektiren ücretli bir plan kapsamında sunulur ve gerçek dizinlerde yayımlama yapar. Günlük erişim kart gerektirmez, bir gün sürer ve yalnızca demo dizinlerde yayımlama yapar.
Tarayıcınızda başlatın
- Günlük erişim kayıt sayfasını açın ve adınızı, e-posta adresinizi ve şirket bilgilerinizi girin, ardından Hizmet Koşulları'nı ve Gizlilik Politikası'nı kabul edin.
- Size e-postayla bir bağlantı ve 6 haneli bir kod göndeririz.
- Bağlantıyı açıp Start my day pass (Günlük erişimimi başlat) düğmesine basın veya kayıt sayfasına kodu girin. Kontrol paneliniz API anahtarınızla birlikte açılır.
Yapay zekâ ajanınızın başlatmasını sağlayın
Bu ajan talimatını Claude, ChatGPT, Cursor veya HTTP isteği gönderebilen herhangi bir ajana yapıştırın:
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.
Ajan, sonraki bölümdeki çağrıları yapar. Kontrol paneline hiçbir zaman ihtiyaç duymaz ve anahtar yalnızca günlük erişimi talep eden ajana iletilir.
Kod üzerinden başlatın
Günlük erişim API'si, REST API ile aynı origin üzerindedir ve çağrılarının hiçbiri anahtar gerektirmez. Günlük erişimin kullanıma açık olup olmadığını kontrol edin ve sınırlarını okuyun:
curl https://listingsapi.com/api/day-pass1. Günlük erişim talep edin
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 değerini yalnızca kişi Hizmet Koşulları'nı ve Gizlilik Politikası'nı kabul ettikten sonra ayarlayın. Yanıt 202 olur ve kişiye e-postayla bir bağlantı ve 6 haneli bir kod göndeririz. Kişilerin gizliliğini korumak için izin verilen her istek aynı yanıtı alır: e-posta adresine ait bir listingsAPI hesabı zaten varsa veya bu adres için günlük erişim daha önce kullanılmışsa, bunu yanıt yerine e-postada adres sahibine bildiririz ve istek hiçbir zaman başlatılmaz.
{ "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 değerini gizli tutun. Bu değer, kodu ve anahtarı isteğinizle ilişkilendirir; dolayısıyla bu değere sahip olan herkes, günlük erişim başladıktan sonra API anahtarını alabilir.
2. E-postayla gönderilen kodla başlatın
Kişiden e-postadaki 6 haneli kodu isteyin, ardından kodu poll_token ile gönderin:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'Kod yalnızca kendisi için e-postayla gönderildiği isteğin poll_token değeriyle birlikte çalışır, bu nedenle bunun yerine web sitesine girilemez.
Ya da sahibinin başlatma düğmesine basmasını bekleyin
Kişi e-postadaki Start my day pass (Günlük erişimimi başlat) düğmesine basmayı tercih ederse poll_token ile her 5 saniyede bir sorgulayın:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Kişi düğmeye basana kadar yanıt, Retry-After üst bilgisiyle birlikte {"status": "pending"} olur. Bundan sonra yanıt, başlatma çağrısının döndürdüğü kimlik bilgileriyle aynıdır.
Kimlik bilgileri
{ "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 …"]}Günlük erişim anahtarları dp. ile başlar ve API ile MCP sunucusu bunları yalnızca locations ve listings uç noktaları için kabul eder. limits, günlük erişimin güncel değerlerini içerir ve demo_directories, 10 dizinin tamamını listeler. Bir yanıt kaybolursa başlatma çağrısını yeniden denemek veya yeniden sorgulamak 10 dakika boyunca aynı anahtarı döndürür; bu sürenin ardından istek kapatılır. Bir kod için izin verilen 5 denemeye yalnızca yanlış kodlar sayılır. Sahibi, Email me a sign-in link (Bana e-postayla oturum açma bağlantısı gönder) seçeneğiyle istediği zaman kontrol panelinde oturum açabilir.
Hatalar
MCP'yi bağlayın
Barındırılan MCP sunucusu, günlük erişim anahtarını REST API ile aynı üst bilgide alır. Claude Code için:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Cursor, Windsurf, Codex ve diğer istemciler için yapılandırmalar MCP sayfasında bulunur. Claude'un dizinindeki listingsAPI bağlayıcısı veya özel bir Claude bağlayıcısı gibi OAuth ile oturum açan istemciler, bunun yerine listingsAPI oturum açma sayfasını açar: günlük erişim için kullandığınız e-posta adresiyle Email me a sign-in link (Bana e-postayla oturum açma bağlantısı gönder) seçeneğini seçin. Günlük erişim kapsamında sunucu, locations_create, locations_update ve listings_premium dahil olmak üzere locations, listings, docs ve account araçlarını sunar.
Yapay zekâ aracı dizinlerinde listingsAPI öğesini bulun
MCP sunucusu ve listingsAPI ajan becerisi bu dizinlerde listelenir; böylece siz veya ajanınız bunları istemcinizin zaten kullandığı dizinden yükleyebilirsiniz:
Ajan becerilerini ekleyin
5 listingsAPI ajan becerisi skills.sh üzerinde yayımlanmıştır. Günlük erişim için listingsapi-integration ve listingsapi-listing-audit uygundur: bunlar, günlük erişimin kapsadığı konumları ve işletme kayıtlarını kullanır. Yorum, paylaşım ve raporlama becerileri, günlük erişimin kapsamadığı özellikler gerektirir. Bu iki beceriyi Skills CLI ile yükleyin:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditBir konum oluşturun
Adres gerçek ve coğrafi koordinatlara dönüştürülebilir, telefon numarası 10 haneli ve açıklama en az 200 karakter uzunluğunda olmalıdır. Yalnızca demo dizinlerine gönderileceği için örnek bir kayıt kullanabilirsiniz.
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 } }'Yanıt, yeni konumu data.createLocation.location altında içerir. Aşağıdaki çağrılarda kullanmak üzere konumun base64 biçimindeki id değerini saklayın.
Senkronizasyonu izleyin
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"data.listingsForLocation altındaki her kayıt, bir demo dizininin adını ve bu dizinin syncStatus değerini içerir. Yedi dizin, saniyeler içinde SYNCED değerini ve demo sayfasını açan bir listingUrl gösterir. N49, Chamber of Commerce ve Hotfrog ise önce 30 ila 90 saniye boyunca IN_PROGRESS değerini gösterir; böylece durumun değişmesini izleyebilirsiniz. Demo sayfaları test ortamı olarak etiketlenir ve arama motorlarından ve yapay zekâ tarayıcılarından gizlenir.
Bir alanı değiştirin ve tekrar kontrol edin
Yalnızca değiştirdiğiniz alanları gönderin. Çalışma saatleri için haftanın tamamını gönderin:
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": [] } ] } }'Güncelleme işlemi, doğrulama başarısız olduğunda bile HTTP 200 döndürür; bu nedenle yanıt gövdesindeki success değerini kontrol edin, ardından premium işletme kayıtlarını tekrar okuyun.
Deneyebileceğiniz ajan talimatları
MCP sunucusu bağlıyken bunlardan birini ajanınıza yapıştırın:
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 saat sonra
API anahtarı çalışmayı durdurur ve kontrol paneli sizden ücretli bir plana geçmenizi ister. Ardından aynı e-posta adresiyle Launch veya Growth planına kaydolmak için 48 saatiniz olur; parola belirlemeniz için size e-postayla bir bağlantı göndeririz ve yeni hesap oluşturulur oluşturulmaz test ortamı hesabı silinir. Bu 48 saat içinde ücretli bir plana geçmezseniz test ortamı hesabı ve verileri silinir. Test ortamındaki konumlar hiçbir zaman ücretli bir plana aktarılmaz.
Sık sorulan sorular
Test ortamı API anahtarı ücretsiz mi ve kredi kartı gerekiyor mu?
Test ortamı için günlük erişim ücretsizdir. Kredi kartı veya parola gerekmez. Sınırlı dönemlerde sunulur; kaydolmadan önce şu anda sunulup sunulmadığını kontrol edin.
Günlük erişim ne kadar sürer?
Günlük erişim, e-postayla gönderilen bağlantıdan Start my day pass (Günlük erişimimi başlat) düğmesine bastığınızda veya e-postayla gönderilen 6 haneli kodu kullandığınızda etkinleşir ve etkinleştirme anından itibaren 24 saat sürer.
Test ortamı API anahtarıyla neleri test edebilirim?
REST veya MCP kullanarak en fazla 2 konum oluşturabilir, bu konumları güncelleyebilir ve işletme kayıtlarını okuyabilirsiniz. İşletme kayıtları yalnızca 10 listingsAPI demo dizinine senkronize edilir, hiçbir zaman gerçek yayın platformlarına senkronize edilmez. Yorumlar, gönderiler, sosyal medya, analitik, bağlı hesaplar, webhook'lar ve ek konumlar dahil değildir.
Bir yapay zekâ ajanı benim için test ortamı anahtarı alabilir mi?
Evet. Hizmet Koşulları'nı ve Gizlilik Politikası'nı kabul ettikten sonra bir ajan, adınız, e-posta adresiniz ve şirket bilgilerinizle günlük erişim talep edebilir. E-postayla gönderilen bağlantıyı veya 6 haneli kodu kullanarak e-posta adresinizi doğrularsınız ve talepte bulunan ajan API anahtarını alır. Kaydolma, başlatma ve durum çağrıları için API anahtarı gerekmez.
Bu, 14 günlük ücretsiz denemeyle aynı mı?
Hayır. 14 günlük deneme, kayıtlı bir kartın bulunduğu ücretli bir plan kapsamında çalışır ve gerçek dizinlere yayın yapar. Günlük erişim için kart gerekmez, erişim bir gün sürer ve yalnızca demo dizinlerine yayın yapılır. Her e-posta adresiyle günlük erişim bir kez kullanılabilir ve mevcut listingsAPI müşterileri bu erişimden yararlanamaz.