{
  "version": "1",
  "service": {
    "name": "LinkVet",
    "description": "Verify before you cite: URL checks, quotes, page-to-Markdown, metadata, schema, links, archives.",
    "contact": "fairpage.studio@proton.me"
  },
  "payment_methods": [
    {
      "type": "lightning",
      "backend": "LNURL",
      "address": "marriedcrook211@walletofsatoshi.com"
    }
  ],
  "routes": [
    {
      "path": "/paid/check-url",
      "method": "GET",
      "description": "Verify a URL is live before citing it: status (live/404/blocked/timeout), HTTP code, final URL after redirects, title, price, dates and safe_to_cite.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "http(s) URL to verify"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://example.com"
      }
    },
    {
      "path": "/paid/verify-quote",
      "method": "GET",
      "description": "Check that a quote really appears on a page: found, match_type, similarity, closest_match and context.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Page URL"
          },
          "quote": {
            "type": "string",
            "description": "Quoted text (3-3000 chars)"
          }
        },
        "required": [
          "url",
          "quote"
        ]
      },
      "example_query": {
        "url": "https://example.com",
        "quote": "Example Domain"
      }
    },
    {
      "path": "/paid/read-page",
      "method": "GET",
      "description": "Main content of a public page as clean Markdown with title, final URL and token estimate.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Page URL"
          },
          "max_tokens": {
            "type": "integer",
            "description": "Truncate to about this many tokens (default 8000)"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://example.com"
      }
    },
    {
      "path": "/paid/check-robots",
      "method": "GET",
      "description": "Is a user agent allowed to fetch a URL under robots.txt? Plus verdicts for 20 AI crawlers and llms.txt presence.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL"
          },
          "user_agent": {
            "type": "string",
            "description": "User agent (default *)"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://example.com/",
        "user_agent": "GPTBot"
      }
    },
    {
      "path": "/paid/find-feeds",
      "method": "GET",
      "description": "Discover a site's RSS, Atom and JSON feeds and XML sitemaps.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Any page on the site"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://blog.cloudflare.com/"
      }
    },
    {
      "path": "/paid/check-email",
      "method": "GET",
      "description": "Validate an email address without sending mail: syntax, MX, SPF, DMARC, disposable/free/role flags.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Email address"
          }
        },
        "required": [
          "email"
        ]
      },
      "example_query": {
        "email": "someone@example.com"
      }
    },
    {
      "path": "/paid/page-metadata",
      "method": "GET",
      "description": "Fetch a public page and return its SEO/social metadata: title, meta description, canonical URL, language, robots directive, all Open Graph (og:*), Twitter card and article:* tags, author, published/modified dates, hreflang alternates and feed links. Use it to build link previews or citations.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Page URL"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://github.com"
      }
    },
    {
      "path": "/paid/schema-extract",
      "method": "GET",
      "description": "Extract schema.org structured data from a page: every JSON-LD block (flattening @graph), the list of @types (Product, Article, Recipe, Event, Organization, FAQPage...), up to 30 typed items with their fields (prices, ratings, dates, authors), plus microdata itemtypes. Great for pulling clean product/article facts.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Page URL"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://en.wikipedia.org/wiki/Cloudflare"
      }
    },
    {
      "path": "/paid/broken-links",
      "method": "GET",
      "description": "Fetch a page, collect its unique outbound/internal links and check each one (in parallel) for 404s, timeouts and connection errors. Returns broken links with their anchor text and the status of every link checked (up to 25 per call).",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Page to audit"
          },
          "limit": {
            "type": "integer",
            "description": "Max unique links to check (default 20, max 25)"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://info.cern.ch/hypertext/WWW/TheProject.html"
      }
    },
    {
      "path": "/paid/wayback-snapshot",
      "method": "GET",
      "description": "Find the Internet Archive Wayback Machine snapshot of a URL closest to a date (or the latest). Returns snapshot_url and time. Use it to cite a dead page (when check_url says 404) or to show what a page said at a past date.",
      "price": {
        "type": "static",
        "amount_msat": 100000
      },
      "credits_per_payment": 1000,
      "macaroon_timeout_secs": 2592000,
      "request_schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL to look up"
          },
          "timestamp": {
            "type": "string",
            "description": "Optional target date, YYYYMMDD or YYYYMMDDhhmmss: returns the closest snapshot"
          }
        },
        "required": [
          "url"
        ]
      },
      "example_query": {
        "url": "https://example.com",
        "timestamp": "20100101"
      }
    }
  ]
}