Product search API

API Web Service allows you to search  Discovery Japan Mall  products and view only specific categories.
 Affiliate membership registration  is required to use the API service.
The daily request limit for API Web Service is 50,000 requests.

Available API list

 Product Search API⁠ 
 Category API⁠ 
 Popular Keywords API⁠ 



Request URL

Method : GET
https://partner.discovery-japan.me/api/


Request Parameter

Parameter
Required
Type
Default
Example
Description
aff
Yes
integer
123123
Affiliate member ID
api_key
Yes
string
q
string
casio g-shock
Keyword (utf-8 encode)
tag
string
watch
keyword (utf-8 encode)
conditions
string
new
new
new - New Item
used - Used Item
refurbished - Refurbished item
category1
string
Stationery
Root category name
You can specify a category name. If specified, products in the category will be returned.
category2
string
Stationery||Writing tools
You can specify a level 2 category name. If specified, products in the category will be returned.
category3
string
Stationery||Writing tools||Color Pencil
You can specify a level 3 category name. If specified, products in the category will be returned.
brand
string
Casio
Brand name (utf-8 encode)
availability
integer
1
1
1 - in stock
2 - out of stock
jan
integer
4900669209454
Product gtin code (Gtin-13 or Gtin-8))
page
integer
5
You can specify how many pages should be displayed in the search results.
page_result
integer
20
20
If you set "5", the 5th page will be displayed. Max page result is 200.

Example Request

https://partner.discovery-japan.me/api/?aff=XXXXX&api_key=xxxxxx&q=Fashion


Response Field

Sorted by number of sales.
If the parameter does not exist, 20 top best-selling products will be displayed.
Parameter
Type
Description
Example
totalResultsAvailable
integer
Total number of search
totalResultsReturned
integer
Number of items return
firstResultPosition
integer
Number of pages (first = 1)
Hit
Name
string
Product name
Description
string
Product description
Url
string
Product URL (this url includes affiliate tracking code)
Availability
string
in stock
out of stock
in stock
Code
integer
Product Gtin coade (13 or 8 digits)
4900100100101
ProductId
integer
Product ID
1234
Image
string
Image URL
https://.....
Price
integer
product price (currency is Japanese Yen)
Category1
string
Root category
Category2
string
Category level 2
category level1 || category level 2
Category3
string
Category level 3 , Separate mark is "||"
category level1 || category level 2 || category level 3
Release
0000-00-00 00:00:00
Tag
string
Related keywords, Separate mark is "//"
tag1//tag2//tag3 ....
Conditions
string
new - New Item
used - Used Item
refurbished - Refurbished item

Example Response

<ResultSet totalResultsAvailable="34277" totalResultsReturned="20" firstResultPosition="">
<Result>
<Request>
<Query/>
</Request>
<Hit index="1">
<Name>Holbein Color Pencil 150 Colors Set</Name>
<Brand>Holbein Art Materials</Brand>
<Description>It has been tailored to meet the high demands of professionals. It is excellent in quick shooting in which necessary colors are applied one after another without touching hands. ･ 150 color pencil set (basic color) ･ Colored pencils using high-grade pigments･ Soft and molded oily colored pencils using fine pigments. Utilizing the characteristics of the soft core you can paint 3-4 colors so it is indispensable for artists. The core has a large diameter of 3.8 mm so a large area can be ..</Description>
<Url>https://partner.discovery-japan.me/products/?affID=2&pid=9324&utm_source=affiliate&utm_medium=ap_auto_link&utm_campaign=api_source</Url>
<Availability>in stock</Availability>
<Code>4900669209454</Code>
<ProductId>9324</ProductId>
<Image>https://www.discovery-japan.me/resources/upload/products/87594338.jpeg</Image>
<Price currency="JPY">31826</Price>
<Category1>Stationery</Category1>
<Category2>Stationery||Writing tools</Category2>
<Category3>Stationery||Writing tools||Color Pencil</Category3>
<Release>0000-00-00 00:00:00</Release>
<Tag>Color Pencil//color pencil color set//Colored pencil//Pencil//Color//Watercolor painting//Drawing//Artist//Holbein Art Materials//Art</Tag>
<Conditions>new</Conditions>
<mpn/>
</Hit>
<Hit index="2">
<Name>Nintendo Switch Monster Ball Plus</Name>
<Brand>Nintendo</Brand>
<Description>Monster Ball Plus is a device in the shape of a monster ballInstead of Joy-Con you can play as a controller for the Nintendo Switch software Pocket Monster Let s Go! Pikachu / Let s Go! Evey.In addition to motion operation it is equipped with a function that the lamp shines in various colors vibrates and makes a sound.When you get a Pokemon you can experience the state of the Pokemon moving in the monster ball with vibrations lamps and sounds and when the get is successful you can hear the ..</Description>
<Url>https://partner.discovery-japan.me/products/?affID=2&pid=21821&utm_source=affiliate&utm_medium=ap_auto_link&utm_campaign=api_source</Url>
<Availability>in stock</Availability>
<Code>4902370539394</Code>
<ProductId>21821</ProductId>
<Image>https://www.discovery-japan.me/resources/upload/products/61gaQl4hc5L._AC_SL1000_.jpg</Image>
<Price currency="JPY">16660</Price>
<Category1>TV Game</Category1>
<Category2>TV Game||Accessory</Category2>
<Category3>TV Game||Accessory||Nintendo Switch</Category3>
<Release>0000-00-00 00:00:00</Release>
<Tag>Poké Ball//Nintendo Switch//Nintendo//Pokemon Go Plus//Pre-order//Pokémon Center//Pokémon: Let's Go//Pikachu! and Let's Go//Eevee!</Tag>
<Conditions>new</Conditions>
<mpn/>
</Hit>
</Result>
</ResultSet>