---
title: "Search NFT collection traits"
method: GET
path: "/v0.1/items/traits/search"
tags: ["Search API"]
---

# Search NFT collection traits

`GET /v0.1/items/traits/search`

## Request

- Base URL: `https://api.rarible.org`
- URL: `https://api.rarible.org/v0.1/items/traits/search`
- Auth: API key in header `X-API-KEY`

Returns aggregation of existing traits for specified collections with counter for each trait type/value.\  This is full-text-search, where you can specify filter for trait keys not precisely\  (for example, results `back` filter include `Background` trait)

## Query parameters

- `filter` string, required
- `collectionIds` string[], required
- `owners` string[]

## Response `200`

OK

- Traits
  - `continuation` string: Continuation token to paginate traits search result
  - `traits` Trait[], required: List of found traits
    - `key` TraitEntry, required: Combination of Item attribute key/value with it's count
      - `value` string, required
      - `count` integer, required
    - `values` TraitEntry[], required
      - `value` string, required
      - `count` integer, required

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api.md) - [All operations](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/revisions/5d2651b9411d?raw)