feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 38
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-2f28cd1bf5b88305989d68dc55037fe25bdba2800d61c071a848cc1eb1ccb225.yml
-openapi_spec_hash: 6dd2807c7804e08c1d49479c0ff82e47
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-c1b6ca84f9bec1b1936cebb61f058924c3d7a5f6977e4cd76cf0544c4c7d8737.yml
+openapi_spec_hash: 141bfa8430ddccfb5a37c4bd703d163b
 config_hash: bff282047fafdad771fb7ec685f56944

src/context/dev/resources/web.py

@@ -2047,6 +2047,18 @@ def web_scrape_md(
         responses from a recognized API key; use error_code to distinguish stable
         failure categories.
 
+        ### YouTube
+
+        YouTube URLs return the video or channel itself rather than the surrounding
+        player and navigation chrome. A URL addressing a single video (`/watch`,
+        `youtu.be`, `/shorts`, `/embed`, `/live`) returns its title, channel, duration,
+        view count, keywords, full description, and the transcript when the video has
+        captions that can be retrieved; videos without captions return everything except
+        the transcript. A channel URL (`/channel/UC…`, `/@handle`, `/c/…`, `/user/…`)
+        returns its name, handle, subscriber count, video count, and full description.
+        When `includeImages=true`, video responses also include the thumbnail and
+        channel responses include the avatar. Costs the same as any other scrape.
+
         ### Billing & errors
 
         | HTTP status | Billed?                                   | Meaning                                                                                  |
@@ -4259,6 +4271,18 @@ async def web_scrape_md(
         responses from a recognized API key; use error_code to distinguish stable
         failure categories.
 
+        ### YouTube
+
+        YouTube URLs return the video or channel itself rather than the surrounding
+        player and navigation chrome. A URL addressing a single video (`/watch`,
+        `youtu.be`, `/shorts`, `/embed`, `/live`) returns its title, channel, duration,
+        view count, keywords, full description, and the transcript when the video has
+        captions that can be retrieved; videos without captions return everything except
+        the transcript. A channel URL (`/channel/UC…`, `/@handle`, `/c/…`, `/user/…`)
+        returns its name, handle, subscriber count, video count, and full description.
+        When `includeImages=true`, video responses also include the thumbnail and
+        channel responses include the avatar. Costs the same as any other scrape.
+
         ### Billing & errors
 
         | HTTP status | Billed?                                   | Meaning                                                                                  |

src/context/dev/types/web_search_response.py

@@ -11,7 +11,7 @@
 class ResultMarkdown(BaseModel):
     """Markdown scrape status and content for this result."""
 
-    code: Literal["SUCCESS", "NOT_REQUESTED", "TIMEOUT", "WEBSITE_ACCESS_ERROR", "ERROR"]
+    code: Literal["SUCCESS", "NOT_REQUESTED", "TIMEOUT", "CONTENT_TOO_LARGE", "WEBSITE_ACCESS_ERROR", "ERROR"]
     """Per-result scrape outcome. Inspect this before reading `markdown`."""
 
     markdown: Optional[str] = None