Supply chain data for AI agents and developers
Programmatic access to BeamFlow’s supply chain verification index. Verify ads.txt health, check SSP authorization, and audit sellers.json across 362K+ indexed domains and 2,000+ sellers.json files.
Test it in 30 seconds
Get your free API key, run one curl, see real supply chain data.
Get your API key
Create a free account → Profile → Generate API key. Free tier: 20 req/day.
Run this command
Replace the key below and paste into your terminal.
See real data
Instant results for 362K+ pre-crawled domains. No crawl triggered.
curl "https://beamflow.co/api/v1/verify?domain=nytimes.com&type=ads_txt" \
-H "Authorization: Bearer bf_live_••••••••••••••••"
# Response: { "success": true, "data": { "healthScore": 91, "healthGrade": "A", ... } }Three tools. One index.
Each endpoint queries BeamFlow’s live data, the same index powering the publisher and SSP dashboards. Results are instant. No separate crawl triggered on your request.
verify_domainGET /api/v1/verifyReturns a domain's ads.txt or app-ads.txt health score (0–100), letter grade, and verification counts. Use "both" to get a combined analysis with per-file breakdowns. Cross-references against 2,000+ live sellers.json files.
Parameters
domainstringrequiredPublisher domain to verify (e.g., "example.com")typestringrequired"ads_txt", "app_ads_txt", or "both"Example response
{
"domain": "example.com",
"fileType": "ads_txt",
"healthScore": 72,
"healthGrade": "C",
"totalRecords": 184,
"verifiedRecords": 133,
"errorCount": 10,
"mismatchCount": 18,
"unverifiedIdCount": 23,
"defunctSspCount": 3,
"duplicateRecords": 4,
"dataSource": "cached",
"lastUpdated": "2026-03-01T08:15:00Z"
}Works from anywhere
Standard HTTP with Bearer token auth. No SDKs required. Responses are consistent JSON across all three endpoints.
- Bearer token authentication, one key per account
- JSON responses with typed fields and ISO 8601 timestamps
- Standard HTTP status codes (200, 401, 404, 429)
- X-RateLimit headers on every response
- CORS enabled for browser-side requests
Base URL
https://beamflow.co/api/v1# Verify ads.txt
curl -X GET \
"https://beamflow.co/api/v1/verify?domain=example.com&type=ads_txt" \
-H "Authorization: Bearer bf_live_••••••••••••••••"
# Verify app-ads.txt
curl -X GET \
"https://beamflow.co/api/v1/verify?domain=example.com&type=app_ads_txt" \
-H "Authorization: Bearer bf_live_••••••••••••••••"
# Combined analysis (ads.txt + app-ads.txt)
curl -X GET \
"https://beamflow.co/api/v1/verify?domain=example.com&type=both" \
-H "Authorization: Bearer bf_live_••••••••••••••••"{
"mcpServers": {
"beamflow": {
"url": "https://beamflow.co/api/mcp?key=YOUR_API_KEY"
}
}
}
// Get your API key: https://beamflow.co/login → Settings → API KeysAdd this to your claude_desktop_config.json or any MCP-compatible client config. The ?key= param handles authentication without requiring custom headers.
Works with Claude and any MCP client
BeamFlow exposes its three tools as a Model Context Protocol server. Any MCP-compatible agent can call verify_domain, check_authorization, and get_ssp_health directly, no custom parsing needed.
Claude Desktop / Claude Code
Paste the config into Settings → MCP. Three tools appear instantly — no setup code needed.
Other MCP clients
Any client implementing the open MCP spec works without modification.
Custom agents
Point your agent at the MCP endpoint with your API key. Fully self-contained.
What developers are building with it
The API gives you a query interface into BeamFlow’s live data. A few patterns we’ve seen.
AI supply chain agents
Give your LLM agent real-time verification data via MCP. Let it answer "Does cnn.com authorize Google as DIRECT?" without a custom scraper.
Pre-bid SSP verification
Call check_authorization in your DSP or SSP workflow before placing bids on unverified supply paths. Add a verification gate at integration time.
Supply chain dashboards
Pull health scores and verification stats into your internal reporting stack. Visualize supply chain health across your publisher portfolio without manual scanning.
SSP competitive monitoring
Poll get_ssp_health on a schedule to track sellers.json quality across competing SSPs. Alert your team when a competitor's verification rate shifts.
Publisher onboarding checks
Validate a publisher's ads.txt health before adding them as supply. Surface verification issues before they affect your buyers, not after.
Custom alerting pipelines
Poll the API on your schedule, diff the results, and route alerts to Slack, PagerDuty, or your ops system. Same data that powers BeamFlow alerts.
Start free. Scale when you need to.
Your API key is linked to your BeamFlow account. The free tier covers integration and low-volume use. Starter includes API access alongside the full publisher dashboard.
Free
No credit card required
- 20 requests / day
- All 3 endpoints
- Standard JSON responses
- Rate limit headers
Starter
API included with publisher plan
- 500 requests / day
- All 3 endpoints
- Full dashboard access
- Monitoring & email alerts
- ads.txt management
Enterprise
Volume + SLA
- Unlimited requests
- All 3 endpoints
- Custom rate limits
- SLA guarantee
- Dedicated support
All plans query the same index. 362K+ domains, updated continuously. See full pricing
Your API key is one login away
Create a free account. Generate your key in your profile. 20 requests/day, no credit card. Need more? Starter is $49/mo and includes API access alongside the full publisher dashboard.
API questions? Contact us