---
title: "Creator Store queries"
url: /docs/en-us/projects/assets/api
last_updated: 2026-06-22T22:42:14Z
description: "Creator Store Queries let you externally query the Creator Store and Marketplace Catalog."
---
# Creator Store queries
You can search Roblox's assets outside Studio by accessing the Creator Store API. Use the [Creator Store API](#creator-store-api) to query Studio assets, such as meshes, models, and audio, and the [Marketplace API](#marketplace-api) to query avatar assets on the Marketplace.
Each API requires a URL and custom search parameters for that specific catalog. If both URL and parameters are valid, the API returns a JSON format with the results of your search.
## Creator Store API
For information on making calls to the Creator Store API for search, see Toolbox Service in the [Open Cloud reference](/docs/en-us/cloud/reference/features/creator-store.md#Toolbox_SearchCreatorStoreAssets).
## Marketplace API
You can query avatar items from the Marketplace using the following URL: `https://catalog.roblox.com/v1/search/items/details?[params]`
You can replace `[params]` with the appropriate [query parameters](#query-parameters) to customize your search.
### Query parameters
You can specify search parameters by appending a series of parameters and values to the URL, each separated by a `&`.
Use the following parameters to query the Marketplace:
| Parameter | Type | Options and Values |
| --- | --- | --- |
| Category | byte | `0` = Featured
`1` = All
`2` = Collectibles
`3` = Clothing
`4` = BodyParts
`5` = Gear
`11` = Accessories
`12` = AvatarAnimations
`13` = CommunityCreations |
| CreatorType | byte | `1` = User
`2` = Group
Queries using `CreatorType` also require the `CreatorTargetId` parameter. |
| CreatorTargetId | long | The user or group ID depending on the CreatorType provided.
Queries using `CreatorTargetId` also require the `CreatorType` parameter. |
| CreatorName | string | Search by creator name. If `Enum.CreatorType` is not provided, search is for users only. |
| Cursor | string | Each search response contains a `nextPageCursor` if there is a next page and `previousPageCursor` if there is a previous page. Pass either of these values in the Cursor parameter of your next query to get the next or previous page of results. The cursor is valid if the other query parameters remain the same. |
| Genres | byte | Specifies the genre for the search. The recommended approach to filtering on genres is to match the URL of a catalog page.
`1` = TownAndCity
`2` = Medieval
`3` = SciFi
`4` = Fighting
`5` = Horror
`6` = Naval
`7` = Adventure
`8` = Sports
`9` = Comedy
`10` = Western
`11` = Military
`13` = Building
`14` = FPS
`15` = RPG |
| Keyword | string | Standard keyword search. |
| Limit | int | Number of results to return. Values are currently limited to 10, 28, and 30. |
| MaxPrice | int | The maximum price in Robux of items in the query. |
| MinPrice | int | The minimum price in Robux of items in the query. |
| SortAggregation | byte | `1` = PastDay
`3` = PastWeek
`4` = PastMonth
`5` = AllTime |
| SortType | byte | `0` = Relevance (Default)
`1` = Favorited
`2` = Sales
`3` = Updated
`4` = PriceAsc
`5` = PriceDesc |
| Subcategory | byte | `0` = Featured
`1` = All
`2` = Collectibles
`3` = Clothing
`4` = BodyParts
`5` = Gear
`9` = Hats
`10` = Faces
`12` = Shirts
`13` = TShirts
`14` = Pants
`15` = Heads
`19` = Accessories
`20` = HairAccessories
`21` = FaceAccessories
`22` = NeckAccessories
`23` = ShoulderAccessories
`24` = FrontAccessories
`25` = BackAccessories
`26` = WaistAccessories
`27` = AvatarAnimations
`37` = Bundles
`38` = AnimationBundles
`39` = EmoteAnimations
`40` = CommunityCreations
`41` = Melee
`42` = Ranged
`43` = Explosive
`44` = PowerUp
`45` = Navigation
`46` = Musical
`47` = Social
`48` = Building
`49` = Transport
`54` = HeadAccessories
`55` = ClassicTShirts
`56` = ClassicShirts
`57` = ClassicPants
`58` = TShirtAccessories
`59` = ShirtAccessories
`60` = PantsAccessories
`61` = JacketAccessories
`62` = SweaterAccessories
`63` = ShortsAccessories
`64` = ShoesBundles
`65` = DressSkirtAccessories
`66` = DynamicHeads |
The following URL will search for the first 10 "Gear" items in "Accessories" sorted by all-time ("SortAggregation") and relevance ("SortType") created by Roblox ("CreatorTargetId" and "CreatorType"):
`https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10`
### Response fields
API responses return in a JSON format. The response provides asset details in the `data` key using the following fields:
| Field | Description |
| --- | --- |
| assetType | One of the following asset type values (only returned if the item is an asset).
`2` = T-Shirt
`8` = Hat
`11` = Shirt
`12` = Pants
`17` = Head
`18` = Face
`19` = Gear
`25` = Arms
`26` = Legs
`27` = Torso
`28` = RightArm
`29` = LeftArm
`30` = LeftLeg
`31` = RightLeg
`41` = HairAccessory
`42` = FaceAccessory
`43` = NeckAccessory
`44` = ShoulderAccessory
`45` = FrontAccessory
`46` = BackAccessory
`47` = WaistAccessory
`48` = ClimbAnimation
`49` = DeathAnimation
`50` = FallAnimation
`51` = IdleAnimation
`52` = JumpAnimation
`53` = RunAnimation
`54` = SwimAnimation
`55` = WalkAnimation
`56` = PoseAnimation
`61` = EmoteAnimation |
| bundleType | The bundle type ID (only returned if the item is a bundle). Possible values are `BodyParts` and `AvatarAnimations`. |
| creatorName | The creator's name. |
| creatorTargetId | The creator's ID. |
| creatorType | The item's creator type. |
| description | The item description. |
| favoriteCount | The favorite count of an item. |
| genres | List of the item's genres. Possible values include `All`, `Tutorial`, `Scary`, `TownAndCity`, `War`, `Funny`, `Fantasy`, `Adventure`, `SciFi`, `Pirate`, `FPS`, `RPG`, `Sports`, `Ninja`, and `WildWest`. |
| id | The ID of the item. |
| itemRestrictions | List of the item's restrictions. Possible values include `ThirteenPlus`, `LimitedUnique`, `Limited`, and `Rthro`. |
| itemStatus | List of the item's status flags. Possible values include `New`, `Sale`, `XboxExclusive`, `AmazonExclusive`, `GooglePlayExclusive`, `IosExclusive`, and `SaleTimer`. |
| itemType | The item type. Possible values are `Asset` or `Bundle`. |
| lowestPrice | The lowest reseller price of the item (only returned if the item is resellable). |
| name | The item name. |
| price | The listing price of the item (current price may differ if the item is resellable). |
| priceStatus | The price status of an item that is not on sale. Possible values are `Free`, `OffSale`, or `NoResellers`. |
| purchaseCount | The purchase count of an item. |
| unitsAvailableForConsumption | The unit available for consumption of a limited unique item. |
The following is an example of expected return output for a single item:
```json
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Restless Souls Bandana",
"description":"This bandana won't help you blend in with ghosts, but at least you'll be stylish.",
"productId":41270974,
"genres":[
"Scary",
"Adventure"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}
```