Minifetch Technical SEO API

Cheap preflight checks if a URL can be fetched by Minifetch's user agent before making requests to the other paid Minifetch endpoints. If your own site is blocked read the tutorial: https://minifetch.com/tutorials/unblock-minifetch

Resource: minifetch.com/api/v1/x402/preflight/url-check

Network: eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xffA9155A0e4B3d8d42351Da226cC1feEe449686f

Payment methods: — · Last validation: 2026-09-14 12:24:15.421+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL to check against robots.txt"
          },
          "fresh": {
            "type": "boolean",
            "description": "Optional. If true, bypasses the 24h robots.txt cache and re-fetches robots.txt for this check. Use after editing your robots.txt or crawl-delay (or adding/removing a Minifetch block) to confirm the change took effect."
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "properties": {
          "tip": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "description": "Present only when allowed=false: how site owners can unblock the minifetch user agent"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "data": {
                  "type": "object",
                  "required": [
                    "url",
                    "allowed",
                    "message",
                    "proxy"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "The URL checked, exactly as given — redirects are not followed"
                    },
                    "proxy": {
                      "type": "object",
                      "properties": {
                        "proxyType": {
                          "enum": [
                            "minifetch"
                          ],
                          "type": "string"
                        },
                        "userAgent": {
                          "type": "string"
                        }
                      },
                      "description": "Fetch provenance — always minifetch UA here"
                    },
                    "allowed": {
                      "type": "boolean",
                      "description": "Whether the minifetch user agent may fetch this URL per robots.txt"
                    },
                    "message": {
                      "type": "string",
                      "description": "e.g. 'Access allowed by robots.txt', 'URL is blocked by robots.txt', or 'robots.txt not found, defaulting to allowed'"
                    },
                    "crawlDelay": {
                      "type": "number",
                      "description": "Crawl-delay (seconds) for the minifetch UA; omitted when blocked or the domain is invalid"
                    },
                    "minifetchCache": {
                      "type": "object",
                      "properties": {
                        "hit": {
                          "type": "boolean"
                        },
                        "cachedAt": {
                          "type": "string"
                        },
                        "expiresAt": {
                          "type": "string"
                        }
                      },
                      "description": "robots.txt cache state (~24h TTL; pass fresh=true to bypass)"
                    }
                  }
                }
              }
            }
          },
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0xffA9155A0e4B3d8d42351Da226cC1feEe449686f",
        "amount": "1000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xffA9155A0e4B3d8d42351Da226cC1feEe449686f",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "1000"
    },
    {
      "raw": {
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "extra": {
          "feePayer": "Hc3sdEAsCGQcpgfivywog9uwtk8gUBUZgsxdME1EJy88"
        },
        "payTo": "46vMcwuC4sK11sB3gkLhyA7J7GEwfkhn5rFyDtihBwqe",
        "amount": "1000",
        "scheme": "exact",
        "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
        "maxTimeoutSeconds": 300
      },
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "46vMcwuC4sK11sB3gkLhyA7J7GEwfkhn5rFyDtihBwqe",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amountAtomic": "1000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.