Rakuten Ichiba Genre Tree — Categories, IDs & Children
Call this source with no input and it returns Rakuten Ichiba's top-level genres. Pass a genre_id and it returns that genre with its breadcrumb path and its child genres.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "rakuten_categories",
"human": "# Rakuten categories\n\n- **Genre id:** (top-level genres)\n- **Proxy traffic:** 577.4 KB\n- **Top-level genres:** 38",
"machine": {
"items": [
{
"id": 100371,
"name": "レディースファッション",
"alias": null,
"parent_category_id": 0,
"is_leaf": false,
"url": "https://www.rakuten.co.jp/category/100371/",
"breadcrumbs": [],
"children": [
{
"id": 555086,
"name": "トップス",
"alias": null,
"item_count": null,
"is_leaf": null,
"url": "https://www.rakuten.co.jp/category/555086/"
},
{
"id": 555089,
"name": "ボトムス",
"alias": null,
"item_count": null,
"is_leaf": null,
"url": "https://www.rakuten.co.jp/category/555089/"
}
]
},
{
"id": 551177,
"name": "メンズファッション",
"alias": null,
"parent_category_id": 0,
"is_leaf": false,
"url": "https://www.rakuten.co.jp/category/551177/",
"breadcrumbs": [],
"children": [
{
"id": 110765,
"name": "トップス",
"alias": null,
"item_count": null,
"is_leaf": null,
"url": "https://www.rakuten.co.jp/category/110765/"
},
{
"id": 558846,
"name": "ズボン・パンツ",
"alias": null,
"item_count": null,
"is_leaf": null,
"url": "https://www.rakuten.co.jp/category/558846/"
}
]
}
],
"proxy_traffic_bytes": 591243
},
"total_points": 5
}- You send
- Nothing for the top-level genres, or a genre_id for one genre and its children
- You get back
- Genre ID, name, parent, leaf flag, URL, breadcrumbs and child genres
- Coverage
- The Rakuten Ichiba genre tree.
- Price
- 5 pts — $5 per 1,000
- Flat 5 points per successful run, whether you ask for the top level or one genre.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Clicking through the category menu | Open each level and note the ID from the URL | Free, and slow | Fine for one genre, tedious for a full map |
| Building a scraper | Write it, host it, and repair it when Rakuten changes the category pages | Engineering time | A maintenance commitment for what is a lookup table |
| NeuralVerge | One request per level of the tree | $5 per 1,000, flat per run | One level per call; a full tree takes several calls |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
items | array | The genres returned: all top-level genres, or the one genre you asked for. |
items[].id | number | Genre ID, the value genre_id takes in Rakuten items search. |
items[].name | string | Genre name, in Japanese. |
items[].alias | string | Genre alias. Null in the sample. |
items[].parent_category_id | number | ID of the parent genre. 0 for top-level genres. |
items[].is_leaf | boolean | Whether the genre has no children. |
items[].url | string | Link to the genre's category page. |
items[].breadcrumbs | array | Path of parent genres above this one. Empty for top-level genres. |
items[].children | array | Child genres, each with id, name, alias, item_count, is_leaf and url. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
genre_id is optional. With an empty body you get the top-level genres; with a genre_id you get that genre, its breadcrumb path and its children. Use the IDs as genre_id in Rakuten items search.
curl -X POST https://api.neuralverge.ai/functions/v1/run-rakuten-categories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'What teams use it for
Where this field shows up in an actual workflow.
Find the genre_id to narrow a Rakuten items search to one category.
Map Rakuten genres to your own category scheme.
See how Rakuten divides a market before you look at its listings.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
The Rakuten Ichiba genre tree.
Read at request time.
This source returns the publicly visible category structure, stamped with a session id you can trace.
- —Genre names are in Japanese.
- —Child genres in the sample carry item_count and is_leaf as null; the response reports what the page shows.
- —Each call returns one level. Walk the tree by calling again with a child's ID.
Questions, answered
Rakuten items search accepts genre_id as a filter, and the IDs come from this source.
Related sources
Try rakuten categories on your own data
One request format across every source in the catalog.