Compute relative rank for car listings.

POST

/search/car/active/rank/listings

Rank Car Listings

Computer rank for car listings based on inputs provided.Weights for ranking parameters can also be provided.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://marketcheck-prod.apigee.net/v2/search/car/active/rank/listings' \
--header 'Content-Type: application/json' \
--data-raw '{
    "listing_ids": [
        "string"
    ],
    "ranking_criteria": {}
}'

Response Example

200 - Example 1

{
    "num_ranked": 0,
    "ranked_listings": [
        {
            "ranked_listing": {}
        }
    ]
}

Request

Query Params

api_key

string

optional

The API Authentication Key. Mandatory with all API calls.

append_api_key

string

optional

Flag on whether to include api_key in response API urls (if any)

Body Params application/json

Ranking query request

listing_ids

array[string]

optional

ranking_criteria

object

optional

Examples

Responses

🟢200Rank listings based on inputs provided.

application/json

Body

Ranking query response

num_ranked

integer

optional

The number of listings ranked

ranked_listings

array[object (CarListingRank) {1}]

optional

ranked_listing

object

optional

🔴500Error

Modified at 2023-08-15 07:36:55

Compute relative rank for car listings.

Gets oem incentive listings for the given search criteria