@crawlora-org/sdk 1.5.0-sdk.3 → 1.6.0-sdk.3

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": {
@@ -8482,6 +8752,53 @@
       },
       "type": "object"
     },
+    "google.NewsResponse": {
+      "properties": {
+        "pagination": {
+          "$ref": "#/definitions/google.VerticalPagination"
+        },
+        "results": {
+          "items": {
+            "$ref": "#/definitions/google.NewsResult"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "google.NewsResult": {
+      "properties": {
+        "age": {
+          "example": "2 hours ago",
+          "type": "string"
+        },
+        "description": {
+          "example": "OpenAI announced an update.",
+          "type": "string"
+        },
+        "position": {
+          "example": 1,
+          "type": "integer"
+        },
+        "source": {
+          "example": "Example News",
+          "type": "string"
+        },
+        "thumbnail": {
+          "example": "https://example.com/thumb.jpg",
+          "type": "string"
+        },
+        "title": {
+          "example": "OpenAI announces update",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://example.com/openai-news",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "google.PeopleAlsoAskItem": {
       "properties": {
         "answer": {
@@ -8728,6 +9045,74 @@
       },
       "type": "object"
     },
+    "google.VerticalPagination": {
+      "properties": {
+        "next_page": {
+          "example": 2,
+          "type": "integer"
+        },
+        "page": {
+          "example": 1,
+          "type": "integer"
+        },
+        "previous_page": {
+          "example": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "google.VideoResult": {
+      "properties": {
+        "age": {
+          "example": "2 days ago",
+          "type": "string"
+        },
+        "description": {
+          "example": "Watch the OpenAI DevDay keynote.",
+          "type": "string"
+        },
+        "duration": {
+          "example": "45:12",
+          "type": "string"
+        },
+        "platform": {
+          "example": "YouTube",
+          "type": "string"
+        },
+        "position": {
+          "example": 1,
+          "type": "integer"
+        },
+        "thumbnail": {
+          "example": "https://example.com/thumb.jpg",
+          "type": "string"
+        },
+        "title": {
+          "example": "OpenAI DevDay keynote - YouTube",
+          "type": "string"
+        },
+        "url": {
+          "example": "https://www.youtube.com/watch?v=openai-devday",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "google.VideosResponse": {
+      "properties": {
+        "pagination": {
+          "$ref": "#/definitions/google.VerticalPagination"
+        },
+        "results": {
+          "items": {
+            "$ref": "#/definitions/google.VideoResult"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "google.mapPlaceResponseDoc": {
       "properties": {
         "code": {
@@ -8763,6 +9148,22 @@
       },
       "type": "object"
     },
+    "google.newsResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/google.NewsResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "google.searchResponseDoc": {
       "properties": {
         "code": {
@@ -8795,6 +9196,22 @@
       },
       "type": "object"
     },
+    "google.videosResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/google.VideosResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "googleplay.App": {
       "properties": {
         "ad_supported": {
@@ -15540,6 +15957,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 +26738,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 +27352,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": {
@@ -30994,22 +31789,122 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Search Bing news results",
+        "summary": "Search Bing news results",
+        "tags": [
+          "Bing"
+        ]
+      }
+    },
+    "/bing/search": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns normalized Bing web search results for a query string, including organic results, optional context panel data, related queries, people-also-ask questions, news modules, video modules, and page-based pagination. Empty optional blocks are omitted from the JSON response. Locale defaults to country=us and lang=en-us. Results are fetched with the repo's Chrome-impersonated request client and return 503 when Bing serves a challenge page or unusable HTML.",
+        "operationId": "bing-search",
+        "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.searchResponseDoc"
+            }
+          },
+          "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 web results",
         "tags": [
           "Bing"
         ]
       }
     },
-    "/bing/search": {
+    "/bing/suggest": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns normalized Bing web search results for a query string, including organic results, optional context panel data, related queries, people-also-ask questions, news modules, video modules, and page-based pagination. Empty optional blocks are omitted from the JSON response. Locale defaults to country=us and lang=en-us. Results are fetched with the repo's Chrome-impersonated request client and return 503 when Bing serves a challenge page or unusable HTML.",
-        "operationId": "bing-search",
+        "description": "Returns Bing autosuggest query completions for a query prefix. Locale defaults to country=us and lang=en-us. Suggestions are fetched from public Bing suggest endpoints and trimmed to the requested count.",
+        "operationId": "bing-suggest",
         "parameters": [
           {
-            "description": "Search query",
+            "description": "Search query prefix",
             "example": "openai",
             "in": "query",
             "name": "q",
@@ -31017,18 +31912,10 @@
             "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",
+            "description": "Suggestions to return; defaults to 10, clamped to 1..12",
             "example": 10,
             "in": "query",
-            "maximum": 50,
+            "maximum": 12,
             "minimum": 1,
             "name": "count",
             "type": "integer"
@@ -31055,7 +31942,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/bing.searchResponseDoc"
+              "$ref": "#/definitions/bing.suggestResponseDoc"
             }
           },
           "400": {
@@ -31064,12 +31951,6 @@
               "$ref": "#/definitions/app.Response"
             }
           },
-          "404": {
-            "description": "No results found",
-            "schema": {
-              "$ref": "#/definitions/app.Response"
-            }
-          },
           "429": {
             "description": "Rate limit exceeded",
             "schema": {
@@ -31094,22 +31975,22 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Search Bing web results",
+        "summary": "Suggest Bing search queries",
         "tags": [
           "Bing"
         ]
       }
     },
-    "/bing/suggest": {
+    "/bing/videos": {
       "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns Bing autosuggest query completions for a query prefix. Locale defaults to country=us and lang=en-us. Suggestions are fetched from public Bing suggest endpoints and trimmed to the requested count.",
-        "operationId": "bing-suggest",
+        "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 prefix",
+            "description": "Search query",
             "example": "openai",
             "in": "query",
             "name": "q",
@@ -31117,10 +31998,18 @@
             "type": "string"
           },
           {
-            "description": "Suggestions to return; defaults to 10, clamped to 1..12",
+            "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": 12,
+            "maximum": 50,
             "minimum": 1,
             "name": "count",
             "type": "integer"
@@ -31147,7 +32036,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/bing.suggestResponseDoc"
+              "$ref": "#/definitions/bing.videosResponseDoc"
             }
           },
           "400": {
@@ -31156,6 +32045,12 @@
               "$ref": "#/definitions/app.Response"
             }
           },
+          "404": {
+            "description": "No results found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
           "429": {
             "description": "Rate limit exceeded",
             "schema": {
@@ -31180,58 +32075,50 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Suggest Bing search queries",
+        "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 +32128,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 +32167,9 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Search Bing video results",
+        "summary": "Retrieve brand data by domain",
         "tags": [
-          "Bing"
+          "Brand"
         ]
       }
     },
@@ -37130,6 +38017,100 @@
         ]
       }
     },
+    "/google/news": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns normalized Google News vertical results (title, source, link, age) parsed from the public Google News results page. Locale defaults to country=us and lang=en. Returns 503 when Google serves a challenge page or unusable HTML.",
+        "operationId": "google-news",
+        "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": "Google UI language; defaults to en",
+            "example": "en",
+            "in": "query",
+            "name": "lang",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/google.newsResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Missing or invalid query parameters",
+            "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": "Google upstream request failed",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Search Google News",
+        "tags": [
+          "Google"
+        ]
+      }
+    },
     "/google/search": {
       "post": {
         "consumes": [
@@ -38192,28 +39173,122 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Google Trends trending now data",
+        "summary": "Google Trends trending now data",
+        "tags": [
+          "Google"
+        ]
+      }
+    },
+    "/google/trends/trending/detail": {
+      "post": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns the Explore detail widgets for a single trending term, including interest over time, regional interest, top/rising related queries, and related topics when Google returns them.",
+        "operationId": "google-trends-trending-detail",
+        "parameters": [
+          {
+            "description": "Trending detail request",
+            "in": "body",
+            "name": "request",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/trends.TrendingDetailRequest"
+            }
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/trends.exploreResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Invalid input",
+            "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": "Google Trends upstream request failed",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Google Trends trending term detail",
         "tags": [
           "Google"
         ]
       }
     },
-    "/google/trends/trending/detail": {
-      "post": {
+    "/google/videos": {
+      "get": {
         "consumes": [
           "application/json"
         ],
-        "description": "Returns the Explore detail widgets for a single trending term, including interest over time, regional interest, top/rising related queries, and related topics when Google returns them.",
-        "operationId": "google-trends-trending-detail",
+        "description": "Returns normalized Google video vertical results (title, platform, link, duration, age) parsed from the public Google video results page. Locale defaults to country=us and lang=en. Returns 503 when Google serves a challenge page or unusable HTML.",
+        "operationId": "google-videos",
         "parameters": [
           {
-            "description": "Trending detail request",
-            "in": "body",
-            "name": "request",
+            "description": "Search query",
+            "example": "openai",
+            "in": "query",
+            "name": "q",
             "required": true,
-            "schema": {
-              "$ref": "#/definitions/trends.TrendingDetailRequest"
-            }
+            "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": "Google UI language; defaults to en",
+            "example": "en",
+            "in": "query",
+            "name": "lang",
+            "type": "string"
           }
         ],
         "produces": [
@@ -38223,11 +39298,11 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/trends.exploreResponseDoc"
+              "$ref": "#/definitions/google.videosResponseDoc"
             }
           },
           "400": {
-            "description": "Invalid input",
+            "description": "Missing or invalid query parameters",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -38245,7 +39320,7 @@
             }
           },
           "503": {
-            "description": "Google Trends upstream request failed",
+            "description": "Google upstream request failed",
             "schema": {
               "$ref": "#/definitions/app.Response"
             }
@@ -38256,7 +39331,7 @@
             "ApiKeyAuth": []
           }
         ],
-        "summary": "Google Trends trending term detail",
+        "summary": "Search Google video results",
         "tags": [
           "Google"
         ]
@@ -41877,33 +42952,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 +43266,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 +43301,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 +43328,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 +43363,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 +43436,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 +43471,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 +43539,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 +51903,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's endpoint usage breakdown",
@@ -50543,7 +51979,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's usage overview",
@@ -50627,7 +52063,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's recent API client IPs",
@@ -50720,7 +52156,7 @@
         },
         "security": [
           {
-            "JWTAuth": []
+            "ApiKeyAuth": []
           }
         ],
         "summary": "Get current user's usage timeseries",
@@ -51196,6 +52632,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": [