{
 "openapi": "3.1.0",
 "info": {
  "title": "Web Page Reader",
  "description": "Twenty-five data, validation and utility APIs served from one server at separate path prefixes.",
  "version": "0.1.0"
 },
 "paths": {
  "/web/v1/markdown": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "Convert a web page to clean Markdown",
    "description": "Fetches the page, removes navigation, ads and boilerplate, and returns the main content as Markdown, ready to pass to a language model. JavaScript is not executed, so pages that render entirely in the browser return little content.",
    "operationId": "Convert a web page to clean Markdown",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Full page URL, starting with http:// or https://.",
       "examples": [
        "https://example.com/"
       ],
       "title": "Url"
      },
      "description": "Full page URL, starting with http:// or https://."
     },
     {
      "name": "format",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "pattern": "^(markdown|text)$",
       "description": "markdown or text.",
       "default": "markdown",
       "title": "Format"
      },
      "description": "markdown or text."
     },
     {
      "name": "include_links",
      "in": "query",
      "required": false,
      "schema": {
       "type": "boolean",
       "description": "Keep hyperlinks in the Markdown.",
       "default": true,
       "title": "Include Links"
      },
      "description": "Keep hyperlinks in the Markdown."
     },
     {
      "name": "include_images",
      "in": "query",
      "required": false,
      "schema": {
       "type": "boolean",
       "description": "Keep image references in the Markdown.",
       "default": false,
       "title": "Include Images"
      },
      "description": "Keep image references in the Markdown."
     },
     {
      "name": "include_tables",
      "in": "query",
      "required": false,
      "schema": {
       "type": "boolean",
       "default": true,
       "title": "Include Tables"
      }
     },
     {
      "name": "main_content_only",
      "in": "query",
      "required": false,
      "schema": {
       "type": "boolean",
       "description": "Drop navigation, footers and sidebars. Set false to keep more of the page.",
       "default": true,
       "title": "Main Content Only"
      },
      "description": "Drop navigation, footers and sidebars. Set false to keep more of the page."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Markdown Web V1 Markdown Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/web/v1/metadata": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "Link preview: title, description, image and Open Graph data",
    "description": "Everything needed to render a link preview card, plus the page's raw Open Graph, Twitter card and structured-data types.",
    "operationId": "Link preview: title, description, image and Open Graph data",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Full page URL, starting with http:// or https://.",
       "examples": [
        "https://example.com/"
       ],
       "title": "Url"
      },
      "description": "Full page URL, starting with http:// or https://."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Metadata Web V1 Metadata Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/web/v1/links": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "List the links on a page",
    "operationId": "List the links on a page",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Full page URL, starting with http:// or https://.",
       "examples": [
        "https://example.com/"
       ],
       "title": "Url"
      },
      "description": "Full page URL, starting with http:// or https://."
     },
     {
      "name": "scope",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "pattern": "^(all|internal|external)$",
       "default": "all",
       "title": "Scope"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1,
       "default": 200,
       "title": "Limit"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Links Web V1 Links Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/web/v1/seo": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "On-page SEO audit",
    "description": "Checks the title, meta description, headings, images, canonical link, indexability, mobile viewport, structured data and social tags of one page, and returns a pass / warn / fail list with a score.",
    "operationId": "On-page SEO audit",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Full page URL, starting with http:// or https://.",
       "examples": [
        "https://example.com/"
       ],
       "title": "Url"
      },
      "description": "Full page URL, starting with http:// or https://."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Seo Web V1 Seo Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/web/v1/robots": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "Read a site's robots.txt and test a URL against it",
    "operationId": "Read a site's robots.txt and test a URL against it",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Full page URL, starting with http:// or https://.",
       "examples": [
        "https://example.com/"
       ],
       "title": "Url"
      },
      "description": "Full page URL, starting with http:// or https://."
     },
     {
      "name": "user_agent",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "maxLength": 100,
       "description": "Crawler name to test, for example Googlebot or GPTBot.",
       "default": "*",
       "title": "User Agent"
      },
      "description": "Crawler name to test, for example Googlebot or GPTBot."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Robots Web V1 Robots Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/web/v1/sitemap": {
   "get": {
    "tags": [
     "Web Page Reader"
    ],
    "summary": "Parse an XML sitemap",
    "description": "Returns the URLs in a sitemap with last-modified dates, or the child sitemaps when it is a sitemap index. Gzipped sitemaps are supported.",
    "operationId": "Parse an XML sitemap",
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8,
       "maxLength": 2000,
       "description": "Sitemap URL, or a site URL to discover its sitemap from robots.txt.",
       "examples": [
        "https://www.sitemaps.org/sitemap.xml"
       ],
       "title": "Url"
      },
      "description": "Sitemap URL, or a site URL to discover its sitemap from robots.txt."
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "maximum": 5000,
       "minimum": 1,
       "default": 500,
       "title": "Limit"
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 0,
       "default": 0,
       "title": "Offset"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Sitemap Web V1 Sitemap Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "AgentsIn": {
    "properties": {
     "user_agents": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "User Agents",
      "description": "Up to 200 User-Agent strings."
     }
    },
    "type": "object",
    "required": [
     "user_agents"
    ],
    "title": "AgentsIn"
   },
   "Ats": {
    "type": "string",
    "enum": [
     "greenhouse",
     "lever",
     "ashby",
     "workable",
     "smartrecruiters",
     "recruitee",
     "personio",
     "rippling",
     "workday"
    ],
    "title": "Ats"
   },
   "BoardRef": {
    "properties": {
     "ats": {
      "$ref": "#/components/schemas/Ats"
     },
     "board": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
      "title": "Board"
     }
    },
    "type": "object",
    "required": [
     "ats",
     "board"
    ],
    "title": "BoardRef"
   },
   "CardBody": {
    "properties": {
     "number": {
      "type": "string",
      "maxLength": 40,
      "minLength": 12,
      "title": "Number",
      "examples": [
       "4111 1111 1111 1111"
      ]
     }
    },
    "type": "object",
    "required": [
     "number"
    ],
    "title": "CardBody"
   },
   "Ecc": {
    "type": "string",
    "enum": [
     "L",
     "M",
     "Q",
     "H"
    ],
    "title": "Ecc"
   },
   "HTTPValidationError": {
    "properties": {
     "detail": {
      "items": {
       "$ref": "#/components/schemas/ValidationError"
      },
      "type": "array",
      "title": "Detail"
     }
    },
    "type": "object",
    "title": "HTTPValidationError"
   },
   "HashIn": {
    "properties": {
     "text": {
      "type": "string",
      "maxLength": 1000000,
      "title": "Text"
     },
     "algorithms": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Algorithms",
      "default": [
       "md5",
       "sha1",
       "sha256",
       "sha512"
      ]
     }
    },
    "type": "object",
    "required": [
     "text"
    ],
    "title": "HashIn"
   },
   "PasswordIn": {
    "properties": {
     "password": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "title": "Password"
     },
     "user_inputs": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 10,
      "title": "User Inputs",
      "description": "Optional words tied to the user (name, email, site name) that should count as guessable."
     }
    },
    "type": "object",
    "required": [
     "password"
    ],
    "title": "PasswordIn"
   },
   "QrFormat": {
    "type": "string",
    "enum": [
     "png",
     "svg",
     "json"
    ],
    "title": "QrFormat"
   },
   "SearchBody": {
    "properties": {
     "boards": {
      "items": {
       "$ref": "#/components/schemas/BoardRef"
      },
      "type": "array",
      "maxItems": 20,
      "minItems": 1,
      "title": "Boards",
      "description": "The company boards to search."
     },
     "q": {
      "anyOf": [
       {
        "type": "string",
        "maxLength": 100
       },
       {
        "type": "null"
       }
      ],
      "title": "Q"
     },
     "location": {
      "anyOf": [
       {
        "type": "string",
        "maxLength": 100
       },
       {
        "type": "null"
       }
      ],
      "title": "Location"
     },
     "remote": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Remote"
     },
     "posted_after": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Posted After",
      "description": "Keep jobs posted at or after this time (ISO 8601)."
     },
     "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "default": 50
     }
    },
    "type": "object",
    "required": [
     "boards"
    ],
    "title": "SearchBody"
   },
   "Sort": {
    "type": "string",
    "enum": [
     "most_recent",
     "most_helpful"
    ],
    "title": "Sort"
   },
   "Symbology": {
    "type": "string",
    "enum": [
     "code128",
     "code39",
     "ean13",
     "ean8",
     "upca",
     "isbn13",
     "itf"
    ],
    "title": "Symbology"
   },
   "TextIn": {
    "properties": {
     "text": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1,
      "title": "Text",
      "description": "The text to analyse (up to 100,000 characters)."
     }
    },
    "type": "object",
    "required": [
     "text"
    ],
    "title": "TextIn"
   },
   "TextsIn": {
    "properties": {
     "texts": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Texts",
      "description": "Up to 100 texts of at most 5,000 characters each."
     }
    },
    "type": "object",
    "required": [
     "texts"
    ],
    "title": "TextsIn"
   },
   "TokenIn": {
    "properties": {
     "token": {
      "type": "string",
      "maxLength": 8192,
      "minLength": 5,
      "title": "Token"
     }
    },
    "type": "object",
    "required": [
     "token"
    ],
    "title": "TokenIn"
   },
   "ValidationError": {
    "properties": {
     "loc": {
      "items": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "integer"
        }
       ]
      },
      "type": "array",
      "title": "Location"
     },
     "msg": {
      "type": "string",
      "title": "Message"
     },
     "type": {
      "type": "string",
      "title": "Error Type"
     },
     "input": {
      "title": "Input"
     },
     "ctx": {
      "type": "object",
      "title": "Context"
     }
    },
    "type": "object",
    "required": [
     "loc",
     "msg",
     "type"
    ],
    "title": "ValidationError"
   },
   "app__routers__contacts__BatchBody": {
    "properties": {
     "urls": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 10,
      "minItems": 1,
      "title": "Urls",
      "description": "Domains or URLs, one per site."
     },
     "max_pages": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "title": "Max Pages",
      "description": "Pages to read per site.",
      "default": 3
     },
     "default_country": {
      "anyOf": [
       {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
       },
       {
        "type": "null"
       }
      ],
      "title": "Default Country"
     },
     "validate_emails": {
      "type": "boolean",
      "title": "Validate Emails",
      "default": false
     }
    },
    "type": "object",
    "required": [
     "urls"
    ],
    "title": "BatchBody"
   },
   "app__routers__email__BatchBody": {
    "properties": {
     "emails": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "minItems": 1,
      "title": "Emails"
     },
     "check_mx": {
      "type": "boolean",
      "title": "Check Mx",
      "default": true
     }
    },
    "type": "object",
    "required": [
     "emails"
    ],
    "title": "BatchBody"
   },
   "app__routers__ip__BatchBody": {
    "properties": {
     "ips": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 100,
      "minItems": 1,
      "title": "Ips"
     }
    },
    "type": "object",
    "required": [
     "ips"
    ],
    "title": "BatchBody"
   },
   "app__routers__phone__BatchBody": {
    "properties": {
     "numbers": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 100,
      "minItems": 1,
      "title": "Numbers"
     },
     "default_country": {
      "anyOf": [
       {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
       },
       {
        "type": "null"
       }
      ],
      "title": "Default Country"
     }
    },
    "type": "object",
    "required": [
     "numbers"
    ],
    "title": "BatchBody"
   },
   "app__routers__vin__BatchBody": {
    "properties": {
     "vins": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "minItems": 1,
      "title": "Vins"
     }
    },
    "type": "object",
    "required": [
     "vins"
    ],
    "title": "BatchBody"
   }
  }
 }
}
