E-commerce & Marketplaces
Trendyol Categories — Department Tree, IDs & Aliases
This source returns the Trendyol category tree: 10 departments with nested subcategories, each with id, name, alias, parent category ID and URL. Pass a category ID or alias to get just that subtree.
Example response
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "trendyol_categories",
"category": null,
"human": "# Trendyol categories\n\n- **Category filter:** (none - full tree)\n- **Categories returned:** 1141\n- **Proxy traffic:** 698.0 KB",
"machine": {
"total_items": 10,
"first_item": {
"id": "1",
"name": "Kadın",
"alias": "kadin",
"parent_category_id": null,
"url": "https://www.trendyol.com/butik/liste/1/kadin",
"image": null,
"children": [
{
"id": "82",
"name": "Giyim",
"alias": "kadin-giyim",
"parent_category_id": "1",
"url": "https://www.trendyol.com/kadin-giyim-x-g1-c82",
"image": null,
"children": [
{
"id": "56",
"name": "Elbise",
"alias": "elbise",
"parent_category_id": "82",
"url": "https://www.trendyol.com/elbise-x-c56",
"image": null,
"children": []
},
{
"id": "73",
"name": "Tişört",
"alias": "kadin-t-shirt",
"parent_category_id": "82",
"url": "https://www.trendyol.com/kadin-t-shirt-x-g1-c73",
"image": null,
"children": []
}
]
},
{
"id": "114",
"name": "Ayakkabı",
"alias": "kadin-ayakkabi",
"parent_category_id": "1",
"url": "https://www.trendyol.com/kadin-ayakkabi-x-g1-c114",
"image": null,
"children": [
{
"id": "107",
"name": "Topuklu Ayakkabı",
"alias": "kadin-topuklu-ayakkabi",
"parent_category_id": "114",
"url": "https://www.trendyol.com/kadin-topuklu-ayakkabi-x-g1-c107",
"image": null,
"children": []
},
{
"id": "1172",
"name": "Sneaker",
"alias": "kadin-sneaker",
"parent_category_id": "114",
"url": "https://www.trendyol.com/kadin-sneaker-x-g1-c1172",
"image": null,
"children": []
}
]
}
]
},
"items": [
{
"id": "1",
"name": "Kadın",
"alias": "kadin",
"parent_category_id": null,
"url": "https://www.trendyol.com/butik/liste/1/kadin",
"image": null,
"children": [
{
"id": "82",
"name": "Giyim",
"alias": "kadin-giyim",
"parent_category_id": "1",
"url": "https://www.trendyol.com/kadin-giyim-x-g1-c82",
"image": null,
"children": [
{
"id": "56",
"name": "Elbise",
"alias": "elbise",
"parent_category_id": "82",
"url": "https://www.trendyol.com/elbise-x-c56",
"image": null,
"children": []
},
{
"id": "73",
"name": "Tişört",
"alias": "kadin-t-shirt",
"parent_category_id": "82",
"url": "https://www.trendyol.com/kadin-t-shirt-x-g1-c73",
"image": null,
"children": []
}
]
},
{
"id": "114",
"name": "Ayakkabı",
"alias": "kadin-ayakkabi",
"parent_category_id": "1",
"url": "https://www.trendyol.com/kadin-ayakkabi-x-g1-c114",
"image": null,
"children": [
{
"id": "107",
"name": "Topuklu Ayakkabı",
"alias": "kadin-topuklu-ayakkabi",
"parent_category_id": "114",
"url": "https://www.trendyol.com/kadin-topuklu-ayakkabi-x-g1-c107",
"image": null,
"children": []
},
{
"id": "1172",
"name": "Sneaker",
"alias": "kadin-sneaker",
"parent_category_id": "114",
"url": "https://www.trendyol.com/kadin-sneaker-x-g1-c1172",
"image": null,
"children": []
}
]
}
]
},
{
"id": "2",
"name": "Erkek",
"alias": "erkek",
"parent_category_id": null,
"url": "https://www.trendyol.com/butik/liste/2/erkek",
"image": null,
"children": [
{
"id": "82",
"name": "Giyim",
"alias": "erkek-giyim",
"parent_category_id": "2",
"url": "https://www.trendyol.com/erkek-giyim-x-g2-c82",
"image": null,
"children": [
{
"id": "73",
"name": "Tişört",
"alias": "erkek-t-shirt",
"parent_category_id": "82",
"url": "https://www.trendyol.com/erkek-t-shirt-x-g2-c73",
"image": null,
"children": []
},
{
"id": "119",
"name": "Şort",
"alias": "erkek-sort",
"parent_category_id": "82",
"url": "https://www.trendyol.com/erkek-sort-x-g2-c119",
"image": null,
"children": []
}
]
},
{
"id": "114",
"name": "Ayakkabı",
"alias": "erkek-ayakkabi",
"parent_category_id": "2",
"url": "https://www.trendyol.com/erkek-ayakkabi-x-g2-c114",
"image": null,
"children": [
{
"id": "109",
"name": "Spor Ayakkabı",
"alias": "erkek-spor-ayakkabi",
"parent_category_id": "114",
"url": "https://www.trendyol.com/erkek-spor-ayakkabi-x-g2-c109",
"image": null,
"children": []
},
{
"id": "1352",
"name": "Günlük Ayakkabı",
"alias": "erkek-gunluk-ayakkabi",
"parent_category_id": "114",
"url": "https://www.trendyol.com/erkek-gunluk-ayakkabi-x-g2-c1352",
"image": null,
"children": []
}
]
}
]
}
],
"proxy_traffic_bytes": 714705
},
"total_points": 5
}- You send
- Optionally, a Trendyol category ID or alias; leave empty for the full tree
- You get back
- Departments and nested subcategories with id, name, alias, parent category ID and URL
- Coverage
- Trendyol.com's public category structure.
- Price
- 5 points per run — $5 per 1,000
- Priced at 5 points as listed in the docs. The docs describe it as per returned record, while the sample run billed 5 points in total; check the app for the exact charge on a full-tree run.
Comparison
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Checking the site by hand | Click through the department menus | Free, and slow | Fine for one branch, tedious for the full map |
| Building a scraper | Write it, host it, and repair it when Trendyol changes its navigation | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, optional category as a parameter | $5 per 1,000 points as listed | Category names are Turkish, as the site shows them |
Response
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | Number of top-level departments returned. |
first_item | object | A copy of the first department, for quick access. |
id | string | Category ID. |
name | string | Category name (Turkish). |
alias | string | URL alias of the category. |
parent_category_id | string | ID of the parent category; null for departments. |
url | string | Direct link to the category page. |
image | string | Category image URL; null when absent. |
children | array | Nested child categories with the same fields. |
Integration
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
category is optional: leave it empty for the full tree, or pass an ID or alias (such as elektronik) to get just that subtree.
curl -X POST https://api.neuralverge.ai/functions/v1/run-trendyol-categories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "category": "elektronik" }'Use cases
What teams use it for
Where this field shows up in an actual workflow.
Finding category IDs
Look up the IDs and aliases behind department names.
Taxonomy mapping
Map Trendyol's departments against your own category structure.
Assortment scoping
See which subcategories sit under a department before choosing what to monitor.
Building category URLs
Turn category names into canonical URLs for later work.
Coverage & limits
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Coverage
Trendyol.com's public category structure.
Freshness
Read at request time.
Handling
This source returns publicly visible information, stamped with the input it was read from and a session id you can trace.
What it will not do
- —The tree reflects the site at request time; categories get added and renamed.
- —Names are Turkish as the site shows them.
- —The same subcategory name can appear under several departments with different IDs.
FAQ
Questions, answered
No. Leave it empty for the full tree, or pass an ID or alias to narrow it.
Related
Related sources
Try trendyol categories on your own data
One request format across every source in the catalog.