API Documentation
Authentication
Login API
Endpoint:
POST https://api.delupe.net/api/login
Description: Used to generate access and refresh tokens for authentication.
Request Body:
{
"username": "userName",
"password": "password"
}
Response:
{
"refresh": "refresh_token",
"access": "access_token"
}
Notes:
The access token expires in 2 hours.
The refresh token is valid for 6 days.
Use the refresh token to obtain a new access token without re-logging in.
Token Refresh API
Endpoint:
POST https://api.delupe.net/api/token/refresh
Description: Used to renew an expired access token.
Request Body:
{
"refresh": "refresh_token"
}
Response:
{
"refresh": "new_refresh_token"
"access": "new_access_token"
}
Notes:
If the refresh token is still valid, a new access token will be issued.
If the refresh token has expired, the user must log in again.
Country Search API
Get Country List
Endpoint:
GET https://api.delupe.net/api/search/countries/getcountryList?country=uk
Description: Retrieves a list of countries or a specific country if the country parameter is provided.
Query Parameters:
country (optional) – ISO2 country code (e.g., UK for the United Kingdom).
Response Example (For `UK`):
{
"id": 235,
"iso2": "UK",
"iso3": "GBR",
"name": "United Kingdom",
"status": "A",
"default_lang": "en",
"currency": "GBP",
"cc_tld": ".uk",
"default_cpc": "0.60",
"search_status": "A"
}
Notes:
If no country parameter is provided, a full list of available countries is returned.
Requires a Bearer Token for authentication.
Merchant Search API
Get Merchant List
Endpoint:
GET https://api.delupe.net/api/search/merchants/getmerchantList?country=UK
Description: Retrieves a list of merchants for a specified country.
Query Parameters:
country (required) – ISO2 country code.
Response Example:
{
"total_results": 1442,
"offset": 0,
"limit": 10000,
"data": [
{
"id": "203631",
"name": "Binocular Base",
"country_id": 235,
"url": "",
"products_count": 0,
"domain": "",
"adult_content": "None"
},
{
"id": "48923",
"name": "Design2Please",
"country_id": 235,
"url": "",
"products_count": 0,
"domain": "",
"adult_content": "None"
}
]
}
Error Response:
{
"error": "Country not found. Please provide a valid country ISO2 value"
}
Notes:
The country parameter is mandatory.
Requires a Bearer Token for authentication.
Product Search API
Get Product List
Endpoint:
GET https://api.delupe.net/api/search/products/getProductList?perPage=1000&country=UK&merchantId=157966
Description: Retrieves a list of products filtered by country and optional parameters.
Query Parameters:
country (required) – ISO2 country code.
merchantId (optional) – Filter results by merchant ID.
feedId (optional) – Filter results by feed ID.
updatedAfter (optional) – Filter results by products updated after a given timestamp (ISO format YYYY-MM-DDTHH:MM:SS).
perPage (optional) – Number of results per page (default: 100).
paginationToken (optional) – Used for paginated requests.
Example Requests:
Basic Request:
GET https://api.delupe.net/api/search/products/getProductList?country=UK
Filter by Merchant ID:
GET https://api.delupe.net/api/search/products/getProductList?country=UK&merchantId=157966
Filter by Feed ID:
GET https://api.delupe.net/api/search/products/getProductList?country=UK&feedId=420796
Filter by Updated After Timestamp:
GET https://api.delupe.net/api/search/products/getProductList?country=UK&updatedAfter=2025-02-11
Paginated Request:
GET https://api.delupe.net/api/search/products/getProductList?country=UK&perPage=1000&paginationToken=abc123
Response Example:
{
"username": "userName",
"total_results": 1000,
"perPage": 1000,
"data": [
{
"title": "2PCS Steel Deep Groove Wheel Bearing 6203-2RS Bearing Agriculture",
"name": "EBAY_GB (Garden & Patio)",
"id": "v1|186927551404|694989961197_38_157966_420796",
"innerId": "v1|186927551404|694989961197",
"brandName": null,
"deepLink": "Product_tracking_link",
"imageLink": "https://i.ebayimg.com/images/g/ddIAAOSwwaRnoXDg/s-l1600.jpg",
"salePrice": "0.0",
"priceAmount": "18.15",
"currency": "GBP",
"merchantId": 157966,
"partnerId": 38,
"description": "Description text",
"isAdult": false,
"color": "Multi",
"availability": "in stock",
"shippingCost": "0.0",
"gender": "",
"ageGroup": null,
"feedId": 420796,
"offerHash": 3411484395,
"gtin": GTIN / EAN Number,
"size": "",
"feedId": 420796,
"expiration_date": "2025-02-20T14:22:11+02:00",
"updated_date": "2025-02-10T12:28:28+02:00"
}
],
"paginationToken": "nextPageToken"
}
Error Responses:
{
"error": "Country not found. Please provide a valid country ISO2 value"
}
{
"error": "Invalid merchant_id, feed_id, or updatedAfter timestamp"
}
Get a Product by ID
Endpoint:
GET https://api.delupe.net/api/search/products/getProduct/{Product_ID}
Description: Retrieves a product by ID.
Query Parameters:
product_id (required) – Product ID.
Notes:
Authorization: Bearer your_access_token_here
This API documentation provides details on authentication, country retrieval, merchant lookup, and product search functionalities. Let us know at gt@delupe.com if you need additional information!