Search Engine API

The Numbers Search Engine API, powered by AI technology, allows developers to easily locate and retrieve the exact match or similar assets/NFTs of their input content. The API returns the content information, marketplaces, and NFT history across supported blockchains, providing a comprehensive view of the digital asset.

Step 1: Get Capture Token

Authorization to access APIs requires a valid Capture Token. If you do not already have a Capture Token yet, please follow the instruction provided to create one.

Step 2: Search Assets

Follow the instruction to use Asset Search API or check the sample call below:

Sample API call:

curl -F "file=@/tmp/MYFILE.png" \
     -H "Authorization: token YOUR_CAPTURE_TOKEN" \
     "https://eoo9pxiv5yxg0za.m.pipedream.net"

Sample response:

{
  "preciseSearch": "",
  "similarSearch": {
    "nids": [
      "bafybeicbrotfsby2lr4iiirsthp4k237we4z44kflj2fzecirsmrbels4a",
      "bafybeibgyvx6yo67cv4bcvojhaeick5davts7m26vubi2bdiq332qlk2lq",
      "bafybeid6e7ovy4tloatuby2ytbxcnu4zbkuobuwb7ilych6ylunkegjwom",
      "bafybeigiyknc5yu7qizbsdq5jg6ekfgwnticxpdvreejkwa4o4kltlky4q",
      "bafkreifxht4knprypq43ogxbnv2ycomymbwncylryzhc5rofutb57cn6te",
      "bafybeieje5f7jrntvj2jukmz7bk2ubi4v42wc7wfa6psxyxztgbt47dnyy",
      "bafybeibqbsljevulf34mcwxuvdjh2pknzx7oq6wg2dqm3dmd57yym3lvqe",
      "bafybeicip4fxeztaayz5dq2v42feqvuaoeusvvg56eoetog75j3rlfgztm",
      "bafybeiefcrxgo4imoxxmz74kq2dteef24opvzlc46txwbzbe2rw7hrpawy",
      "bafkreidh6voef75jqcbkvaihcna3wa3npsozuwdzewyszvgz7lkmexarju"
    ],
    "distance": [
      0.11057454300000003,
      0.12315458099999999,
      0.12348419399999999,
      0.12365567700000002,
      0.12413579200000002,
      0.12688589100000003,
      0.12708240699999995,
      0.12724828700000002,
      0.12862664499999998,
      0.12946111000000005
    ]
  },
  "orderID": "24aa0d37-0fa5-4613-b5fe-af1e6b2e14a9"
}

If the preciseSearch shows empty, meaning the asset has not yet been registered before. In general, a distance less than 0.12 means that AI model identified the images are really similar. If the distance between the result nid and your original asset is less than 0.12, it is very likely they are the same assets but one being modified slightly.

Step 3: Get NFT Details

Get NFT tokens associated with the asset.

Sample API Call

curl -X GET -H "Content-Type: application/json" \
            -H "Authorization: token YOUR_CAPTURE_TOKEN" \
            https://eoprdbpm6gbec9w.m.pipedream.net?nid=NID_TO_SEARCH

Sample Response

See this page for the sample response.

Last updated