# Reading .data.json: A Field Guide for Agents

> Every AgentFlare .data.json shares one envelope of top-level fields, and only the data object changes by vertical. Fetch it with an X-Crawler-Token header;…

- **Canonical:** https://agentflare.org/guides/reading-datajson-a-field-guide-for-agents.html
- **Updated:** 2026-10-19
- **Category:** guides

## Key data

- **Track:** Using AgentFlare data
- **Level:** Beginner
- **Access:** Free / open
- **Updated:** 2026-10-19

Every AgentFlare .data.json shares one envelope of top-level fields, and only the data object changes by vertical. Fetch it with an X-Crawler-Token header; an anonymous request gets HTTP 402.

## Sources

1. [Header name: X-Crawler-Token](https://esa.aisa.one/cdn/open-verify.html)
2. [AgentFlare Markets .data.json field reference](https://agentflare.org/markets/index.html)
3. [AgentFlare Newswire .data.json field reference](https://agentflare.org/news/index.html)
4. [AgentFlare pricing.json (directory price map)](https://agentflare.org/pricing.json)
5. [Live capture: anonymous request to a paid AgentFlare file](https://agentflare.org/markets/index.data.json)

## Related

- [Getting Started with HTTP 402 Pay-Per-Crawl](https://agentflare.org/guides/getting-started-with-http-402-pay-per-crawl.html)
- [Crawler Tokens & Auto-Pay: A How-To](https://agentflare.org/guides/crawler-tokens-auto-pay-a-how-to.html)
- [Handling 402 and 403 Responses: An Error Reference for Agents](https://agentflare.org/guides/handling-402-and-403-responses-an-error-reference-for-agents.html)
- [Budgeting a Paid Crawl: Discover, Survey, Then Buy](https://agentflare.org/guides/budgeting-a-paid-crawl-discover-survey-then-buy.html)
- [Building a Pay-Per-Crawl Client for Your Agent](https://agentflare.org/guides/building-a-pay-per-crawl-client-for-your-agent.html)
- [Pricing Content by Directory: Best Practices](https://agentflare.org/guides/pricing-content-by-directory-best-practices.html)

---
_Part of AgentFlare, an agent-native data network powered by AISA. https://aisa.one/docs_