UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Lookup by HTTP GET

/trial/lookup

Parameters 

string UPC, ISBN or EAN

Test this endpoint 

application/json

Response Messages 

INVALID_QUERY: missing required parameters

NOT_FOUND: no match was found

EXCEED_LIMIT: exceed request limit

SERVER_ERR: internal server error

1 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

other errors

Response Sample 

{
"code": "OK",
"total": 1,
"offset": 0,
"items": [
{
"ean": "0885909950805",
"title": "Apple iPhone 6, Space Gray, 64 GB (T-Mobile)",
"upc": "885909950805",
"gtin": "string",
"asin": "B00NQGOZV0",
"description": "iPhone 6 isn't just bigger - it's better...",
"brand": "Apple",
"model": "MG5A2LL/A",
"dimension": "string",
"weight": "string",
"category": "Electronics > Communications > Telephony > Mobile Phones > Unlocked Mobile P
hones",
"currency": "string",
"lowest_recorded_price": 3.79,
"highest_recorded_price": 8500,
"images": [
"http://img1.r10.io/PIC/112231913/0/1/250/112231913.jpg"
],
"offers": [
{
"merchant": "Newegg.com",
"domain": "newegg.com",
"title": "Apple iPhone 6 64GB T-Mobile Space Gray MG5A2LL/A",
"currency": "string",
"list_price": 0,
"price": 1200,
"shipping": "Free Shipping",
"condition": "New",
"availability": "Out of Stock",
"link": "https://www.upcitemdb.com/norob/alink/?id=v2p2...",
"updated_t": 1479243029
}
]
}
]
}

Response Schema 

2 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Lookup by HTTP POST

/trial/lookup

Parameters 

application/json

LookupRequest UPC lookup request body

Test this endpoint 

application/json

Response Messages 

INVALID_QUERY: missing required parameters

NOT_FOUND: no match was found

EXCEED_LIMIT: exceed request limit

3 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

SERVER_ERR: internal server error

other errors

Response Sample 

{
"code": "OK",
"total": 1,
"offset": 0,
"items": [
{
"ean": "0885909950805",
"title": "Apple iPhone 6, Space Gray, 64 GB (T-Mobile)",
"upc": "885909950805",
"gtin": "string",
"asin": "B00NQGOZV0",
"description": "iPhone 6 isn't just bigger - it's better...",
"brand": "Apple",
"model": "MG5A2LL/A",
"dimension": "string",
"weight": "string",
"category": "Electronics > Communications > Telephony > Mobile Phones > Unlocked Mobile P
hones",
"currency": "string",
"lowest_recorded_price": 3.79,
"highest_recorded_price": 8500,
"images": [
"http://img1.r10.io/PIC/112231913/0/1/250/112231913.jpg"
],
"offers": [
{
"merchant": "Newegg.com",
"domain": "newegg.com",
"title": "Apple iPhone 6 64GB T-Mobile Space Gray MG5A2LL/A",
"currency": "string",
"list_price": 0,
"price": 1200,
"shipping": "Free Shipping",
"condition": "New",
"availability": "Out of Stock",
"link": "https://www.upcitemdb.com/norob/alink/?id=v2p2...",
"updated_t": 1479243029
}
]
}
]
}

4 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Response Schema 

Body Sample 

{
"upc": "string"
}

Body Schema 

Search by HTTP GET

/trial/search

Parameters 

string search keywords, ex. 'iphone 6'

string search brand name, ex. 'apple'

5 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

string product category keyword, ex. 'phones'

string product title, ex. '64gb'

string model number, ex. 'MG5A2LL'

number offset for result paging. '0' indicates no more

1 (default)

number 1: strict mode, match all search keywords; 0: find best matches if no match for the whole phrase

product (default)

string item type

6 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Test this endpoint 

application/json

Response Messages 

INVALID_QUERY: missing required parameters

NOT_FOUND: no match was found

EXCEED_LIMIT: exceed request limit

SERVER_ERR: internal server error

other errors

Response Sample 

7 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

{API REFERENCE: SEARCH BY HTTP GET 

"code": "OK",
"total": 1,
"offset": 0,
"items": [
{
"ean": "0885909950805",
"title": "Apple iPhone 6, Space Gray, 64 GB (T-Mobile)",
"upc": "885909950805",
"gtin": "string",
"asin": "B00NQGOZV0",
"description": "iPhone 6 isn't just bigger - it's better...",
"brand": "Apple",
"model": "MG5A2LL/A",
"dimension": "string",
"weight": "string",
"category": "Electronics > Communications > Telephony > Mobile Phones > Unlocked Mobile P
hones",
"currency": "string",
"lowest_recorded_price": 3.79,
"highest_recorded_price": 8500,
"images": [
"http://img1.r10.io/PIC/112231913/0/1/250/112231913.jpg"
],
"offers": [
{
"merchant": "Newegg.com",
"domain": "newegg.com",
"title": "Apple iPhone 6 64GB T-Mobile Space Gray MG5A2LL/A",
"currency": "string",
"list_price": 0,
"price": 1200,
"shipping": "Free Shipping",
"condition": "New",
"availability": "Out of Stock",
"link": "https://www.upcitemdb.com/norob/alink/?id=v2p2...",
"updated_t": 1479243029
}
]
}
]
}

Response Schema 

8 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Search by HTTP POST

/trial/search

Parameters 

application/json

SearchRequest

Test this endpoint 

application/json

Response Messages 

INVALID_QUERY: missing required parameters

NOT_FOUND: no match was found

EXCEED_LIMIT: exceed request limit

SERVER_ERR: internal server error

9 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

other errors

Response Sample 

{
"code": "OK",
"total": 1,
"offset": 0,
"items": [
{
"ean": "0885909950805",
"title": "Apple iPhone 6, Space Gray, 64 GB (T-Mobile)",
"upc": "885909950805",
"gtin": "string",
"asin": "B00NQGOZV0",
"description": "iPhone 6 isn't just bigger - it's better...",
"brand": "Apple",
"model": "MG5A2LL/A",
"dimension": "string",
"weight": "string",
"category": "Electronics > Communications > Telephony > Mobile Phones > Unlocked Mobile P
hones",
"currency": "string",
"lowest_recorded_price": 3.79,
"highest_recorded_price": 8500,
"images": [
"http://img1.r10.io/PIC/112231913/0/1/250/112231913.jpg"
],
"offers": [
{
"merchant": "Newegg.com",
"domain": "newegg.com",
"title": "Apple iPhone 6 64GB T-Mobile Space Gray MG5A2LL/A",
"currency": "string",
"list_price": 0,
"price": 1200,
"shipping": "Free Shipping",
"condition": "New",
"availability": "Out of Stock",
"link": "https://www.upcitemdb.com/norob/alink/?id=v2p2...",
"updated_t": 1479243029
}
]
}
]
}

Response Schema 

10 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

Body Sample 

{
"s": "iphone 6",
"type": "product",
"offset": 0,
"match_mode": 1,
"filter": {
"brand": "apple",
"category": "phones",
"title": "64gb",
"model": "mg5a2ll"
}
}

Body Schema 

11 of 12 12/6/24, 06:55
UPCitemdb API Explorer https://www.upcitemdb.com/api/explorer#!/search/get_trial_...

API REFERENCE: SEARCH BY HTTP GET 

12 of 12 12/6/24, 06:55