Add “NFT Spam Detection” FAQs

Author: benface

website/src/pages/en/token-api/faq.mdx

@@ -50,7 +50,7 @@ Yes, more blockchains will be supported in the future. Please share feedback on
 
 The Graph ecosystem is actively determining the [roadmap](https://thegraph.com/blog/token-api-the-graph/) for additional use cases. Please provide feedback on specific features you would like prioritized on [Discord](https://discord.gg/graphprotocol).
 
-## MCP / LLM / AI Topics
+## MCP / LLM / AI
 
 ### Is there a time limit for LLM queries?
 
@@ -74,6 +74,37 @@ For "ENOENT" errors, ensure Node.js 18+ is installed and the path to `npx`/`bunx
 
 No, these are optional. MCP is an advanced feature allowing AI assistants to interface with the API via streaming. For standard usage, simply call the REST endpoints with any HTTP client using your JWT. Claude Desktop, Cline bot, and Cursor IDE integrations are provided for convenience but aren't required.
 
+## NFT Spam Detection
+
+### What is NFT spam detection?
+
+NFT collections on supported chains contain a spam status field indicating whether the collection is likely spam or not spam.
+
+### How do I retrieve the spam status for a collection?
+
+See the spam_status field on the [`nft/collections/evm/{contract}`](/token-api/evm/get-nft-collections-evm-by-contract/) endpoint.
+
+### Why am I seeing "pending" spam status?
+
+There are millions of collections and we only analyze for spam on demand. If you see a pending status, query it again after 5-10 seconds and the status should be updated.
+
+### What chains contain NFT spam detection?
+
+Spam detection is currently supported for the following chains:
+
+- `mainnet`
+- `base`
+
+We are working on fine-tuning the model to enable more chains.
+
+### How is the spam status of a collection determined?
+
+We determine a collection’s spam score using a variety of features drawn from transfers data and metadata. We have several AI models that analyze these features in different ways. We then aggregate the results from the various models into a combined score, which is reported back.
+
+### How can I report an issue with a collection that was incorrectly labeled as spam or not spam?
+
+Reach out on [Discord](https://discord.gg/graphprotocol) in the Token API channel.
+
 ## Advanced Topics
 
 ### I keep seeing a smart contract with addresses like `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` and `0x000000000000000000000000000000000000`. What is this?