add resulting url

Dockers/puppeteer-api/app/routes/browser.py

@@ -44,9 +44,9 @@ class Viewport(BaseModel):
 
 class InteractionsRequest(BaseModel):
     url: str = Field(..., description="Target URL (will be URL-decoded server-side).")
-    returnType: Optional[Literal["screenshot", "html"]] = Field(
+    returnType: Optional[Literal["screenshot", "html", "resulting_url"]] = Field(
         "screenshot",
-        description="Return a PNG screenshot or HTML content.",
+        description="Return a PNG screenshot, HTML content, or the resulting URL after interactions.",
     )
     viewport: Optional[Viewport] = None
     scrollX: Optional[int] = None
@@ -124,7 +124,8 @@ async def screenshot_url(url: str, fullPage: bool = True, x_api_key: Optional[st
     description=(
         "Run a sequence of interactions (click/type) on a page.\n\n"
         "- `returnType=screenshot` returns `image/png`\n"
-        "- `returnType=html` returns `text/html`"
+        "- `returnType=html` returns `text/html`\n"
+        "- `returnType=resulting_url` returns `application/json` with the final URL"
     ),
     responses={
         200: {
@@ -158,6 +159,11 @@ async def run_interactions(payload: InteractionsRequest, x_api_key: Optional[str
         if isinstance(result, dict) and result.get("status") == "error":
             raise HTTPException(status_code=500, detail=result.get("error", "Interaction failed"))
 
+        if return_type == "resulting_url":
+            if not isinstance(result, dict):
+                raise HTTPException(status_code=500, detail="Unexpected resulting_url response")
+            return result
+
         if return_type == "html":
             if not isinstance(result, str):
                 raise HTTPException(status_code=500, detail="Unexpected HTML response")

Dockers/puppeteer-api/app/services/browser.py

@@ -183,7 +183,7 @@ async def interactions_service(
     scroll_x: int | None = None,
     scroll_y: int | None = None,
 ):
-    """Open `decoded_url`, execute click/type interactions in order, then return screenshot or HTML."""
+    """Open `decoded_url`, execute click/type interactions in order, then return screenshot, HTML, or resulting_url."""
     print(f"Running interactions on {decoded_url} (return_type={return_type})")
 
     async def interactions_operation(page):
@@ -392,6 +392,15 @@ async def interactions_service(
                 except Exception:
                     pass
 
+            if return_type == "resulting_url":
+                final_url = unquote(page.url or "")
+                return {
+                    "status": "success",
+                    "original_url": decoded_url,
+                    "resulting_url": final_url,
+                    "redirected": final_url != decoded_url,
+                }
+
             if return_type == "html":
                 return await page.content()