NFT APINft Metadata Endpoints

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.
addressstring or null

String - Contract address for the queried NFT collection

namestring or null

String - NFT contract name.

symbolstring or null

String - NFT contract symbol abbreviation.

totalSupplystring or null

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

tokenTypeenum or null

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:
contractDeployerstring or null

String - Address that deployed the smart contract

deployedBlockNumberdouble or null

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

openseaMetadataobject or null

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.