Skip to main content
POST
/
resaleInsights
cURL
curl --request POST \
--url https://api.phia.com/getResaleInsights \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "clientRequestId": "123e4567-e89b-12d3-a456-426614174000",
  "brand": "cartier",
  "title": "Tank Louis Cartier watch",
  "productUrl": "https://www.cartier.com/en-us/watches/collections/tank/tank-louis-cartier-watch-CRWGTA0011.html",
  "productImagesUrls": [
    "https://www.cartier.com/dw/image/v2/BGTJ_PRD/on/demandware.static/-/Sites-cartier-master/default/dw269f57c0/images/large/4e95821d0c495d2faff283a2b5a5ade5.png"
  ],
  "price": 13000,
  "currency": "USD"
}'
{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "clientRequestId": "123e4567-e89b-12d3-a456-426614174000",
  "productInsightsScore": 71,
  "averageProductResaleValue": 1000
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
clientRequestId
string<uuid>
required

Unique identifier provided by the client to track this request. Will be returned in the response.

​
brand
string
required

Product brand (leave empty if not available). For subbrands, use the subbrand name (e.g., Banana Republic under Gap).

​
title
string
required

Product title.

​
productUrl
string
required

Product URL.

​
productImagesUrls
string[]
required

List of product image URLs.

​
price
number
required

Product price.

​
currency
string
required

Product currency (e.g., USD, EUR).

​
description
string

Product description (if available).

​
color
string

Product color (if available).

​
size
string

Product size (if available).

Response

Successful operation

​
responseId
string

Response ID for debugging and auditing.

​
clientRequestId
string<uuid>

The client-provided request ID, allowing correlation between requests and responses.

​
productInsightsScore
integer

Product resale score, range from 0 to 100+. Note that it can go above 100 for some products.

​
averageProductResaleValue
number

Average resale value of a product in USD.

​
brandInsightsScore
integer

(Coming soon) Brand resale score, range from 0 to 100+. Note that it can go above 100 for some brands.