/api/v4/locations/{locationId}/listings/duplicatesجلب إدراجات الأنشطة التجارية المكررة لموقع
يُرجع إدراجات النشاط التجاري المكررة التي اكتُشفت لموقع واحد، مجمّعة حسب منصة النشر.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| locationId | string | مطلوب | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
الاستجابات
200Duplicate listings grouped by site. Each group carries the primary listing plus an array of detected duplicates.
{ "data": { "duplicateListingsForLocation": [ { "id": "U2l0ZToxNTA=", "name": "City Squares", "url": "citysquares.com", "listings": [ { "id": "RHVwbGljYXRlOjIzNTk4NDUw", "listingItemId": "TGlzdGluZ0l0ZW06MjM1OTg0NTA=", "name": "Woodbury Train Station", "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450", "status": "POTENTIAL" } ] } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
يُرجع كل إدراج نشاط تجاري مكرر اكتُشف لموقع واحد، مع تجميع الإدراجات حسب منصة النشر. تمثل كل مجموعة موقعًا إلكترونيًا (name، url) وتحتوي على مصفوفة listings من الإدراجات المحتمل تكرارها؛ ويتضمن كل إدراج مكرر listingItemId وstatus. لا توجد حاليًا إدراجات مكررة للموقع الفعلي Jenny Home، ويُرجع {"data":{"duplicateListingsForLocation":[]}}، لذا توضح المجموعة التي تحتوي على بيانات أعلاه بنية الاستجابة التي يُرجعها موقع لديه إدراجات مكررة.
حالة استخدام: إزالة الإدراجات المكررة التي تضر بتحسين الظهور في نتائج البحث المحلية
تُشتّت الإدراجات المكررة في الأدلة إشارات ترتيب نتائج البحث وتُربك العملاء. اجلب هذه القائمة لموقع، وراجع كل مجموعة، واتخذ إجراءً بشأن الإدراجات المكررة فعلًا. قيمة listingItemId في كل إدراج هي بالضبط ما تتوقعه عملية وضع علامة على إدراج نشاط تجاري بأنه مكرر في مصفوفة listingItemIds الخاصة بها:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}بالنسبة إلى الإدراجات التي تمثل في الواقع إدراج النشاط التجاري الصحيح، استبعدها باستخدام وضع علامة على إدراج نشاط تجاري بأنه غير مكرر حتى تتوقف عن الظهور هنا.
حالة استخدام: تفاصيل كل موقع بعد فحص الحساب
استخدم نقطة النهاية هذه للاطلاع على تفاصيل موقع واحد بعد أن توضح عملية جلب جميع إدراجات الأنشطة التجارية المكررة لحساب المواقع التي لديها إدراجات مكررة لم تُحسم بعد؛ إذ يخبرك ملخص الحساب أين توجد هذه الإدراجات، وتخبرك نقطة النهاية هذه ما هي، مجمّعة حسب الموقع الإلكتروني.
يعكس status حالة المعالجة: POTENTIAL (اكتُشف ولم يُتخذ إجراء بشأنه بعد)، أو PROCESSING، أو FIXED، أو FAILED. هذه قائمة خاصة بموقع واحد وتخضع لحد معدل الطلبات الخاص بالحساب؛ وعند تلقي 429، أعد المحاولة بعد انقضاء المدة المحددة في ترويسة Retry-After.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"