# Pharos Atlas network scope Pharos Atlas connects 200 specialist sources with stored representations in 10 languages and U.S. state, city, neighborhood and landmark navigation. Localized HTML and structured APIs are resource-specific. The 197 fixed English snapshots are separate purchases; coverage varies by source and route. # Pharos Atlas billing and machine access > Pharos Atlas sells immutable, source-backed trade-knowledge results for the industries that build, repair, protect and maintain the physical world: 200 specialist sources, 10 languages, U.S. location navigation. Machine access is paid per result with x402 v2 (0.01 native USDC on Base, chain eip155:8453). A purchased result can be recovered without paying again. ## Start here - OpenAPI: https://billing.pharosatlas.com/openapi.json - Resource list (x402): https://billing.pharosatlas.com/.well-known/x402 - Product catalog: https://billing.pharosatlas.com/api/x402/catalog - Rate card and payment instructions: https://billing.pharosatlas.com/.well-known/pharos-billing.json - Buying instructions and wallet checkout: https://billing.pharosatlas.com/payments - Recover a purchased result: https://billing.pharosatlas.com/api/x402/recovery ## How a purchase works 1. GET a resource URL under /api/x402/resources/ with no payment. The response is HTTP 402 with a PAYMENT-REQUIRED header carrying the exact quote. 2. Retry the same GET with a PAYMENT-SIGNATURE header authorizing exactly that quote. POST is not accepted and returns 405. 3. The 200 response is the immutable result with a PAYMENT-RESPONSE receipt and a trace id. Keep both. 4. If a result is delayed, do not pay again. Use the recovery route with the original paying wallet. ## Rights - Search and AI input: allowed. - AI training and redistribution: not granted by a purchase; a separate license is required. Contracts: https://summerall.capital/ - Content-Signal: search=yes, ai-input=yes, ai-train=no ## Network - Public answers: https://pharosatlas.com/en/ - Network directory: https://pharosatlas.info/network - Company and developers: https://pharosatlas.io/ ## Current machine purchase contract { "network_representation": { "schema": "pharos.network-representation.v1", "revision": "pharos-network-representation-20261027-v1", "publisher": "Pharos Atlas / Summerall Capital", "description": "Pharos Atlas connects 200 specialist sources with stored representations in 10 languages and U.S. state, city, neighborhood and landmark navigation. Localized HTML and structured APIs are resource-specific. The 197 fixed English snapshots are separate purchases; coverage varies by source and route.", "source_domains": 200, "registry": "https://pharosatlas.info/.well-known/pharos-network.json", "catalog": "https://pharosatlas.info/network", "language_options": [ { "id": "en", "name": "English", "native_name": "English", "html_lang": "en", "direction": "ltr" }, { "id": "es", "name": "Spanish", "native_name": "Español", "html_lang": "es", "direction": "ltr" }, { "id": "zh", "name": "Chinese (Simplified)", "native_name": "简体中文", "html_lang": "zh-Hans", "direction": "ltr" }, { "id": "fr", "name": "French", "native_name": "Français", "html_lang": "fr", "direction": "ltr" }, { "id": "de", "name": "German", "native_name": "Deutsch", "html_lang": "de", "direction": "ltr" }, { "id": "pt", "name": "Portuguese (Brazil)", "native_name": "Português", "html_lang": "pt-BR", "direction": "ltr" }, { "id": "ar", "name": "Arabic", "native_name": "العربية", "html_lang": "ar", "direction": "rtl" }, { "id": "hi", "name": "Hindi", "native_name": "हिन्दी", "html_lang": "hi", "direction": "ltr" }, { "id": "ja", "name": "Japanese", "native_name": "日本語", "html_lang": "ja", "direction": "ltr" }, { "id": "ko", "name": "Korean", "native_name": "한국어", "html_lang": "ko", "direction": "ltr" } ], "locale_contract": { "schema": "pharos.network-locale-options.v1", "default_locale": "en", "locale_ids": [ "en", "es", "zh", "fr", "de", "pt", "ar", "hi", "ja", "ko" ], "projection_authoring_language": "en", "content_model": "localized_projection", "representation_locale_does_not_determine_primary_source_language": true, "raw_geographic_source_records_translated": false, "localized_source_content": "Existing stored locale projections; non-English content may be machine-assisted and unreviewed. Consult each source provenance.", "geo_localized_fields": [ "topic_labels", "canonical_url_locale" ], "geo_preserved_fields": [ "location_ids", "location_names", "coordinates", "source_ids" ], "resource_selection": { "html": "first locale path segment", "json": "language query parameter only where documented" }, "inventory_counting": "Locale representations do not multiply the number of specialist sources or products.", "fixed_snapshot_products": { "locale": "en", "count": 197, "locale_selection_applies": false }, "provenance_paths": [ "/data/manifest.json", "/data/locations/manifest.json" ] }, "location_options": { "schema": "pharos.network-location-options.v1", "country": { "id": "US", "selectable": false }, "states": [ { "id": "alabama", "name": "Alabama" }, { "id": "alaska", "name": "Alaska" }, { "id": "arizona", "name": "Arizona" }, { "id": "arkansas", "name": "Arkansas" }, { "id": "california", "name": "California" }, { "id": "colorado", "name": "Colorado" }, { "id": "connecticut", "name": "Connecticut" }, { "id": "delaware", "name": "Delaware" }, { "id": "florida", "name": "Florida" }, { "id": "georgia", "name": "Georgia" }, { "id": "hawaii", "name": "Hawaii" }, { "id": "idaho", "name": "Idaho" }, { "id": "illinois", "name": "Illinois" }, { "id": "indiana", "name": "Indiana" }, { "id": "iowa", "name": "Iowa" }, { "id": "kansas", "name": "Kansas" }, { "id": "kentucky", "name": "Kentucky" }, { "id": "louisiana", "name": "Louisiana" }, { "id": "maine", "name": "Maine" }, { "id": "maryland", "name": "Maryland" }, { "id": "massachusetts", "name": "Massachusetts" }, { "id": "michigan", "name": "Michigan" }, { "id": "minnesota", "name": "Minnesota" }, { "id": "mississippi", "name": "Mississippi" }, { "id": "missouri", "name": "Missouri" }, { "id": "montana", "name": "Montana" }, { "id": "nebraska", "name": "Nebraska" }, { "id": "nevada", "name": "Nevada" }, { "id": "new-hampshire", "name": "New Hampshire" }, { "id": "new-jersey", "name": "New Jersey" }, { "id": "new-mexico", "name": "New Mexico" }, { "id": "new-york", "name": "New York" }, { "id": "north-carolina", "name": "North Carolina" }, { "id": "north-dakota", "name": "North Dakota" }, { "id": "ohio", "name": "Ohio" }, { "id": "oklahoma", "name": "Oklahoma" }, { "id": "oregon", "name": "Oregon" }, { "id": "pennsylvania", "name": "Pennsylvania" }, { "id": "rhode-island", "name": "Rhode Island" }, { "id": "south-carolina", "name": "South Carolina" }, { "id": "south-dakota", "name": "South Dakota" }, { "id": "tennessee", "name": "Tennessee" }, { "id": "texas", "name": "Texas" }, { "id": "utah", "name": "Utah" }, { "id": "vermont", "name": "Vermont" }, { "id": "virginia", "name": "Virginia" }, { "id": "washington", "name": "Washington" }, { "id": "west-virginia", "name": "West Virginia" }, { "id": "wisconsin", "name": "Wisconsin" }, { "id": "wyoming", "name": "Wyoming" } ], "hierarchy": [ "state", "city", "neighborhood", "landmark" ], "selection": { "state": "Exact canonical state slug from the 50-state registry; names and postal abbreviations are not selector IDs.", "deeper_levels": "Follow returned source record IDs and canonical links; IDs are preserved across locales.", "id_format": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "examples": { "state": "california", "city": "los-angeles", "neighborhood": "angelino-heights", "landmark": "griffith-park" }, "unsupported_filters": [ "country", "county", "zip", "address", "latitude", "longitude", "radius", "region", "climate" ], "region_and_climate": "Descriptive source attributes, not filters." }, "dataset": { "master_version": "pharos-master-us-2026-10-17-r1", "hierarchy_version": "places-full-us-2026-09-22-r1", "hierarchy_totals": { "states": 50, "cities": 919, "neighborhoods": 34236, "landmarks": 111226 }, "master_contextual_references": 26193, "coverage": "Pinned, uneven source inventory across 50 states. Excludes DC and territories; does not claim every US city, neighborhood or landmark." }, "html_templates": [ "/{locale}/locations", "/{locale}/locations/{state}", "/{locale}/locations/{state}/topics/{subject}", "/{locale}/locations/{state}/{city}", "/{locale}/locations/{state}/{city}/topics/{subject}", "/{locale}/locations/{state}/{city}/landmarks", "/{locale}/locations/{state}/{city}/references", "/{locale}/locations/{state}/{city}/{neighborhood}", "/{locale}/locations/{state}/{city}/{neighborhood}/landmarks", "/{locale}/locations/{state}/{city}/{neighborhood}/{subject}", "/{locale}/insights/{state}", "/{locale}/insights/{state}/{city}", "/{locale}/insights/{state}/{intent}--{subject}--{context}--{variable}-near-{landmark}-{city}" ], "json_templates": [ "/data/locations/manifest.json", "/data/locations/states.json", "/data/locations/sources.json", "/data/locations/{state}/cities.json", "/data/locations/{state}/{city}/neighborhoods.json", "/data/locations/{state}/{city}/landmarks.json", "/data/locations/{state}/{city}/{neighborhood}/landmarks.json", "/data/locations/{state}/{city}/sector-references.json" ], "query": { "allowed": [ "language", "page", "page_size" ], "language": { "enum": [ "en", "es", "zh", "fr", "de", "pt", "ar", "hi", "ja", "ko" ], "default": "en" }, "page": { "type": "integer", "minimum": 1, "maximum": 1000000, "default": 1, "format": "positive decimal without leading zeros" }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "sector_references_page_size": 50, "source_id": { "only_path": "/data/locations/sources.json", "pattern": "^r2-[a-f0-9]{16}$", "meaning": "R2 provenance-source ID, not a specialist site ID or domain" }, "duplicate_or_unknown_parameters": "400", "maximum_response_bytes": 196608, "pagination": "Follow response links.next until null. Manifest supports page 1 only." }, "html_pagination": { "collection_suffix": "/page/{page}", "collection_page_size": 96, "contextual_references_page_size": 50, "page_one": "301 redirect to the collection base", "article_pagination": false }, "availability": { "missing_record_or_page": 404, "invalid_selector_or_query": 400, "unavailable_validated_dataset": 503, "source_catalog_and_sector_references": "Master dataset only; follow returned links and availability. Contextual reference HTML requires a nonempty collection.", "source_taxonomy": "Subject, intent, context and variable slugs must belong to the selected specialist source taxonomy.", "purchase_readiness": "A route template or 402 response alone does not prove useful content is available. Invalid, missing or empty resources are not offered for purchase.", "omitted_records": "An omitted record is not evidence that a place or service does not exist." }, "provenance": { "classification": "source-declared-navigation-context", "independently_verified_local_conditions": false, "contextual_reference_relationships": [ "same-city-name", "nearby-city" ], "maximum_contextual_reference_distance_km": 25, "nearby_city_means_municipal_membership": false, "local_service_availability_asserted": false, "neighborhood_coordinate": "City reference only; no separate neighborhood coordinate is provided." }, "atlas": { "query_location_selector": false, "answer_location": "Optional text, trimmed to 80 characters in the legacy answer contract. A lowercase slug may be forwarded as state context; this does not guarantee a city, address or geospatial lookup." } }, "source_collection_coverage": { "localized_core_sources": 200, "guide_and_answer_sources": 68, "sources_without_guide_and_answer_collections": 132, "subject_facts_per_locale": 1000, "guides_per_locale": 340, "answer_records_per_locale": 1360, "evidence_scope": "Pinned source inventory and local renderer checks; not a paid-delivery audit of every resource, geography or language." }, "fixed_snapshot_collection": { "count": 197, "language": "en", "locale_options": [ "en" ], "location_options": false, "scope": "Each named JSON snapshot is a separate fixed English product. Network language and location selection do not translate or change it." }, "purchase_scope": "One exact existing resource and representation per purchase. Inspect its source, availability, MIME type, inputs and canonical quote. Missing or empty combinations are not purchase offers.", "rights": { "search": "yes", "ai_input": "yes", "ai_train": "no", "redistribution": "separate rights required" } }, "schema": "pharos.machine-resource-contract.v2", "collector": "DIRECT_CDP", "protocol": "x402 v2", "scheme": "exact", "network": "eip155:8453", "chain_id": 8453, "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6, "amount_atomic": "10000", "price_usdc": "0.01", "payTo": "0x6Ac716842c089AaeeC8B3041F8096e0823254A84", "payment_flow": "authorization", "quote_required": true, "unit": "one useful bounded immutable resource response", "route_contract": "pharos-machine-resource-v2-20261025", "hostname": "billing.pharosatlas.com", "resource_families": [ "localized-home-and-taxonomy", "localized-topic", "localized-location-collection-and-article", "localized-insight-collection-and-article", "site-manifest", "site-taxonomy", "location-data-page", "source-catalog-page", "guide-data-page", "evidence-projection", "GET /api/network-summary", "GET /api/network", "POST /api/answer", "GET /api/x402/resources/{product}", "answer-data-page" ], "formats": [ "text/html", "application/json" ], "locales": [ "en", "es", "zh", "fr", "de", "pt", "ar", "hi", "ja", "ko" ], "source_backed_specialist_sites": 200, "snapshot": "operation-pinned-source-response", "public_pages": "Explicit discovery, search metadata, robots, sitemaps, security, assets and legal paths remain public", "unsupported": "ordinary404; no settlement for unavailable, invalid or empty results", "legacy_contracts": "Existing accepted license scope, rates and entitlements remain separately enforced", "limits": { "response_bytes": 262144, "retention_days": 30, "no_results": "no charge", "pagination": "one requested page per purchase; preserve actual pagination and source schema" }, "route_origins": [ "registered-specialist-hostname", "https://pharosatlas.com", "https://pharosatlas.info", "https://billing.pharosatlas.com" ], "named_reference_locales": [ "en" ], "named_reference_scope": "A named English catalog snapshot is a distinct purchase from a specialist leaf or Atlas answer.", "supported_resource_families": [ "localized-home-and-taxonomy", "localized-topic", "localized-location-collection-and-article", "localized-insight-collection-and-article", "site-manifest", "site-taxonomy", "location-data-page", "source-catalog-page", "guide-data-page", "evidence-projection", "GET /api/network-summary", "GET /api/network", "POST /api/answer", "GET /api/x402/resources/{product}", "answer-data-page" ], "resource_families_scope": "Supported route patterns only; not a claim that every source, URL or locale has an available result.", "source_route_availability": { "scope": "bounded_network_source_contract_inventory", "catalog_revision": "pharos-network-source-discovery-v1-20261026", "specialist_sources": 200, "available_family_source_counts": { "manifest": 200, "taxonomy": 200, "location-data-manifest": 200, "location-data-sources": 200, "location-data-states": 200, "localized-topic": 200, "guide-data": 68, "answer-data": 68, "localized-location": 1 }, "withheld_family_source_counts": { "evidence-projection": 200, "guide-data": 132, "answer-data": 132 }, "evidence_scope": "Counts describe sources with validated examples or known withheld resources in the existing source catalog. They are not exhaustive URL, geography, locale or paid-delivery verification. Inspect each source contract and exact resource quote." }, "enabled": true, "processor": "DIRECT_CDP", "availability": "inspect_the_requested_resource_quote", "discovery_revision": "pharos-machine-discovery-20261026-v2", "discovery": "https://billing.pharosatlas.com/.well-known/pharos-billing.json", "documentation": "https://billing.pharosatlas.com/payments", "headers": { "challenge": "PAYMENT-REQUIRED", "authorization": "PAYMENT-SIGNATURE", "receipt": "PAYMENT-RESPONSE" }, "recovery": { "url": "https://billing.pharosatlas.com/api/x402/recovery", "authentication": "sign-in-with-x", "minimum_retention_days": 30, "new_payment_required": false }, "purchased_resource_rights": { "allowed_use": "internal reference and retrieval of the original purchased result", "training": "not_granted", "redistribution": "not_granted", "sublicensing": "not_granted", "existing_agreements": "retain_their_accepted_scope" }, "public_metadata": "Public documentation, search previews and discovery do not establish entitlement to protected output." } Inspect the exact resource URL for its canonical PAYMENT-REQUIRED quote before signing. Machine requests use x402 v2 and a customer-owned wallet; a browser checkout is optional. Paid output retains the resource MIME type and original schema. Existing contract terms and public publishing permissions remain separate from the purchased unit.