Agentic Endpoints Reach API

openapi: 3.2.0
info:
  title: agentic-endpoints Reach API
  version: 1.0.0
  license:
    name: MIT
    identifier: MIT
  description: 'Pay-per-call utilities for autonomous agents. No signup, no API keys, no invoices: every endpoint answers HTTP 402 with a price and serves the request once payment is signed.'
servers:
- url: https://agentic-endpoints.com
tags:
- name: Reach
paths:
  /reach:
    post:
      summary: Can agents reach this URL?
      description: Can agents reach this URL? Sends one GET as each of nine common clients (curl, node, Python urllib, Python requests, libwww-perl, a browser, GPTBot, ClaudeBot, Googlebot) and reports which are refused and why, plus robots.txt AI-crawler blocks, /llms.txt and the http-to-https redirect. Read-only.. Costs $0.010, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: reach
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  description: Public HTTP(S) URL to check. Private and loopback addresses are refused, not fetched.
              required:
              - url
            example:
              url: https://example.com/
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: ok
                url: https://example.com/
                verdict: shadowed
                summary: 'example.com answered 7 of 9 clients but refused python-urllib, libwww-perl: Cloudflare Browser Integrity Check (or a User Agent Blocking rule) refused this User-Agent string.'
                clients:
                - client: curl
                  status: 200
                  reached: true
                - client: python-urllib
                  status: 403
                  reached: false
                  edge_refusal:
                    code: '1010'
                robots_txt:
                  status: 200
                  blocks_ai_crawlers: []
                llms_txt:
                  present: true
                  status: 200
                http_redirect:
                  status: 308
                  preserves_post: true
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Reach
  /reach/report:
    post:
      summary: 'Full reachability report for one site, up to 20 pages: every page checked from…'
      description: 'Full reachability report for one site, up to 20 pages: every page checked from nine common clients, the likely cause of each refusal (Cloudflare 1010, firewall rule, bot challenge, origin server, AI-crawler block, POST-dropping redirect, missing llms.txt) with the exact fix and a curl that reproduces it, a prioritised fix list, a private report page, and 3 free re-scans within 30 days compared before and after.. Costs $69.00, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.'
      operationId: reach_report
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                urls:
                  type: array
                  items:
                    type: string
                  description: 1 to 20 public HTTP(S) URLs on one site (at most 3 hostnames)
              required:
              - urls
            example:
              urls:
              - https://example.com/
              - https://example.com/api/door
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: accepted
                report_id: 3f2a9c1e5b7d4e8a9c217d4e5f6a8b90
                report_url: https://agentic-endpoints.com/reach/report/3f2a9c1e5b7d4e8a9c217d4e5f6a8b90
                pages: 2
                eta_seconds: 35
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Reach
components:
  schemas:
    PaymentRequired:
      type: object
      description: Body of a 402. Every field is derived from the same challenge the caller is asked to sign, so it cannot quote a different price or recipient.
      properties:
        error:
          type: string
          const: payment_required
        price:
          type: string
          description: List price in dollars, e.g. $0.005
        resource:
          type: string
          description: The URL being charged for
        ways_to_pay:
          type: object
          description: The three routes in, cheapest first. free_trial needs no wallet, no signature, no account and no email.
          properties:
            free_trial:
              type: object
            prepaid_credit:
              type: object
            per_call_x402:
              type: object
        accepts:
          type: array
          description: The x402 challenge, echoed here for v1 clients that read it from the body rather than the payment-required header.
          items:
            type: object
        x402Version:
          type: number
      required:
      - error
      - ways_to_pay
  securitySchemes:
    creditToken:
      type: apiKey
      in: header
      name: X-Credit-Token
      description: A prepaid or trial balance. Get one free with no wallet and no account at POST https://agentic-endpoints.com/credits/trial, or buy credit at POST https://agentic-endpoints.com/credits/buy. Each call is debited at the route's list price and nothing is signed per request.
    x402Payment:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: A signed x402 payment authorising this one call, built from the challenge returned with HTTP 402. Requires a funded wallet on Base; the credit token does not.