---
title: Get HTML content.
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api/go)
[Browser Rendering](https://developers.cloudflare.com/api/go/resources/browser_rendering)
[Content](https://developers.cloudflare.com/api/go/resources/browser_rendering/subresources/content)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Get HTML content.
client.BrowserRendering.Content.New(ctx, params) (\*string, error)
POST/accounts/{account\_id}/browser-rendering/content
Fetches rendered HTML content from provided URL or HTML. Check available options like `gotoOptions` and `waitFor*` to control page load behaviour.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Browser Rendering Write`
##### ParametersExpand Collapse
params ContentNewParams
AccountID param.Field\[string]
Path param: Account ID.
Link to this property
URL param.Field\[string]
Body param
Link to this property
Browser param.Field\[ContentNewParamsVariant0Browser]Optional
Query param: Rendering backend. Set to kitesurf to use Kitesurf (beta).
const ContentNewParamsVariant0BrowserKitesurf ContentNewParamsVariant0Browser = "kitesurf"
Link to this property
Link to this property
CacheTTL param.Field\[float64]Optional
Query param: Cache TTL default is 5s. Set to 0 to disable.
maximum86400
minimum0
Link to this property
ActionTimeout param.Field\[float64]Optional
Body param: The maximum duration allowed for the browser action to complete after the page has loaded (such as taking screenshots, extracting content, or generating PDFs). If this time limit is exceeded, the action stops and returns a timeout error.
maximum120000
Link to this property
AddScriptTag param.Field\[\[]ContentNewParamsVariant0AddScriptTag]Optional
Body param: Adds a script element into the page with the desired URL or content.
ID stringOptional
Link to this property
Content stringOptional
Link to this property
Type stringOptional
Link to this property
URL stringOptional
formaturi
Link to this property
Link to this property
AddStyleTag param.Field\[\[]ContentNewParamsVariant0AddStyleTag]Optional
Body param: Adds a <link rel="stylesheet"> tag into the page with the desired URL or a <style type="text/css"> tag with the content.
Content stringOptional
Link to this property
URL stringOptional
formaturi
Link to this property
Link to this property
AllowRequestPattern param.Field\[\[]string]Optional
Body param: Only allow requests that match the provided regex patterns, eg. ’/^.\*.(css)’. Reject rules are applied first.
Link to this property
AllowResourceTypes param.Field\[\[]ContentNewParamsVariant0AllowResourceType]Optional
Body param: Only allow requests that match the provided resource types, eg. ‘image’ or ‘script’. Reject rules are applied first.
const ContentNewParamsVariant0AllowResourceTypeDocument ContentNewParamsVariant0AllowResourceType = "document"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeStylesheet ContentNewParamsVariant0AllowResourceType = "stylesheet"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeImage ContentNewParamsVariant0AllowResourceType = "image"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeMedia ContentNewParamsVariant0AllowResourceType = "media"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeFont ContentNewParamsVariant0AllowResourceType = "font"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeScript ContentNewParamsVariant0AllowResourceType = "script"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeTexttrack ContentNewParamsVariant0AllowResourceType = "texttrack"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeXHR ContentNewParamsVariant0AllowResourceType = "xhr"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeFetch ContentNewParamsVariant0AllowResourceType = "fetch"
Link to this property
const ContentNewParamsVariant0AllowResourceTypePrefetch ContentNewParamsVariant0AllowResourceType = "prefetch"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeEventsource ContentNewParamsVariant0AllowResourceType = "eventsource"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeWebsocket ContentNewParamsVariant0AllowResourceType = "websocket"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeManifest ContentNewParamsVariant0AllowResourceType = "manifest"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeSignedexchange ContentNewParamsVariant0AllowResourceType = "signedexchange"
Link to this property
const ContentNewParamsVariant0AllowResourceTypePing ContentNewParamsVariant0AllowResourceType = "ping"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeCspviolationreport ContentNewParamsVariant0AllowResourceType = "cspviolationreport"
Link to this property
const ContentNewParamsVariant0AllowResourceTypePreflight ContentNewParamsVariant0AllowResourceType = "preflight"
Link to this property
const ContentNewParamsVariant0AllowResourceTypeOther ContentNewParamsVariant0AllowResourceType = "other"
Link to this property
Link to this property
Authenticate param.Field\[ContentNewParamsVariant0Authenticate]Optional
Body param: Provide credentials for HTTP authentication.
Password string
minLength1
Link to this property
Username string
minLength1
Link to this property
Link to this property
BestAttempt param.Field\[bool]Optional
Body param: Attempt to proceed when ‘awaited’ events fail or timeout.
Link to this property
Cookies param.Field\[\[]ContentNewParamsVariant0Cookie]Optional
Body param: Check options.
Name string
Cookie name.
Link to this property
Value string
Link to this property
Domain stringOptional
Link to this property
Expires float64Optional
Link to this property
HTTPOnly boolOptional
Link to this property
PartitionKey stringOptional
Link to this property
Path stringOptional
Link to this property
Priority ContentNewParamsVariant0CookiesPriorityOptional
One of the following:
const ContentNewParamsVariant0CookiesPriorityLow ContentNewParamsVariant0CookiesPriority = "Low"
Link to this property
const ContentNewParamsVariant0CookiesPriorityMedium ContentNewParamsVariant0CookiesPriority = "Medium"
Link to this property
const ContentNewParamsVariant0CookiesPriorityHigh ContentNewParamsVariant0CookiesPriority = "High"
Link to this property
Link to this property
SameParty boolOptional
Link to this property
SameSite ContentNewParamsVariant0CookiesSameSiteOptional
One of the following:
const ContentNewParamsVariant0CookiesSameSiteStrict ContentNewParamsVariant0CookiesSameSite = "Strict"
Link to this property
const ContentNewParamsVariant0CookiesSameSiteLax ContentNewParamsVariant0CookiesSameSite = "Lax"
Link to this property
const ContentNewParamsVariant0CookiesSameSiteNone ContentNewParamsVariant0CookiesSameSite = "None"
Link to this property
Link to this property
Secure boolOptional
Link to this property
SourcePort float64Optional
Link to this property
SourceScheme ContentNewParamsVariant0CookiesSourceSchemeOptional
One of the following:
const ContentNewParamsVariant0CookiesSourceSchemeUnset ContentNewParamsVariant0CookiesSourceScheme = "Unset"
Link to this property
const ContentNewParamsVariant0CookiesSourceSchemeNonSecure ContentNewParamsVariant0CookiesSourceScheme = "NonSecure"
Link to this property
const ContentNewParamsVariant0CookiesSourceSchemeSecure ContentNewParamsVariant0CookiesSourceScheme = "Secure"
Link to this property
Link to this property
URL stringOptional
Link to this property
Link to this property
EmulateMediaType param.Field\[string]Optional
Body param
Link to this property
GotoOptions param.Field\[ContentNewParamsVariant0GotoOptions]Optional
Body param: Check options.
Referer stringOptional
Link to this property
ReferrerPolicy stringOptional
Link to this property
Timeout float64Optional
maximum60000
Link to this property
WaitUntil ContentNewParamsVariant0GotoOptionsWaitUntilUnionOptional
One of the following:
ContentNewParamsVariant0GotoOptionsWaitUntilString
One of the following:
const ContentNewParamsVariant0GotoOptionsWaitUntilStringLoad ContentNewParamsVariant0GotoOptionsWaitUntilString = "load"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilStringDomcontentloaded ContentNewParamsVariant0GotoOptionsWaitUntilString = "domcontentloaded"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle0 ContentNewParamsVariant0GotoOptionsWaitUntilString = "networkidle0"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle2 ContentNewParamsVariant0GotoOptionsWaitUntilString = "networkidle2"
Link to this property
Link to this property
ContentNewParamsVariant0GotoOptionsWaitUntilArray
One of the following:
const ContentNewParamsVariant0GotoOptionsWaitUntilArrayLoad ContentNewParamsVariant0GotoOptionsWaitUntilArray = "load"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilArrayDomcontentloaded ContentNewParamsVariant0GotoOptionsWaitUntilArray = "domcontentloaded"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle0 ContentNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle0"
Link to this property
const ContentNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle2 ContentNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle2"
Link to this property
Link to this property
Link to this property
Link to this property
HTML param.Field\[string]Optional
Body param
Link to this property
RejectRequestPattern param.Field\[\[]string]Optional
Body param: Block undesired requests that match the provided regex patterns, eg. ’/^.\*.(css)’.
Link to this property
RejectResourceTypes param.Field\[\[]ContentNewParamsVariant0RejectResourceType]Optional
Body param: Block undesired requests that match the provided resource types, eg. ‘image’ or ‘script’.
const ContentNewParamsVariant0RejectResourceTypeDocument ContentNewParamsVariant0RejectResourceType = "document"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeStylesheet ContentNewParamsVariant0RejectResourceType = "stylesheet"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeImage ContentNewParamsVariant0RejectResourceType = "image"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeMedia ContentNewParamsVariant0RejectResourceType = "media"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeFont ContentNewParamsVariant0RejectResourceType = "font"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeScript ContentNewParamsVariant0RejectResourceType = "script"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeTexttrack ContentNewParamsVariant0RejectResourceType = "texttrack"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeXHR ContentNewParamsVariant0RejectResourceType = "xhr"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeFetch ContentNewParamsVariant0RejectResourceType = "fetch"
Link to this property
const ContentNewParamsVariant0RejectResourceTypePrefetch ContentNewParamsVariant0RejectResourceType = "prefetch"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeEventsource ContentNewParamsVariant0RejectResourceType = "eventsource"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeWebsocket ContentNewParamsVariant0RejectResourceType = "websocket"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeManifest ContentNewParamsVariant0RejectResourceType = "manifest"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeSignedexchange ContentNewParamsVariant0RejectResourceType = "signedexchange"
Link to this property
const ContentNewParamsVariant0RejectResourceTypePing ContentNewParamsVariant0RejectResourceType = "ping"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeCspviolationreport ContentNewParamsVariant0RejectResourceType = "cspviolationreport"
Link to this property
const ContentNewParamsVariant0RejectResourceTypePreflight ContentNewParamsVariant0RejectResourceType = "preflight"
Link to this property
const ContentNewParamsVariant0RejectResourceTypeOther ContentNewParamsVariant0RejectResourceType = "other"
Link to this property
Link to this property
SetExtraHTTPHeaders param.Field\[map\[string, string]]Optional
Body param
Link to this property
SetJavaScriptEnabled param.Field\[bool]Optional
Body param
Link to this property
UserAgent param.Field\[string]Optional
Body param
Link to this property
Viewport param.Field\[ContentNewParamsVariant0Viewport]Optional
Body param: Check options.
Height float64
Link to this property
Width float64
Link to this property
DeviceScaleFactor float64Optional
Link to this property
HasTouch boolOptional
Link to this property
IsLandscape boolOptional
Link to this property
IsMobile boolOptional
Link to this property
Link to this property
WaitForSelector param.Field\[ContentNewParamsVariant0WaitForSelector]Optional
Body param: Wait for the selector to appear in page. Check options.
Selector string
Link to this property
Hidden ContentNewParamsVariant0WaitForSelectorHiddenOptional
Link to this property
Timeout float64Optional
maximum120000
Link to this property
Visible ContentNewParamsVariant0WaitForSelectorVisibleOptional
Link to this property
Link to this property
WaitForTimeout param.Field\[float64]Optional
Body param: Waits for a specified timeout before continuing.
maximum120000
Link to this property
[Link to this property](<#(resource)%20browser_rendering.content%20%3E%20(method)%20create%20%3E%20(params)%200>)
##### ReturnsExpand Collapse
type ContentNewResponseEnvelopeResult string
HTML content.
[Link to this property](<#(resource)%20browser_rendering.content%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
### Get HTML content.
Go
HTTPTypeScriptPythonGoTerraform
```
package main
import (
"context"
"fmt"
"github.com/cloudflare/cloudflare-go"
"github.com/cloudflare/cloudflare-go/browser_rendering"
"github.com/cloudflare/cloudflare-go/option"
)
func main() {
client := cloudflare.NewClient(
option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
)
content, err := client.BrowserRendering.Content.New(context.TODO(), browser_rendering.ContentNewParams{
AccountID: cloudflare.F("account_id"),
Body: browser_rendering.ContentNewParamsBodyObject{
URL: cloudflare.F("https://www.example.com/"),
},
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", content)
}
```
200 example
429 example
```
{
"meta": {
"finalUrl": "finalUrl",
"headers": {
"foo": "string"
},
"redirectChain": [
{
"headers": {
"foo": "string"
},
"status": 0,
"url": "url"
}
],
"status": 0,
"title": "title"
},
"success": true,
"errors": [
{
"code": 0,
"message": "message"
}
],
"result": "result"
}
```
```
{
"errors": [
{
"code": 2001,
"message": "Rate limit exceeded"
}
],
"success": false
}
```
##### Returns Examples
200 example
429 example
```
{
"meta": {
"finalUrl": "finalUrl",
"headers": {
"foo": "string"
},
"redirectChain": [
{
"headers": {
"foo": "string"
},
"status": 0,
"url": "url"
}
],
"status": 0,
"title": "title"
},
"success": true,
"errors": [
{
"code": 0,
"message": "message"
}
],
"result": "result"
}
```
```
{
"errors": [
{
"code": 2001,
"message": "Rate limit exceeded"
}
],
"success": false
}
```