# Discover Site Structure

> Discover Site Structure is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP or x402, $1/call, status unknown (last checked 2026-09-15).

Maps a company's full site structure and returns scored, ranked URLs prioritized by commercial value such as pricing, product, careers, and case studies.

## Facts

- Endpoint: POST https://agents.bytemine.ai/functions/v1/api-gateway/company/intel/sitemap
- Price: $1/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: agents.bytemine.ai
- Website: https://agents.bytemine.ai
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-bytemine-ai-discover-site-structure-5b91f5fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o4A6YUrOdEgG2ToEE15_I

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-bytemine-ai-discover-site-structure-5b91f5fe -d '<json body>'
```

Example prompt: Can you map out the full site structure for stripe.com and give me a ranked list of their most commercially valuable pages — things like pricing, product, and case studies — filtered to only URLs containing 'pricing'?

## When to prefer this

Use this endpoint when you need a broad, scored overview of all pages on a company's website before deciding which specific pages to analyze in depth. It is the right first step in a multi-stage company research workflow — use it to discover high-value URLs, then feed those URLs into page analysis or intelligence extract endpoints. Prefer this over a full deep scan when you only need a URL map rather than page content.

## Known failure modes

- Invalid or unreachable URL returns an error or empty links array
- Limit parameter set too low may omit important pages
- Keyword search filter too narrow returns zero results
- Private or login-gated sites may return incomplete structure
- Payment failure returns 402 before any data is fetched

## How this service works

Bytemine is a B2B data platform for sales and go to market teams. It covers contact and company search across 135M professionals and 10M companies, contact and company enrichment, LinkedIn profile search and enrichment, live company intelligence read from a company's own web presence, technographics, buying intent scoring, and hiring, funding, job posting, and job change signals. Search results bill per record returned, enrichment bills only on a successful match, and count queries are free. This server is a pay-per-use, transparent proxy in front of Bytemine's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns an array of URL objects scored and ranked by commercial value (e.g. pricing, product, careers, case studies pages ranked highest), along with a total count of matched URLs. Each item in the links array represents a discovered page with its relevance scoring metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Site URL to map."
  },
  "limit": {
   "type": "integer",
   "description": "Max URLs to return. Default 100."
  },
  "search": {
   "type": "string",
   "description": "Keyword filter, only return URLs containing it."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "links": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "total": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-bytemine-ai-discover-site-structure-5b91f5fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.bytemine.ai](https://www.zero.xyz/host/agents.bytemine.ai/llms.txt)
