{
  "openapi": "3.1.0",
  "info": {
    "title": "Founder.best Public API",
    "version": "1.0.0",
    "summary": "Read-only discovery API for startups, products and founders listed on Founder.best.",
    "description": "The Founder.best public API lets AI assistants, autonomous agents and developers discover startups, products and founders listed on Founder.best.\n\n- No authentication required. All data is already public on founder.best.\n- Rate limit: 120 requests/minute per IP. Responses are cacheable for 5 minutes.\n- CORS is enabled for all origins (GET only).\n- MCP server for AI agents: https://www.founder.best/api/mcp (Streamable HTTP).\n- Human documentation: https://www.founder.best/docs · Machine index: https://www.founder.best/llms.txt",
    "contact": {
      "name": "Founder.best support",
      "email": "support@founder.best",
      "url": "https://www.founder.best/contact"
    },
    "termsOfService": "https://www.founder.best/terms"
  },
  "servers": [
    {
      "url": "https://www.founder.best/api/v1"
    }
  ],
  "tags": [
    {
      "name": "products",
      "description": "Startups and products listed on Founder.best"
    },
    {
      "name": "founders",
      "description": "Public founder profiles"
    },
    {
      "name": "discovery",
      "description": "Launches, trending and taxonomy"
    }
  ],
  "paths": {
    "/products": {
      "get": {
        "tags": [
          "products"
        ],
        "operationId": "listProducts",
        "summary": "Search and filter products",
        "description": "Free-text `search` matches product name, tagline, description, use cases, target audiences and categories, ranked by relevance. Combine with structured filters. Without `search`, results default to most upvoted.",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 120
            },
            "description": "Free text, e.g. \"social media content\" or \"invoicing for freelancers\"."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Category slug or name (see /categories), e.g. `ai-ml`, `saas`, `developer-tools`."
          },
          {
            "name": "use_case",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Use-case slug or name, e.g. `social-media-management`."
          },
          {
            "name": "audience",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Target audience slug or name, e.g. `founders`, `developers`."
          },
          {
            "name": "pricing",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated pricing types: free, freemium, subscription, one_time, paid, open_source."
          },
          {
            "name": "platform",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated platforms: web, mobile, api, mcp, cli, desktop."
          },
          {
            "name": "founder",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Founder username."
          },
          {
            "name": "featured",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Only featured (Pro+) launches."
          },
          {
            "name": "launched_after",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "launched_before",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "upvotes",
                "newest",
                "oldest",
                "rating"
              ],
              "default": "relevance"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Page size."
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            },
            "description": "1-based page number."
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated product list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/products/{slug}": {
      "get": {
        "tags": [
          "products"
        ],
        "operationId": "getProduct",
        "summary": "Get one product by slug",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Product detail",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDetailResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/founders": {
      "get": {
        "tags": [
          "founders"
        ],
        "operationId": "listFounders",
        "summary": "Search founders",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 120
            },
            "description": "Matches name, username, headline and bio."
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "upvotes",
                "products",
                "followers",
                "newest"
              ],
              "default": "upvotes"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Page size."
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            },
            "description": "1-based page number."
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated founder list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FounderListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/founders/{username}": {
      "get": {
        "tags": [
          "founders"
        ],
        "operationId": "getFounder",
        "summary": "Get one founder by username",
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Founder detail",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FounderDetailResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/launches": {
      "get": {
        "tags": [
          "discovery"
        ],
        "operationId": "getLaunches",
        "summary": "Launches for an ISO week, ranked",
        "description": "Defaults to the current ISO week (Monday-Sunday, UTC). Rank 1-3 are that week's winners once the week has ended.",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 2020
            }
          },
          {
            "name": "week",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 53
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            },
            "description": "Page size."
          }
        ],
        "responses": {
          "200": {
            "description": "Ranked launches",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LaunchesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/trending": {
      "get": {
        "tags": [
          "discovery"
        ],
        "operationId": "getTrending",
        "summary": "Most upvoted recent launches",
        "parameters": [
          {
            "name": "period",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "7d",
                "30d",
                "90d",
                "all"
              ],
              "default": "30d"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Page size."
          }
        ],
        "responses": {
          "200": {
            "description": "Trending products",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrendingResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/categories": {
      "get": {
        "tags": [
          "discovery"
        ],
        "operationId": "getCategories",
        "summary": "Categories, use cases, audiences, pricing types and platforms",
        "responses": {
          "200": {
            "description": "Taxonomy",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaxonomyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited. Check Retry-After and X-RateLimit-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Meta": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "docs": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "not_found",
                  "bad_request",
                  "rate_limited",
                  "internal_error"
                ]
              },
              "message": {
                "type": "string"
              },
              "details": {}
            },
            "required": [
              "code",
              "message"
            ]
          },
          "api_version": {
            "type": "string"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "previous": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "Category": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "Pricing": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "free",
              "freemium",
              "subscription",
              "one_time",
              "paid",
              "open_source"
            ]
          },
          "label": {
            "type": "string"
          },
          "has_free_tier": {
            "type": "boolean"
          }
        }
      },
      "FounderRef": {
        "type": "object",
        "properties": {
          "name": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "username": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "api_url": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "markdown_url": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "ProductMetrics": {
        "type": "object",
        "properties": {
          "upvotes": {
            "type": "integer"
          },
          "comments": {
            "type": "integer"
          },
          "rating_average": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "rating_count": {
            "type": "integer"
          }
        }
      },
      "ProductSummary": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "product"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "description": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "website": {
            "type": "string",
            "format": "uri",
            "description": "The product's own website."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Canonical Founder.best product page."
          },
          "api_url": {
            "type": "string",
            "format": "uri"
          },
          "markdown_url": {
            "type": "string",
            "format": "uri"
          },
          "logo_url": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "live",
              "upcoming"
            ]
          },
          "is_featured": {
            "type": "boolean"
          },
          "launch_date": {
            "type": "string",
            "format": "date"
          },
          "pricing": {
            "$ref": "#/components/schemas/Pricing"
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Category"
            }
          },
          "use_cases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "target_audiences": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metrics": {
            "$ref": "#/components/schemas/ProductMetrics"
          },
          "founder": {
            "$ref": "#/components/schemas/FounderRef"
          }
        }
      },
      "AiProfile": {
        "type": "object",
        "description": "Concise, fixed-shape summary designed to be read by language models.",
        "properties": {
          "product": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "category": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "ideal_for": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "key_features": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "pricing": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "founder": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "launch_date": {
            "type": "string"
          },
          "platforms": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "founder_best_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "ProductDetail": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProductSummary"
          },
          {
            "type": "object",
            "properties": {
              "links": {
                "type": "object",
                "properties": {
                  "website": {
                    "type": "string",
                    "format": "uri"
                  },
                  "github": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "twitter": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "app_store": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "google_play": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "api_docs": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "mcp_server": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              },
              "integrations": {
                "type": "object",
                "properties": {
                  "has_api": {
                    "type": "boolean"
                  },
                  "has_mcp_server": {
                    "type": "boolean"
                  },
                  "has_cli": {
                    "type": "boolean"
                  },
                  "cli_install_command": {
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "api_docs_url": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "mcp_url": {
                    "oneOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "founder_best_url": {
                      "oneOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                }
              },
              "screenshots": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "og_image_url": {
                "oneOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metrics": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProductMetrics"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "verified_revenue": {
                        "oneOf": [
                          {
                            "type": "object",
                            "description": "Only present when the founder publicly shares verified revenue via TrustMRR.",
                            "properties": {
                              "source": {
                                "type": "string",
                                "const": "TrustMRR"
                              },
                              "label": {
                                "type": "string"
                              },
                              "mrr_usd": {
                                "oneOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "last_30_days_usd": {
                                "oneOf": [
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "url": {
                                "oneOf": [
                                  {
                                    "type": "string",
                                    "format": "uri"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "verified_at": {
                                "oneOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            }
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    }
                  }
                ]
              },
              "ai_profile": {
                "$ref": "#/components/schemas/AiProfile"
              },
              "created_at": {
                "type": "string",
                "format": "date-time"
              },
              "updated_at": {
                "type": "string",
                "format": "date-time"
              }
            }
          }
        ]
      },
      "FounderSummary": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "founder"
          },
          "username": {
            "type": "string"
          },
          "name": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "headline": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "api_url": {
            "type": "string",
            "format": "uri"
          },
          "markdown_url": {
            "type": "string",
            "format": "uri"
          },
          "avatar_url": {
            "oneOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "product_count": {
            "type": "integer"
          },
          "total_upvotes_received": {
            "type": "integer"
          },
          "follower_count": {
            "type": "integer"
          }
        }
      },
      "FounderDetail": {
        "allOf": [
          {
            "$ref": "#/components/schemas/FounderSummary"
          },
          {
            "type": "object",
            "properties": {
              "bio": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "following_count": {
                "type": "integer"
              },
              "social_links": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "platform": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              },
              "products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    },
                    "tagline": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "api_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "markdown_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "upvote_count": {
                      "type": "integer"
                    },
                    "launch_date": {
                      "type": "string",
                      "format": "date"
                    },
                    "is_featured": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "ProductListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "query": {
                "type": "object"
              },
              "pagination": {
                "$ref": "#/components/schemas/Pagination"
              },
              "count": {
                "type": "integer"
              },
              "products": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ProductSummary"
                }
              }
            }
          }
        ]
      },
      "ProductDetailResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "product": {
                "$ref": "#/components/schemas/ProductDetail"
              }
            }
          }
        ]
      },
      "FounderListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "pagination": {
                "$ref": "#/components/schemas/Pagination"
              },
              "count": {
                "type": "integer"
              },
              "founders": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/FounderSummary"
                }
              }
            }
          }
        ]
      },
      "FounderDetailResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "founder": {
                "$ref": "#/components/schemas/FounderDetail"
              }
            }
          }
        ]
      },
      "LaunchWeek": {
        "type": "object",
        "properties": {
          "year": {
            "type": "integer"
          },
          "week": {
            "type": "integer"
          },
          "starts_on": {
            "type": "string",
            "format": "date"
          },
          "ends_on": {
            "type": "string",
            "format": "date"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "api_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "LaunchesResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "week": {
                "$ref": "#/components/schemas/LaunchWeek"
              },
              "is_current_week": {
                "type": "boolean"
              },
              "previous_week": {
                "$ref": "#/components/schemas/LaunchWeek"
              },
              "next_week": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/LaunchWeek"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer"
              },
              "products": {
                "type": "array",
                "items": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ProductSummary"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "rank": {
                          "type": "integer"
                        },
                        "week_score": {
                          "type": "integer"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        ]
      },
      "TrendingResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "period": {
                "type": "string",
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "all"
                ]
              },
              "since": {
                "oneOf": [
                  {
                    "type": "string",
                    "format": "date"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "category": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer"
              },
              "products": {
                "type": "array",
                "items": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ProductSummary"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "rank": {
                          "type": "integer"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        ]
      },
      "TaxonomyResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Meta"
          },
          {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer"
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    },
                    "description": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "product_count": {
                      "type": "integer"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "api_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              },
              "use_cases": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/TaxonomyTag"
                }
              },
              "audiences": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/TaxonomyTag"
                }
              },
              "pricing_types": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "slug": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "api_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              },
              "platforms": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "slug": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "api_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "TaxonomyTag": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "product_count": {
            "type": "integer"
          },
          "api_url": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    }
  }
}