Trendyol

Top Rankings

Trendyol's own category leaderboards — best sellers, most viewed, most favourited or most rated — with each product's rank, price, rating and seller.

GET/v1/trendyol/top-rankings1 credit

Getting every page

This endpoint pages. To collect all of it in one job, queue a batch task instead of walking the pages yourself — it charges the same 1 credit per page and you poll for the result.

curl --request POST 'https://data-api.roketfy.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "trendyol",
  "endpoint": "top-rankings",
  "params": {
    "categoryId": "<categoryId>"
  }
}'

See batch tasks for the full lifecycle.

Parameters

Name	Type	Required	Description
categoryId	number	required	Trendyol category id, e.g. 27 for Aksesuar. Required — rankings are per category.
rankingType	string	optional	Which leaderboard: bestSeller = most sold, topViewed = most viewed, mostFavourite = most favourited, mostRated = most reviewed. One of: bestSeller, topViewed, mostFavourite, mostRated.
page	number	optional	One-based page number — this gateway starts at 1, not 0.
pageSize	number	optional	Products per page, 1-100.
webGenderId	number	optional	Trendyol's gender segment for the category, taken from the storefront's own category link (2 on the women's Aksesuar page). Leave it out for the unsegmented ranking.

Request

curl --request GET 'https://data-api.roketfy.com/v1/trendyol/top-rankings?categoryId=%3CcategoryId%3E' \
  --header 'Authorization: Bearer YOUR_TOKEN'

MCP

Available to AI agents as the tool trendyol_top_rankings, with the same parameters and the same credit cost.