Hi, could anybody give a sample usage about the snapshot API (https://developers.cloudflare.com/api

Hi, could anybody give a sample usage about the snapshot API (https://developers.cloudflare.com/api/python/resources/browser_rendering/subresources/snapshot/methods/create/) ?
I wanna add the "full_page" and "type" to request, but I always get a error:

I have tried these 2 request body ,but not work either:

{
    "url": "https://www.bbc.com/",
    "screenshot_options":  {"full_page" : true , "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "screenshot_options":  {"full_page" : true , "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "screenshot_options":  {"full_page" : true , "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "screenshot_options":  {"full_page" : true , "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "full_page" : true , 
    "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "full_page" : true , 
    "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "full_page" : true , 
    "type":"webp" }
  }

{
    "url": "https://www.bbc.com/",
    "full_page" : true , 
    "type":"webp" }
  }

I got this error:

{
    "errors": [
        {
            "code": "unrecognized_keys",
            "keys": [
                "screenshot_options"
            ],
            "path": [
                "body"
            ],
            "message": "Unrecognized key(s) in object: 'screenshot_options'"
        }
    ],
    "success": false,
    "result": {}
}

{
    "errors": [
        {
            "code": "unrecognized_keys",
            "keys": [
                "screenshot_options"
            ],
            "path": [
                "body"
            ],
            "message": "Unrecognized key(s) in object: 'screenshot_options'"
        }
    ],
    "success": false,
    "result": {}
}

{
    "errors": [
        {
            "code": "unrecognized_keys",
            "keys": [
                "screenshot_options"
            ],
            "path": [
                "body"
            ],
            "message": "Unrecognized key(s) in object: 'screenshot_options'"
        }
    ],
    "success": false,
    "result": {}
}

{
    "errors": [
        {
            "code": "unrecognized_keys",
            "keys": [
                "screenshot_options"
            ],
            "path": [
                "body"
            ],
            "message": "Unrecognized key(s) in object: 'screenshot_options'"
        }
    ],
    "success": false,
    "result": {}
}

How should I fix it ? Thanks

Cloudflare API | Browser Rendering › Snapshot › create

Interact with Cloudflare's products and services via the Cloudflare API

hunterleung.OP•11/28/25, 3:31 AM

@Kathy hi,Kathy , could you help me ?

Hhunterleung.Hi, could anybody give a sample usage about the snapshot API (https://developer...

Gibbeth•11/28/25, 3:35 AM

you're running POST @ /accounts/{account_id}/browser-rendering/snapshot right?

Gibbeth•11/28/25, 3:36 AM

based on the docs ur i think the first example should be the functioning one

GGibbeth you're running POST @ /accounts/{account_id}/browser-rendering/snapshot right?

hunterleung.OP•11/28/25, 4:10 AM

I see, what happend. "screenshot_options" should be "screenshotOptions"

Hhunterleung.I see, what happend. "screenshot_options" should be "screenshotOptions"

Gibbeth•11/28/25, 4:57 AM

huh, that's weird. that wasn't very clear in the docs

Gibbeth•11/28/25, 4:58 AM

i was super confused bc to me scerenshot_options should've worked

Hhunterleung.I see, what happend. "screenshot_options" should be "screenshotOptions"

Kathy•12/1/25, 6:03 PM

think issue might have been you were in python docs so you got screenshot_optionsscreenshot_options instead of screenshotOptionsscreenshotOptions

Ccosmo Hello! I'm testing this amazing API and I just found a bug. My total usage is l...

Kathy•12/1/25, 6:03 PM

can you dm me your account id

welz•12/4/25, 3:52 PM

What does this mean?

Unable to connect to existing session <uuid> (it may still be in use or not ready yet) - retry or launch a new browser: TargetCloseError: Protocol error (Browser.getVersion): Target closed

Unable to connect to existing session <uuid> (it may still be in use or not ready yet) - retry or launch a new browser: TargetCloseError: Protocol error (Browser.getVersion): Target closed

I'm seeing this periodically (and inconsistently) on browser launch.

Wwelz What does this mean? ``` Unable to connect to existing session <uuid> (it may st...

Kathy•12/4/25, 9:09 PM

from a quick perusal, we don't see that error in our logs. are you sure that's from us?

KKathy from a quick perusal, we don't see that error in our logs. are you sure that's f...

welz•12/5/25, 8:42 AM

It's definitely coming from Browser Rendering - the uuid also matches up with my BR logs. I'm invoking using await puppeteer.launch(env.BROWSER)await puppeteer.launch(env.BROWSER) so it shouldn't even be trying to connect to an existing session.

TheCrazyBob•12/6/25, 8:30 PM

The cacheTTLcacheTTL parameter doesn't seem to work. The request still gets cached, and I keep getting the same response even after waiting for a few minutes. Can someone look into this?

1984 Ford Laser•12/9/25, 1:14 AM

Im still having issues accessing the Browser Rendering REST API, every request returns a Not Found.Not Found. response. I have Workers Paid and have tried both an Account API Token and User API Token with Edit access to the Browser Rendering perm. Any ideas to try?

11984 Ford Laser Im still having issues accessing the Browser Rendering REST API, every request r...

Kathy•12/9/25, 1:16 AM

dm me your account id please

KKathy dm me your account id please

1984 Ford Laser•12/9/25, 1:17 AM

Done

1984 Ford Laser•12/9/25, 1:23 AM

To add, I just set up a quick test Worker and the Worker Binding for this seems to work fine

Ray Li•12/15/25, 5:02 PM

Is browser rendering == CF container+ playwright?

Hi, could anybody give a sample usage about the snapshot API (https://developers.cloudflare.com/api

Similar Threads