0% found this document useful (0 votes)
110 views12 pages

UPCitemdb API Explorer

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
110 views12 pages

UPCitemdb API Explorer

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 12

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

You might also like