@crawlora-org/sdk 1.5.0-sdk.2 → 1.6.0-sdk.1

package/openapi/public.json

@@ -3045,6 +3045,276 @@
       },
       "type": "object"
     },
+    "brand.Address": {
+      "properties": {
+        "city": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "country_code": {
+          "type": "string"
+        },
+        "postal_code": {
+          "type": "string"
+        },
+        "state_code": {
+          "type": "string"
+        },
+        "state_province": {
+          "type": "string"
+        },
+        "street": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Backdrop": {
+      "properties": {
+        "colors": {
+          "items": {
+            "$ref": "#/definitions/brand.Color"
+          },
+          "type": "array"
+        },
+        "resolution": {
+          "$ref": "#/definitions/brand.Resolution"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.BrandResponse": {
+      "properties": {
+        "address": {
+          "$ref": "#/definitions/brand.Address"
+        },
+        "backdrops": {
+          "items": {
+            "$ref": "#/definitions/brand.Backdrop"
+          },
+          "type": "array"
+        },
+        "colors": {
+          "items": {
+            "$ref": "#/definitions/brand.Color"
+          },
+          "type": "array"
+        },
+        "description": {
+          "example": "Brand intelligence for the modern web.",
+          "type": "string"
+        },
+        "domain": {
+          "example": "context.dev",
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "industries": {
+          "$ref": "#/definitions/brand.Industries"
+        },
+        "is_nsfw": {
+          "example": false,
+          "type": "boolean"
+        },
+        "links": {
+          "$ref": "#/definitions/brand.Links"
+        },
+        "logos": {
+          "items": {
+            "$ref": "#/definitions/brand.Logo"
+          },
+          "type": "array"
+        },
+        "phone": {
+          "type": "string"
+        },
+        "primary_language": {
+          "example": "en",
+          "type": "string"
+        },
+        "slogan": {
+          "type": "string"
+        },
+        "socials": {
+          "items": {
+            "$ref": "#/definitions/brand.Social"
+          },
+          "type": "array"
+        },
+        "source": {
+          "$ref": "#/definitions/brand.SourceDetail"
+        },
+        "stock": {
+          "$ref": "#/definitions/brand.Stock"
+        },
+        "title": {
+          "example": "Context",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Color": {
+      "properties": {
+        "hex": {
+          "example": "#0b0b0b",
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.EIC": {
+      "properties": {
+        "industry": {
+          "type": "string"
+        },
+        "subindustry": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Industries": {
+      "properties": {
+        "eic": {
+          "items": {
+            "$ref": "#/definitions/brand.EIC"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Links": {
+      "properties": {
+        "blog": {
+          "type": "string"
+        },
+        "careers": {
+          "type": "string"
+        },
+        "contact": {
+          "type": "string"
+        },
+        "pricing": {
+          "type": "string"
+        },
+        "privacy": {
+          "type": "string"
+        },
+        "terms": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Logo": {
+      "properties": {
+        "colors": {
+          "items": {
+            "$ref": "#/definitions/brand.Color"
+          },
+          "type": "array"
+        },
+        "mode": {
+          "type": "string"
+        },
+        "resolution": {
+          "$ref": "#/definitions/brand.Resolution"
+        },
+        "type": {
+          "example": "icon",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://context.dev/favicon.ico",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Resolution": {
+      "properties": {
+        "aspect_ratio": {
+          "example": 1,
+          "type": "number"
+        },
+        "height": {
+          "example": 512,
+          "type": "integer"
+        },
+        "width": {
+          "example": 512,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Social": {
+      "properties": {
+        "type": {
+          "example": "x",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://x.com/context",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.SourceDetail": {
+      "properties": {
+        "type": {
+          "example": "html",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://context.dev",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.Stock": {
+      "properties": {
+        "exchange": {
+          "example": "NASDAQ",
+          "type": "string"
+        },
+        "ticker": {
+          "example": "NVDA",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "brand.retrieveResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/brand.BrandResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "brave.Discussion": {
       "properties": {
         "age": {
@@ -15540,6 +15810,336 @@
       },
       "type": "object"
     },
+    "reddit.Author": {
+      "properties": {
+        "name": {
+          "example": "reddit_user",
+          "type": "string"
+        },
+        "profile_url": {
+          "example": "https://www.reddit.com/user/reddit_user/",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.Comment": {
+      "properties": {
+        "author": {
+          "$ref": "#/definitions/reddit.Author"
+        },
+        "body": {
+          "example": "I agree with this post.",
+          "type": "string"
+        },
+        "created": {
+          "example": "2024-04-19T00:00:00Z",
+          "type": "string"
+        },
+        "created_utc": {
+          "example": 1713484800,
+          "type": "integer"
+        },
+        "depth": {
+          "example": 1,
+          "type": "integer"
+        },
+        "id": {
+          "example": "kabc123",
+          "type": "string"
+        },
+        "name": {
+          "example": "t1_kabc123",
+          "type": "string"
+        },
+        "parent_id": {
+          "example": "t3_1abcxyz",
+          "type": "string"
+        },
+        "permalink": {
+          "example": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/kabc123/",
+          "type": "string"
+        },
+        "replies": {
+          "items": {
+            "$ref": "#/definitions/reddit.Comment"
+          },
+          "type": "array"
+        },
+        "score": {
+          "example": 12,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.CommentsResponse": {
+      "properties": {
+        "comments": {
+          "items": {
+            "$ref": "#/definitions/reddit.Comment"
+          },
+          "type": "array"
+        },
+        "post": {
+          "$ref": "#/definitions/reddit.Post"
+        },
+        "source": {
+          "$ref": "#/definitions/reddit.SourceDetail"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.Pagination": {
+      "properties": {
+        "after": {
+          "example": "t3_1abcxyz",
+          "type": "string"
+        },
+        "limit": {
+          "example": 25,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.Post": {
+      "properties": {
+        "author": {
+          "$ref": "#/definitions/reddit.Author"
+        },
+        "comment_count": {
+          "example": 45,
+          "type": "integer"
+        },
+        "created": {
+          "example": "2024-04-19T00:00:00Z",
+          "type": "string"
+        },
+        "created_utc": {
+          "example": 1713484800,
+          "type": "integer"
+        },
+        "domain": {
+          "example": "self.OpenAI",
+          "type": "string"
+        },
+        "flair": {
+          "example": "Discussion",
+          "type": "string"
+        },
+        "id": {
+          "example": "1abcxyz",
+          "type": "string"
+        },
+        "is_self": {
+          "type": "boolean"
+        },
+        "is_video": {
+          "type": "boolean"
+        },
+        "locked": {
+          "type": "boolean"
+        },
+        "name": {
+          "example": "t3_1abcxyz",
+          "type": "string"
+        },
+        "over_18": {
+          "type": "boolean"
+        },
+        "permalink": {
+          "example": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/",
+          "type": "string"
+        },
+        "score": {
+          "example": 123,
+          "type": "integer"
+        },
+        "selftext": {
+          "example": "Discussion body",
+          "type": "string"
+        },
+        "source_feed_url": {
+          "example": "https://www.reddit.com/r/OpenAI/.rss",
+          "type": "string"
+        },
+        "stickied": {
+          "type": "boolean"
+        },
+        "subreddit": {
+          "example": "OpenAI",
+          "type": "string"
+        },
+        "thumbnail": {
+          "example": "https://b.thumbs.redditmedia.com/example.jpg",
+          "type": "string"
+        },
+        "title": {
+          "example": "OpenAI discussion thread",
+          "type": "string"
+        },
+        "upvote_ratio": {
+          "example": 0.95,
+          "type": "number"
+        },
+        "url": {
+          "example": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.PostResponse": {
+      "properties": {
+        "post": {
+          "$ref": "#/definitions/reddit.Post"
+        },
+        "source": {
+          "$ref": "#/definitions/reddit.SourceDetail"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.SearchResponse": {
+      "properties": {
+        "pagination": {
+          "$ref": "#/definitions/reddit.Pagination"
+        },
+        "posts": {
+          "items": {
+            "$ref": "#/definitions/reddit.Post"
+          },
+          "type": "array"
+        },
+        "query": {
+          "example": "openai",
+          "type": "string"
+        },
+        "sort": {
+          "example": "relevance",
+          "type": "string"
+        },
+        "source": {
+          "$ref": "#/definitions/reddit.SourceDetail"
+        },
+        "subreddit": {
+          "example": "OpenAI",
+          "type": "string"
+        },
+        "time": {
+          "example": "week",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.SourceDetail": {
+      "properties": {
+        "type": {
+          "example": "rss",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://www.reddit.com/r/OpenAI/.rss",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.SubredditPostsResponse": {
+      "properties": {
+        "pagination": {
+          "$ref": "#/definitions/reddit.Pagination"
+        },
+        "posts": {
+          "items": {
+            "$ref": "#/definitions/reddit.Post"
+          },
+          "type": "array"
+        },
+        "sort": {
+          "example": "hot",
+          "type": "string"
+        },
+        "source": {
+          "$ref": "#/definitions/reddit.SourceDetail"
+        },
+        "subreddit": {
+          "example": "OpenAI",
+          "type": "string"
+        },
+        "time": {
+          "example": "week",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.commentsResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/reddit.CommentsResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.postResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/reddit.PostResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.searchResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/reddit.SearchResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "reddit.subredditPostsResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/reddit.SubredditPostsResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "referrals.referralAttributionDoc": {
       "properties": {
         "campaign": {
@@ -25991,6 +26591,38 @@
       },
       "type": "object"
     },
+    "yahoofinance.LookupResponse": {
+      "properties": {
+        "count": {
+          "example": 10,
+          "type": "integer"
+        },
+        "documents": {
+          "items": {
+            "additionalProperties": {},
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "query": {
+          "example": "apple",
+          "type": "string"
+        },
+        "start": {
+          "example": 0,
+          "type": "integer"
+        },
+        "total": {
+          "example": 10,
+          "type": "integer"
+        },
+        "type": {
+          "example": "all",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "yahoofinance.MarketStatusResponse": {
       "properties": {
         "market": {
@@ -26573,6 +27205,22 @@
       },
       "type": "object"
     },
+    "yahoofinance.lookupResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/yahoofinance.LookupResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "yahoofinance.marketStatusResponseDoc": {
       "properties": {
         "code": {
@@ -31180,58 +31828,150 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Suggest Bing search queries",
+        "summary": "Suggest Bing search queries",
+        "tags": [
+          "Bing"
+        ]
+      }
+    },
+    "/bing/videos": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns normalized Bing video search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Bing video HTML/async pages and return 503 when Bing serves a challenge page or unusable HTML.",
+        "operationId": "bing-videos",
+        "parameters": [
+          {
+            "description": "Search query",
+            "example": "openai",
+            "in": "query",
+            "name": "q",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "1-based page number; defaults to 1",
+            "example": 1,
+            "in": "query",
+            "minimum": 1,
+            "name": "page",
+            "type": "integer"
+          },
+          {
+            "description": "Results per page; defaults to 10, clamped to 1..50",
+            "example": 10,
+            "in": "query",
+            "maximum": 50,
+            "minimum": 1,
+            "name": "count",
+            "type": "integer"
+          },
+          {
+            "description": "Two-letter country code; defaults to us",
+            "example": "us",
+            "in": "query",
+            "name": "country",
+            "type": "string"
+          },
+          {
+            "description": "Bing UI language; defaults to en-us",
+            "example": "en-us",
+            "in": "query",
+            "name": "lang",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/bing.videosResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Missing or invalid query parameters",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "No results found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Rate limit exceeded",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Bing upstream request failed",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Search Bing video results",
         "tags": [
           "Bing"
         ]
       }
     },
-    "/bing/videos": {
+    "/brand/retrieve": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns normalized Bing video search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Bing video HTML/async pages and return 503 when Bing serves a challenge page or unusable HTML.",
-        "operationId": "bing-videos",
+        "description": "Fetches a domain's homepage and extracts a normalized brand profile (title, description, colors, logos, backdrops, socials, links, and any schema.org organization data). Enrichment-only fields that are not present in the page markup are returned as null.",
+        "operationId": "brand-retrieve",
         "parameters": [
           {
-            "description": "Search query",
-            "example": "openai",
+            "description": "Domain to retrieve brand data for, e.g. context.dev",
             "in": "query",
-            "name": "q",
+            "name": "domain",
             "required": true,
             "type": "string"
           },
           {
-            "description": "1-based page number; defaults to 1",
-            "example": 1,
+            "description": "Accepted for compatibility; not applied in HTML-only mode",
             "in": "query",
-            "minimum": 1,
-            "name": "page",
-            "type": "integer"
+            "name": "force_language",
+            "type": "string"
           },
           {
-            "description": "Results per page; defaults to 10, clamped to 1..50",
-            "example": 10,
+            "description": "Optimize for speed by skipping schema.org and footer-link extraction",
             "in": "query",
-            "maximum": 50,
-            "minimum": 1,
-            "name": "count",
-            "type": "integer"
+            "name": "maxSpeed",
+            "type": "boolean"
           },
           {
-            "description": "Two-letter country code; defaults to us",
-            "example": "us",
+            "description": "Cache freshness window in milliseconds, clamps to 1 day..1 year",
             "in": "query",
-            "name": "country",
-            "type": "string"
+            "name": "maxAgeMs",
+            "type": "integer"
           },
           {
-            "description": "Bing UI language; defaults to en-us",
-            "example": "en-us",
+            "description": "Upstream fetch timeout in milliseconds, clamps to 1000..300000",
             "in": "query",
-            "name": "lang",
-            "type": "string"
+            "name": "timeoutMS",
+            "type": "integer"
           }
         ],
         "produces": [
@@ -31241,35 +31981,35 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/bing.videosResponseDoc"
+              "$ref": "#/definitions/brand.retrieveResponseDoc"
             }
           },
           "400": {
-            "description": "Missing or invalid query parameters",
+            "description": "Bad Request",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "404": {
-            "description": "No results found",
+            "description": "Not Found",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
-          "429": {
-            "description": "Rate limit exceeded",
+          "408": {
+            "description": "Request Timeout",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "429": {
+            "description": "Too Many Requests",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "503": {
-            "description": "Bing upstream request failed",
+            "description": "Service Unavailable",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -31280,9 +32020,9 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Search Bing video results",
+        "summary": "Retrieve brand data by domain",
         "tags": [
-          "Bing"
+          "Brand"
         ]
       }
     },
@@ -41877,33 +42617,313 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Retrieve Product Hunt product launches",
+        "summary": "Retrieve Product Hunt product launches",
+        "tags": [
+          "ProductHunt"
+        ]
+      }
+    },
+    "/producthunt/product/{id}/makers": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns maker items for a Product Hunt product.",
+        "operationId": "producthunt-makers",
+        "parameters": [
+          {
+            "description": "Product Hunt slug",
+            "example": "\"clico\"",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Pagination cursor",
+            "in": "query",
+            "name": "cursor",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped makers payload",
+            "schema": {
+              "$ref": "#/definitions/producthunt.makersResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Missing or invalid parameters",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Product not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Rate limit exceeded",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve Product Hunt product makers",
+        "tags": [
+          "ProductHunt"
+        ]
+      }
+    },
+    "/producthunt/product/{id}/reviews": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns detailed review items for a Product Hunt product.",
+        "operationId": "producthunt-reviews",
+        "parameters": [
+          {
+            "description": "Product Hunt slug",
+            "example": "\"clico\"",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped detailed reviews payload",
+            "schema": {
+              "$ref": "#/definitions/producthunt.reviewsResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Missing or invalid parameters",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Product not found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Rate limit exceeded",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Retrieve Product Hunt product detailed reviews",
+        "tags": [
+          "ProductHunt"
+        ]
+      }
+    },
+    "/producthunt/search": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Performs a full-text Product Hunt search and returns matching products, users, or launches.",
+        "operationId": "producthunt-search",
+        "parameters": [
+          {
+            "description": "Search keywords",
+            "example": "\"ai\"",
+            "in": "query",
+            "name": "query",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "product",
+            "description": "Result type: **product** (default), **user**, or **launch**",
+            "enum": [
+              "product",
+              "user",
+              "launch"
+            ],
+            "in": "query",
+            "name": "type",
+            "type": "string"
+          },
+          {
+            "description": "Page number (1-based)",
+            "example": 2,
+            "in": "query",
+            "minimum": 1,
+            "name": "page",
+            "type": "integer"
+          },
+          {
+            "default": false,
+            "description": "Launch search only: featured launches only",
+            "in": "query",
+            "name": "featured",
+            "type": "boolean"
+          },
+          {
+            "description": "Launch search only: comma-separated topic slugs",
+            "example": "ai-chatbots,chrome-extensions",
+            "in": "query",
+            "name": "topics",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Wrapped search payload (map[string]any)",
+            "schema": {
+              "$ref": "#/definitions/producthunt.searchResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Missing or invalid parameters",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "No results found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Rate limit exceeded",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Search for products, users, or launches on Product Hunt",
         "tags": [
           "ProductHunt"
         ]
       }
     },
-    "/producthunt/product/{id}/makers": {
+    "/ready": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns maker items for a Product Hunt product.",
-        "operationId": "producthunt-makers",
+        "description": "Returns process readiness and lightweight dependency health. Root `/ready` returns the same payload as a compatibility alias, while `/ping` remains the lightweight liveness endpoint.",
+        "operationId": "ready",
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/api.readinessResponseDoc"
+            }
+          },
+          "503": {
+            "description": "Service Unavailable",
+            "schema": {
+              "$ref": "#/definitions/api.readinessResponseDoc"
+            }
+          }
+        },
+        "summary": "Return API readiness",
+        "tags": [
+          "Meta"
+        ]
+      }
+    },
+    "/reddit/comments/{id}": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns flat public comment entries from a Reddit post.",
+        "operationId": "reddit-comments",
         "parameters": [
           {
-            "description": "Product Hunt slug",
-            "example": "\"clico\"",
+            "description": "Reddit post id or t3_ id",
             "in": "path",
             "name": "id",
             "required": true,
             "type": "string"
           },
           {
-            "description": "Pagination cursor",
+            "default": "confidence",
+            "description": "Accepted for compatibility: confidence, top, new, controversial, old, or qa. Public comment data is flat and may ignore sort.",
+            "enum": [
+              "confidence",
+              "top",
+              "new",
+              "controversial",
+              "old",
+              "qa"
+            ],
             "in": "query",
-            "name": "cursor",
+            "name": "sort",
             "type": "string"
+          },
+          {
+            "description": "Maximum comments returned, defaults to 25 and clamps to 100",
+            "in": "query",
+            "name": "limit",
+            "type": "integer"
+          },
+          {
+            "default": 3,
+            "description": "Accepted for compatibility. Public comment data is flat and may ignore depth.",
+            "in": "query",
+            "name": "depth",
+            "type": "integer"
           }
         ],
         "produces": [
@@ -41911,31 +42931,31 @@
         ],
         "responses": {
           "200": {
-            "description": "Wrapped makers payload",
+            "description": "OK",
             "schema": {
-              "$ref": "#/definitions/producthunt.makersResponseDoc"
+              "$ref": "#/definitions/reddit.commentsResponseDoc"
             }
           },
           "400": {
-            "description": "Missing or invalid parameters",
+            "description": "Bad Request",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "404": {
-            "description": "Product not found",
+            "description": "Not Found",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "429": {
-            "description": "Rate limit exceeded",
+            "description": "Too Many Requests",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "503": {
+            "description": "Service Unavailable",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -41946,23 +42966,22 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Retrieve Product Hunt product makers",
+        "summary": "Get Reddit post comments",
         "tags": [
-          "ProductHunt"
+          "Reddit"
         ]
       }
     },
-    "/producthunt/product/{id}/reviews": {
+    "/reddit/post/{id}": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns detailed review items for a Product Hunt product.",
-        "operationId": "producthunt-reviews",
+        "description": "Returns a normalized public Reddit post entry.",
+        "operationId": "reddit-post",
         "parameters": [
           {
-            "description": "Product Hunt slug",
-            "example": "\"clico\"",
+            "description": "Reddit post id or t3_ id",
             "in": "path",
             "name": "id",
             "required": true,
@@ -41974,31 +42993,31 @@
         ],
         "responses": {
           "200": {
-            "description": "Wrapped detailed reviews payload",
+            "description": "OK",
             "schema": {
-              "$ref": "#/definitions/producthunt.reviewsResponseDoc"
+              "$ref": "#/definitions/reddit.postResponseDoc"
             }
           },
           "400": {
-            "description": "Missing or invalid parameters",
+            "description": "Bad Request",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "404": {
-            "description": "Product not found",
+            "description": "Not Found",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "429": {
-            "description": "Rate limit exceeded",
+            "description": "Too Many Requests",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "503": {
+            "description": "Service Unavailable",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -42009,60 +43028,71 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Retrieve Product Hunt product detailed reviews",
+        "summary": "Get Reddit post",
         "tags": [
-          "ProductHunt"
+          "Reddit"
         ]
       }
     },
-    "/producthunt/search": {
+    "/reddit/search": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Performs a full-text Product Hunt search and returns matching products, users, or launches.",
-        "operationId": "producthunt-search",
+        "description": "Searches public Reddit content and returns normalized public post entries.",
+        "operationId": "reddit-search",
         "parameters": [
           {
             "description": "Search keywords",
-            "example": "\"ai\"",
             "in": "query",
-            "name": "query",
+            "name": "q",
             "required": true,
             "type": "string"
           },
           {
-            "default": "product",
-            "description": "Result type: **product** (default), **user**, or **launch**",
+            "description": "Restrict search to a subreddit name, without r/",
+            "in": "query",
+            "name": "subreddit",
+            "type": "string"
+          },
+          {
+            "default": "relevance",
+            "description": "Sort: relevance, hot, new, top, or comments",
             "enum": [
-              "product",
-              "user",
-              "launch"
+              "relevance",
+              "hot",
+              "new",
+              "top",
+              "comments"
             ],
             "in": "query",
-            "name": "type",
+            "name": "sort",
             "type": "string"
           },
           {
-            "description": "Page number (1-based)",
-            "example": 2,
+            "description": "Time window for top/comments sorts: hour, day, week, month, year, or all",
+            "enum": [
+              "hour",
+              "day",
+              "week",
+              "month",
+              "year",
+              "all"
+            ],
             "in": "query",
-            "minimum": 1,
-            "name": "page",
-            "type": "integer"
+            "name": "time",
+            "type": "string"
           },
           {
-            "default": false,
-            "description": "Launch search only: featured launches only",
+            "description": "Maximum posts, defaults to 25 and clamps to 100",
             "in": "query",
-            "name": "featured",
-            "type": "boolean"
+            "name": "limit",
+            "type": "integer"
           },
           {
-            "description": "Launch search only: comma-separated topic slugs",
-            "example": "ai-chatbots,chrome-extensions",
+            "description": "Reddit pagination token",
             "in": "query",
-            "name": "topics",
+            "name": "after",
             "type": "string"
           }
         ],
@@ -42071,31 +43101,31 @@
         ],
         "responses": {
           "200": {
-            "description": "Wrapped search payload (map[string]any)",
+            "description": "OK",
             "schema": {
-              "$ref": "#/definitions/producthunt.searchResponseDoc"
+              "$ref": "#/definitions/reddit.searchResponseDoc"
             }
           },
           "400": {
-            "description": "Missing or invalid parameters",
+            "description": "Bad Request",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "404": {
-            "description": "No results found",
+            "description": "Not Found",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
           "429": {
-            "description": "Rate limit exceeded",
+            "description": "Too Many Requests",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "503": {
+            "description": "Service Unavailable",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -42106,19 +43136,67 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Search for products, users, or launches on Product Hunt",
+        "summary": "Search Reddit posts",
         "tags": [
-          "ProductHunt"
+          "Reddit"
         ]
       }
     },
-    "/ready": {
+    "/reddit/subreddit/{subreddit}/posts": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns process readiness and lightweight dependency health. Root `/ready` returns the same payload as a compatibility alias, while `/ping` remains the lightweight liveness endpoint.",
-        "operationId": "ready",
+        "description": "Returns normalized public posts from a subreddit.",
+        "operationId": "reddit-subreddit-posts",
+        "parameters": [
+          {
+            "description": "Subreddit name, without r/",
+            "in": "path",
+            "name": "subreddit",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "hot",
+            "description": "Sort: hot, new, top, or rising",
+            "enum": [
+              "hot",
+              "new",
+              "top",
+              "rising"
+            ],
+            "in": "query",
+            "name": "sort",
+            "type": "string"
+          },
+          {
+            "description": "Time window for top sort: hour, day, week, month, year, or all",
+            "enum": [
+              "hour",
+              "day",
+              "week",
+              "month",
+              "year",
+              "all"
+            ],
+            "in": "query",
+            "name": "time",
+            "type": "string"
+          },
+          {
+            "description": "Maximum posts, defaults to 25 and clamps to 100",
+            "in": "query",
+            "name": "limit",
+            "type": "integer"
+          },
+          {
+            "description": "Reddit pagination token",
+            "in": "query",
+            "name": "after",
+            "type": "string"
+          }
+        ],
         "produces": [
           "application/json"
         ],
@@ -42126,19 +43204,42 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/api.readinessResponseDoc"
+              "$ref": "#/definitions/reddit.subredditPostsResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Too Many Requests",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
             }
           },
           "503": {
             "description": "Service Unavailable",
             "schema": {
-              "$ref": "#/definitions/api.readinessResponseDoc"
+              "$ref": "#/definitions/app.Response"
             }
           }
         },
-        "summary": "Return API readiness",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "List Reddit subreddit posts",
         "tags": [
-          "Meta"
+          "Reddit"
         ]
       }
     },
@@ -50467,7 +51568,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's endpoint usage breakdown",
@@ -50543,7 +51644,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's usage overview",
@@ -50627,7 +51728,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's recent API client IPs",
@@ -50720,7 +51821,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's usage timeseries",
@@ -51196,6 +52297,96 @@
         ]
       }
     },
+    "/yahoo-finance/lookup": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns Yahoo Finance instrument matches for a query, optionally filtered by instrument type.",
+        "operationId": "yahoo-finance-lookup",
+        "parameters": [
+          {
+            "description": "Ticker symbol or company name",
+            "in": "query",
+            "name": "query",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Instrument type filter",
+            "enum": [
+              "all",
+              "equity",
+              "etf",
+              "mutualfund",
+              "index",
+              "future",
+              "currency",
+              "cryptocurrency"
+            ],
+            "in": "query",
+            "name": "type",
+            "type": "string"
+          },
+          {
+            "description": "Result count",
+            "in": "query",
+            "name": "count",
+            "type": "integer"
+          },
+          {
+            "description": "Result offset",
+            "in": "query",
+            "name": "start",
+            "type": "integer"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/yahoofinance.lookupResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "503": {
+            "description": "Service Unavailable",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Yahoo Finance lookup",
+        "tags": [
+          "Yahoo Finance"
+        ]
+      }
+    },
     "/yahoo-finance/market/{market}/status": {
       "get": {
         "consumes": [