{
  "openapi": "3.1.0",
  "info": {
    "title": "SuperDev Pro API",
    "version": "1.0.0",
    "summary": "Read-only catalog of SuperDev Pro's browser-extension tools, plans and install links.",
    "description": "Public, free and keyless. SuperDev Pro is a browser extension; this API describes it so agents can find the right tool for a web-development task, tell free from Pro tools, and give users install and pricing links. Versioning: breaking changes get a new path (/api/v2); /api/v1 stays as is. Rate limit: 120 requests per minute per IP. Errors use RFC 9457 problem+json with a stable `code`.",
    "contact": {
      "name": "SuperDev Pro support",
      "email": "hello@superdevpro.com",
      "url": "https://superdevpro.com/contact"
    },
    "termsOfService": "https://superdevpro.com/terms"
  },
  "externalDocs": {
    "description": "Developer docs",
    "url": "https://superdevpro.com/developers"
  },
  "servers": [
    {
      "url": "https://superdevpro.com/api/v1"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "Catalog"
    },
    {
      "name": "Commerce"
    }
  ],
  "paths": {
    "/app": {
      "get": {
        "operationId": "getAppInfo",
        "tags": [
          "Catalog"
        ],
        "summary": "Extension info, browsers and install links",
        "responses": {
          "200": {
            "description": "The extension.",
            "headers": {
              "RateLimit": {
                "description": "IETF RateLimit header: limit, remaining and reset (seconds).",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Quota policy, e.g. `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              },
              "API-Version": {
                "description": "Version of this API that answered.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/App"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Wait for the `Retry-After` seconds.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/tools": {
      "get": {
        "operationId": "searchTools",
        "tags": [
          "Catalog"
        ],
        "summary": "List or search tools",
        "description": "Every tool, or those matching `q` (all words must match), `category` and/or `plan`. Paginate with `cursor`.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Keywords, e.g. `color picker`."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "development",
                "content",
                "typography",
                "design",
                "utility",
                "productivity",
                "seo",
                "layout",
                "media",
                "measurement",
                "performance",
                "data",
                "analytics"
              ]
            }
          },
          {
            "name": "plan",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "free",
                "pro"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "`next_cursor` from the previous page."
          }
        ],
        "responses": {
          "200": {
            "description": "A page of tools.",
            "headers": {
              "RateLimit": {
                "description": "IETF RateLimit header: limit, remaining and reset (seconds).",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Quota policy, e.g. `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              },
              "API-Version": {
                "description": "Version of this API that answered.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolList"
                }
              }
            }
          },
          "400": {
            "description": "Bad parameter.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Wait for the `Retry-After` seconds.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/tools/{slug}": {
      "get": {
        "operationId": "getTool",
        "tags": [
          "Catalog"
        ],
        "summary": "One tool",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "css-inspector"
          }
        ],
        "responses": {
          "200": {
            "description": "The tool.",
            "headers": {
              "RateLimit": {
                "description": "IETF RateLimit header: limit, remaining and reset (seconds).",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Quota policy, e.g. `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              },
              "API-Version": {
                "description": "Version of this API that answered.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolDetail"
                }
              }
            }
          },
          "404": {
            "description": "No tool with that slug.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Wait for the `Retry-After` seconds.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/categories": {
      "get": {
        "operationId": "listCategories",
        "tags": [
          "Catalog"
        ],
        "summary": "Tool categories",
        "responses": {
          "200": {
            "description": "Categories.",
            "headers": {
              "RateLimit": {
                "description": "IETF RateLimit header: limit, remaining and reset (seconds).",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Quota policy, e.g. `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              },
              "API-Version": {
                "description": "Version of this API that answered.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Category"
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Wait for the `Retry-After` seconds.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/pricing": {
      "get": {
        "operationId": "getPricing",
        "tags": [
          "Commerce"
        ],
        "summary": "Free and Lifetime plans",
        "responses": {
          "200": {
            "description": "Pricing.",
            "headers": {
              "RateLimit": {
                "description": "IETF RateLimit header: limit, remaining and reset (seconds).",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Quota policy, e.g. `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              },
              "API-Version": {
                "description": "Version of this API that answered.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pricing"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Wait for the `Retry-After` seconds.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Problem": {
        "type": "object",
        "description": "RFC 9457 problem details.",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "detail": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "enum": [
              "not_found",
              "tool_not_found",
              "invalid_category",
              "invalid_plan",
              "invalid_limit",
              "rate_limited",
              "internal_error"
            ]
          },
          "hint": {
            "type": "string",
            "description": "What to do next."
          },
          "docs": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "code"
        ]
      },
      "ToolSummary": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "development",
              "content",
              "typography",
              "design",
              "utility",
              "productivity",
              "seo",
              "layout",
              "media",
              "measurement",
              "performance",
              "data",
              "analytics"
            ]
          },
          "summary": {
            "type": "string"
          },
          "plan": {
            "type": "string",
            "enum": [
              "free",
              "pro"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "markdown_url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "slug",
          "name",
          "category",
          "summary",
          "plan",
          "url",
          "markdown_url"
        ]
      },
      "ToolList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ToolSummary"
            }
          },
          "total": {
            "type": "integer"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "has_more": {
            "type": "boolean"
          }
        },
        "required": [
          "data",
          "total",
          "next_cursor",
          "has_more"
        ]
      },
      "ToolDetail": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ToolSummary"
          },
          {
            "type": "object",
            "properties": {
              "requires": {
                "type": "string"
              },
              "install": {
                "type": "object",
                "properties": {
                  "chrome": {
                    "type": "string",
                    "format": "uri"
                  },
                  "firefox": {
                    "type": "string",
                    "format": "uri"
                  }
                }
              }
            },
            "required": [
              "requires",
              "install"
            ]
          }
        ]
      },
      "Category": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "tool_count": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "name",
          "tool_count"
        ]
      },
      "Pricing": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "plans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "enum": [
                    "free",
                    "lifetime"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "price": {
                  "type": "number",
                  "description": "What the buyer pays, discount applied."
                },
                "list_price": {
                  "type": "number"
                },
                "billing": {
                  "type": "string",
                  "enum": [
                    "free",
                    "one_time"
                  ]
                },
                "includes": {
                  "type": "string"
                },
                "buy_url": {
                  "type": "string",
                  "format": "uri"
                },
                "get_started_url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "id",
                "name",
                "price",
                "billing"
              ]
            }
          },
          "discount": {
            "type": [
              "object",
              "null"
            ]
          },
          "regional_pricing": {
            "type": "string"
          },
          "refund_days": {
            "type": "integer"
          }
        },
        "required": [
          "currency",
          "plans"
        ]
      },
      "App": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "browsers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "install": {
            "type": "object"
          },
          "tool_count": {
            "type": "integer"
          },
          "free_tool_count": {
            "type": "integer"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "website": {
            "type": "string",
            "format": "uri"
          },
          "docs": {
            "type": "string",
            "format": "uri"
          },
          "support_email": {
            "type": "string",
            "format": "email"
          },
          "publisher": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type",
          "tool_count"
        ]
      }
    }
  }
}