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
}

get

/products/{pid}/competitions

Path parameters

pidanyrequired

Product ID

Header parameters

Authorizationanyrequired

Authorization token in Bearer <token> format. Example: Bearer dvakycjgw8liyd278y

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://services.driffle.com/api/seller/legacy/products/{pid}/competitions'

200

400

401

403

500

200

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

Default Response