Search Contract Metadata

Searches for a keyword across metadata of all ERC-721 and ERC-1155 smart contracts.

This endpoint is currently in BETA. Please report any feedback you have for this endpoint via Alchemy’s Discord.
Please note that this endpoint is only available on Ethereum, Polygon, Arbitrum, Optimism & Base networks.

Path parameters

apiKeystringRequired

Query parameters

querystringRequired

String - The search string that you want to search for in contract metadata

Response

Returns the list of NFT contracts where the metadata has one or more keywords from the search string.

addressstringOptional

String - Contract address for the queried NFT collection

namestringOptional

String - NFT contract name.

symbolstringOptional

String - NFT contract symbol abbreviation.

totalSupplystringOptional

String - Total number of NFTs in a given NFT collection.

tokenTypeenumOptional

String - For valid NFTs, ‘ERC721’ or ‘ERC1155.’ For invalid NFTs, a descriptive reason such as ‘NO_SUPPORTED_NFT_STANDARD’ if the input contract address doesn’t support a known NFT standard, or ‘NOT_A_CONTRACT’ if there is no contract deployed at the input address.

Allowed values:
contractDeployerstringOptional

String - Address that deployed the smart contract

deployedBlockNumberintegerOptional

Number - The Block Number when the deployment transaction is successfully mined

openseaMetadataobjectOptional

Note that the OpenSea metadata object is currently only available on ETH and Polygon Mainnet. Please reach out to us at [email protected] if you would like to access this data on other networks.