Monitoring Your Competition

You can track your offers competition and adjust prices accordingly. Use the /competitions endpoint, select pid (Driffle Product ID) and the system will return you the list of offers and their prices for the given product.

GET /products/{pid}/competitions

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Param

Name	Type	Description	Required
pid	string	Product Id	Yes

Response

200

{
  "message": "Default Response",
  "statusCode": 200,
  "pid": 123,
  "competitions": {
    "totalCount": 10,
    "offers": [
      {
        "merchantName": "Merchant A",
        "isInStock": true,
        "canBePurchased": true,
        "belongsToYou": false,
        "price": {
          "amount": 29.99,
          "currency": "USD"
        }
      }
    ]
  }
}

400

{
    "message": "Bad Request. Wrong/Invalid params format.",
    "statusCode": 400 
}

401

{
    "message": "UnAuthorized request. Invalid/Expired token",
    "statusCode": 401
}

403

{
    "message": "Forbidden Request. Action not allowed or Rate Limit exhausted.", 
    "statusCode": 403
}

500

{
    "message": "Internal Server Error",
    "statusCode": 500
}

GEThttps://services.driffle.com/api/seller/legacy/products/{pid}/competitions

Path parameters

pid*string

Product ID

Header parameters

Response

200400401403500

Default Response

Body

*/*

messagestring

Response message

statusCodenumber

Response status code

pidnumber

Unique Product ID

competitionsobject

All available stock for product. Top 20 records at the time (ordered by price descending.)

Request

JavaScriptCurlPython

const response = await fetch('https://services.driffle.com/api/seller/legacy/products/{pid}/competitions', {
    method: 'GET',
    headers: {
      "Authorization": "text"
    },
});
const data = await response.json();

Response

200400401403500

{
  "message": "text",
  "statusCode": 0,
  "pid": 0,
  "competitions": {
    "totalCount": 0,
    "offers": [
      {
        "merchantName": "text",
        "isInStock": false,
        "canBePurchased": false,
        "belongsToYou": false,
        "price": {
          "amount": 0,
          "currency": "text"
        }
      }
    ]
  }
}