GET /:country/listings/map

Returns a map for partner’s listing IDs (source_id) mapped to corresponding Opendi listing IDs (opendi_id). If the optional source_id URL parameter is set, the mappings will be returned only for that ID.

This request is limited to a maximum of 1000 entries.

Parameters

Key
Value
source_id
Optional
Partner’s unique listing ID to filter by. May contain alphanumeric characters and the following symbols: -, _, and *.

Asterisk (*) is treated as a wildcard.

Responses

On success returns HTTP 200 OK with the folowing data:

Key Content / Description
numFound The number of mappings matching the given source_id
numReturned The number of mappings returned, can be less than numFound.
mappings An array of Mappings (can be empty).

On error returns an Error object.

Examples

GET https://api.opendi.com/de/listings/map?source_id=1234

HTTP 200 OK

{
    "numFound": 1,
    "numReturned": 1,
    "results": [
        {
            "source_id": "1234",
            "opendi_id": "678865"
        }
    ]
}

GET https://api.opendi.com/de/listings/map?source_id=warendorf%2A

HTTP 200 OK

{
    "numFound": 2,
    "numReturned": 2,
    "results": [
        {
            "source_id": "warendorf-1234333",
            "opendi_id": "678865"
        },
        {
            "source_id": "warendorf-1234234",
            "opendi_id": "678866"
        }
    ]
}