GET/api/v4/locations/{locationId}/listings/duplicates

拠点の重複する掲載情報を取得

単一の拠点で検出された重複する掲載情報のエントリを、掲載先サイトごとにグループ化して返します。

API キーが必要です。ヘッダーの形式とキーのローテーションについては認証を参照してください。

パラメーター

パス

名前型必須説明
locationIdstring必須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.
Response
{  "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.

1つの拠点で検出されたすべての重複する掲載情報を、掲載先サイトごとにグループ化して返します。各グループはサイト(name、url)を表し、重複の可能性があるエントリを格納するlistings配列を持ちます。各重複エントリにはlistingItemIdとstatusが含まれます。本番の拠点Jenny Homeには現在重複がなく、{"data":{"duplicateListingsForLocation":[]}}が返されるため、上記のデータが入ったグループは、重複がある拠点から返されるデータ構造の例です。

ユースケース:ローカルSEOに悪影響を与える重複を解消

ディレクトリの重複エントリは、ランキングの評価シグナルを分散させ、顧客を混乱させます。拠点ごとにこのリストを取得し、各グループを確認して、実際に重複しているものに対処します。各エントリのlistingItemIdは、掲載情報を重複としてマークのlistingItemIds配列で求められる値そのものです。

JSON
{  "locationId": "TG9jYXRpb246MTgwMDI4OQ==",  "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}

実際には正しい掲載情報であるエントリは、掲載情報を重複ではないとマークで除外し、ここに表示されなくなるようにします。

ユースケース:アカウント全体の確認後に拠点ごとの詳細を確認

アカウントのすべての重複する掲載情報を取得で未対応の重複がある拠点を確認した後、このエンドポイントを使用して単一の拠点の詳細を調べます。アカウント全体の集計ではどこに重複があるかがわかり、このエンドポイントでは何が重複しているかがサイトごとにわかります。

statusは対応状況を表し、POTENTIAL(検出済み、未対応)、PROCESSING、FIXED、またはFAILEDのいずれかです。これはアカウントのレート制限が適用される拠点ごとのリストであり、429が返された場合は、Retry-Afterヘッダーで指定された時間が経過してから再試行してください。

Request
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \  -H "Authorization: API $LISTINGSAPI_KEY"