NFT Search

The NFT Search API enables developers to retrieve the NFT tokens that have been minted for a specific digital asset. The API takes the Nid of the asset as input and returns the cross-network NFT records for that asset. If you are unaware of the Nid of the file, the Asset Search API can be used to find similar assets, or use the [IPFS] Get Nid endpoint to retrieve the Nid of your asset.
Capture Token is required for API authorization. If you do not already have a Capture Token yet, please follow the instruction provided to create one.
The Numbers API is a pay-as-you-go system, which means you only pay for the API calls you make. This is a cost-effective way to use the API and it allows you to control your expenses. Make sure to top up and ensure sufficient funds in your wallet in the form of Credits or NUM to cover the cost. Payment for services is processed using NUM; if you want to know how much it costs in USD, you can check CoinGecko or CoinMarketCap.
API Endpoint: https://eoprdbpm6gbec9w.m.pipedream.net
Cost: 0.01 NUM + Gas (~0.004 NUM per transaction) per API call. No Gas is required if paid with Credits.
Method: GET
Endpoint: /?nid=NID_TO_SEARCH
Description:
This API endpoint finds the NFT records associated to the provided Nid.
Authentication:
This API requires a valid token for Authorization. The token should be passed in the headers of the request using the following format: "Authorization: token YOUR_CAPTURE_TOKEN"
Headers:
- Content-Type: application/json
- Authorization: token YOUR_CAPTURE_TOKEN
Examples:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: token YOUR_CAPTURE_TOKEN" \
https://eoprdbpm6gbec9w.m.pipedream.net?nid=NID_TO_SEARCH
Response:
{
"nftRecords": list_of_NFT_records,
"nid": input_asset,
"orderID": id_of_this_order
}
A detailed explanation of the Nid can be found on the Numbers ID (Nid) page. In this example, you would replace YOUR_CAPTURE_TOKEN with your actual Capture token and NID_TO_SEARCH with the Nid of the metadata you want to cat. More examples can be found below:

Read nftRecords

Text
Description
chain_id
The ID of the NFT blockchain
contract
The contract address of the NFT token
token_id
The ID of the NFT token
asset_cids
A list of assets associated with this token
primary_marketplace
The primary marketplace of this token
current_owner
The current_owner of this NFT token
nft_spec
The spec of the NFT metadata
creator
The minter of the NFT token
created_at
The earliest of initial minting time of the NFT or the initial commit time of the digital media file in the Numbers Protocol
metadata
The metadata of this NFT token
animation_url
The animationURL associatedwith this token
image_url
The original URL of the image field of the NFT token
token_uri
The token URI of the NFT token

Support Status

Please visit the Support Status of Numbers Search Engine to check the currently supported file formats and blockchain networks.

Sample search results

{
"nftRecords": [
{
"chain_id": 1,
"contract": "0xed5af388653567af2f388e6224dc7c4b3241c544",
"asset_cids": [],
"primary_marketplace": "opensea",
"current_owner": "0x5a8cfbdb26e7429e4920668412347e0da368c5ec",
"nft_spec": "ERC721",
"creator": "0xab06f95ad1ac282f7072b4b849259eabc49eb5ba",
"created_at": "2022-01-13T02:00:38",
"metadata": {
"name": "Azuki #982",
"image": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
"attributes": [
{
"trait_type": "Type",
"value": "Human"
},
{
"trait_type": "Hair",
"value": "Brown Long"
}
]
},
"token_id": "982",
"image_url": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
"animation_url": null,
"token_uri": "https://dweb.link/ipfs/QmQFkLSQysj94s5GvTHPyzTxrawwtjgiiYS2TBLgrvw8CW/982"
},
{
"chain_id": 1,
"contract": "0x0bc040c6f7440b7b2378d4296005aff3eba81511",
"asset_cids": [
"bafybeiepger65zllufxocswogj2h3bmnb2vbcekuzhbavbex2edvdzjwja"
],
"primary_marketplace": "opensea",
"current_owner": "0xdf940f640799ccdfa74d7fc7bd72c1aebd89dc98",
"nft_spec": "erc721",
"creator": "0xdf940f640799ccdfa74d7fc7bd72c1aebd89dc98",
"created_at": "2022-04-04T04:47:26",
"metadata": {
"name": "Azuki #982",
"image": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
"attributes": [
{
"trait_type": "Type",
"value": "Human"
},
{
"trait_type": "Hair",
"value": "Brown Long"
}
]
},
"token_id": "981",
"image_url": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
"animation_url": null,
"token_uri": "https://dweb.link/ipfs/QmQFkLSQysj94s5GvTHPyzTxrawwtjgiiYS2TBLgrvw8CW/982"
}
],
"nid": "bafybeiepger65zllufxocswogj2h3bmnb2vbcekuzhbavbex2edvdzjwja",
"orderID": "b3b246a7-6266-4bd7-b8c4-c241b47cc6e5"
}