OpenSea API endpoint
Runs a keyword search scoped to one collection — matching on item name and trait values — and returns the hits with rarity rank and best standing listing. Narrower than `/opensea/collection/{slug}/items`, which lists everything.
/opensea/collection/{slug}/search-itemsPath parameters:
slug (required): the OpenSea collection slug, e.g. boredapeyachtclubQuery parameters:
query (required): the search keyword, e.g. goldlimit (optional): results per page, 1-100, default 20A query with no matches returns an empty items list, not a 404.
| Field | In the sample | Value in the sample |
|---|---|---|
| slug | Has a value | |
| query | Has a value | “gold” |
| items | Empty |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | OpenSea collection slug | boredapeyachtclub | |
| query | string | Yes | Search keyword | gold | |
| limit | integer | No | Results per page, 1-100 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/boredapeyachtclub/search-items?query=gold&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "boredapeyachtclub",
"query": "gold",
"items": [
{
"id": "5a1d9b8101cf3a2e8c8ce2d2e5a8e2ba",
"token_id": "73",
"name": "#73",
"image_url": "https://i2c.seadn.io/ethereum/abc.png",
"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"chain": "ethereum",
"rarity_rank": 11,
"best_listing": {
"amount": 180,
"currency": "ETH",
"usd": 442290
},
"marketplace": "opensea"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/opensea.itemSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.ItemSearchResponse | No | ||||
| data.items | array | No | Item record, 39 fields: best_listing, best_offer, chain, collection_name, collection_slug, contract_address, created_at, description, id, image_url, is_fungible, last_sale and 7 more. Described under Get a single OpenSea NFT API. | |||
| data.query | string | No | gold | |||
| data.slug | string | No | boredapeyachtclub | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/boredapeyachtclub/search-items?query=gold&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"