--- title: Get Links. --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Browser Rendering](https://developers.cloudflare.com/api/go/resources/browser_rendering) [Links](https://developers.cloudflare.com/api/go/resources/browser_rendering/subresources/links) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Links. client.BrowserRendering.Links.New(ctx, params) (\*\[]string, error) POST/accounts/{account\_id}/browser-rendering/links Get links from a web page. ##### 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 LinkNewParams

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\[LinkNewParamsVariant0Browser]Optional Query param: Rendering backend. Set to kitesurf to use Kitesurf (beta).

const LinkNewParamsVariant0BrowserKitesurf LinkNewParamsVariant0Browser = "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\[\[]LinkNewParamsVariant0AddScriptTag]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\[\[]LinkNewParamsVariant0AddStyleTag]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\[\[]LinkNewParamsVariant0AllowResourceType]Optional Body param: Only allow requests that match the provided resource types, eg. ‘image’ or ‘script’. Reject rules are applied first.

const LinkNewParamsVariant0AllowResourceTypeDocument LinkNewParamsVariant0AllowResourceType = "document" Link to this property const LinkNewParamsVariant0AllowResourceTypeStylesheet LinkNewParamsVariant0AllowResourceType = "stylesheet" Link to this property const LinkNewParamsVariant0AllowResourceTypeImage LinkNewParamsVariant0AllowResourceType = "image" Link to this property const LinkNewParamsVariant0AllowResourceTypeMedia LinkNewParamsVariant0AllowResourceType = "media" Link to this property const LinkNewParamsVariant0AllowResourceTypeFont LinkNewParamsVariant0AllowResourceType = "font" Link to this property const LinkNewParamsVariant0AllowResourceTypeScript LinkNewParamsVariant0AllowResourceType = "script" Link to this property const LinkNewParamsVariant0AllowResourceTypeTexttrack LinkNewParamsVariant0AllowResourceType = "texttrack" Link to this property const LinkNewParamsVariant0AllowResourceTypeXHR LinkNewParamsVariant0AllowResourceType = "xhr" Link to this property const LinkNewParamsVariant0AllowResourceTypeFetch LinkNewParamsVariant0AllowResourceType = "fetch" Link to this property const LinkNewParamsVariant0AllowResourceTypePrefetch LinkNewParamsVariant0AllowResourceType = "prefetch" Link to this property const LinkNewParamsVariant0AllowResourceTypeEventsource LinkNewParamsVariant0AllowResourceType = "eventsource" Link to this property const LinkNewParamsVariant0AllowResourceTypeWebsocket LinkNewParamsVariant0AllowResourceType = "websocket" Link to this property const LinkNewParamsVariant0AllowResourceTypeManifest LinkNewParamsVariant0AllowResourceType = "manifest" Link to this property const LinkNewParamsVariant0AllowResourceTypeSignedexchange LinkNewParamsVariant0AllowResourceType = "signedexchange" Link to this property const LinkNewParamsVariant0AllowResourceTypePing LinkNewParamsVariant0AllowResourceType = "ping" Link to this property const LinkNewParamsVariant0AllowResourceTypeCspviolationreport LinkNewParamsVariant0AllowResourceType = "cspviolationreport" Link to this property const LinkNewParamsVariant0AllowResourceTypePreflight LinkNewParamsVariant0AllowResourceType = "preflight" Link to this property const LinkNewParamsVariant0AllowResourceTypeOther LinkNewParamsVariant0AllowResourceType = "other" Link to this property

Link to this property

Authenticate param.Field\[LinkNewParamsVariant0Authenticate]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\[\[]LinkNewParamsVariant0Cookie]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 LinkNewParamsVariant0CookiesPriorityOptional

One of the following: const LinkNewParamsVariant0CookiesPriorityLow LinkNewParamsVariant0CookiesPriority = "Low" Link to this property const LinkNewParamsVariant0CookiesPriorityMedium LinkNewParamsVariant0CookiesPriority = "Medium" Link to this property const LinkNewParamsVariant0CookiesPriorityHigh LinkNewParamsVariant0CookiesPriority = "High" Link to this property

Link to this property SameParty boolOptional Link to this property

SameSite LinkNewParamsVariant0CookiesSameSiteOptional

One of the following: const LinkNewParamsVariant0CookiesSameSiteStrict LinkNewParamsVariant0CookiesSameSite = "Strict" Link to this property const LinkNewParamsVariant0CookiesSameSiteLax LinkNewParamsVariant0CookiesSameSite = "Lax" Link to this property const LinkNewParamsVariant0CookiesSameSiteNone LinkNewParamsVariant0CookiesSameSite = "None" Link to this property

Link to this property Secure boolOptional Link to this property SourcePort float64Optional Link to this property

SourceScheme LinkNewParamsVariant0CookiesSourceSchemeOptional

One of the following: const LinkNewParamsVariant0CookiesSourceSchemeUnset LinkNewParamsVariant0CookiesSourceScheme = "Unset" Link to this property const LinkNewParamsVariant0CookiesSourceSchemeNonSecure LinkNewParamsVariant0CookiesSourceScheme = "NonSecure" Link to this property const LinkNewParamsVariant0CookiesSourceSchemeSecure LinkNewParamsVariant0CookiesSourceScheme = "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 ExcludeExternalLinks param.Field\[bool]Optional Body param Link to this property

GotoOptions param.Field\[LinkNewParamsVariant0GotoOptions]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 LinkNewParamsVariant0GotoOptionsWaitUntilUnionOptional

One of the following:

LinkNewParamsVariant0GotoOptionsWaitUntilString

One of the following: const LinkNewParamsVariant0GotoOptionsWaitUntilStringLoad LinkNewParamsVariant0GotoOptionsWaitUntilString = "load" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilStringDomcontentloaded LinkNewParamsVariant0GotoOptionsWaitUntilString = "domcontentloaded" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle0 LinkNewParamsVariant0GotoOptionsWaitUntilString = "networkidle0" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle2 LinkNewParamsVariant0GotoOptionsWaitUntilString = "networkidle2" Link to this property

Link to this property

LinkNewParamsVariant0GotoOptionsWaitUntilArray

One of the following: const LinkNewParamsVariant0GotoOptionsWaitUntilArrayLoad LinkNewParamsVariant0GotoOptionsWaitUntilArray = "load" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilArrayDomcontentloaded LinkNewParamsVariant0GotoOptionsWaitUntilArray = "domcontentloaded" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle0 LinkNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle0" Link to this property const LinkNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle2 LinkNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle2" 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\[\[]LinkNewParamsVariant0RejectResourceType]Optional Body param: Block undesired requests that match the provided resource types, eg. ‘image’ or ‘script’.

const LinkNewParamsVariant0RejectResourceTypeDocument LinkNewParamsVariant0RejectResourceType = "document" Link to this property const LinkNewParamsVariant0RejectResourceTypeStylesheet LinkNewParamsVariant0RejectResourceType = "stylesheet" Link to this property const LinkNewParamsVariant0RejectResourceTypeImage LinkNewParamsVariant0RejectResourceType = "image" Link to this property const LinkNewParamsVariant0RejectResourceTypeMedia LinkNewParamsVariant0RejectResourceType = "media" Link to this property const LinkNewParamsVariant0RejectResourceTypeFont LinkNewParamsVariant0RejectResourceType = "font" Link to this property const LinkNewParamsVariant0RejectResourceTypeScript LinkNewParamsVariant0RejectResourceType = "script" Link to this property const LinkNewParamsVariant0RejectResourceTypeTexttrack LinkNewParamsVariant0RejectResourceType = "texttrack" Link to this property const LinkNewParamsVariant0RejectResourceTypeXHR LinkNewParamsVariant0RejectResourceType = "xhr" Link to this property const LinkNewParamsVariant0RejectResourceTypeFetch LinkNewParamsVariant0RejectResourceType = "fetch" Link to this property const LinkNewParamsVariant0RejectResourceTypePrefetch LinkNewParamsVariant0RejectResourceType = "prefetch" Link to this property const LinkNewParamsVariant0RejectResourceTypeEventsource LinkNewParamsVariant0RejectResourceType = "eventsource" Link to this property const LinkNewParamsVariant0RejectResourceTypeWebsocket LinkNewParamsVariant0RejectResourceType = "websocket" Link to this property const LinkNewParamsVariant0RejectResourceTypeManifest LinkNewParamsVariant0RejectResourceType = "manifest" Link to this property const LinkNewParamsVariant0RejectResourceTypeSignedexchange LinkNewParamsVariant0RejectResourceType = "signedexchange" Link to this property const LinkNewParamsVariant0RejectResourceTypePing LinkNewParamsVariant0RejectResourceType = "ping" Link to this property const LinkNewParamsVariant0RejectResourceTypeCspviolationreport LinkNewParamsVariant0RejectResourceType = "cspviolationreport" Link to this property const LinkNewParamsVariant0RejectResourceTypePreflight LinkNewParamsVariant0RejectResourceType = "preflight" Link to this property const LinkNewParamsVariant0RejectResourceTypeOther LinkNewParamsVariant0RejectResourceType = "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\[LinkNewParamsVariant0Viewport]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 VisibleLinksOnly param.Field\[bool]Optional Body param Link to this property

WaitForSelector param.Field\[LinkNewParamsVariant0WaitForSelector]Optional Body param: Wait for the selector to appear in page. Check options.

Selector string Link to this property Hidden LinkNewParamsVariant0WaitForSelectorHiddenOptional Link to this property Timeout float64Optional maximum120000 Link to this property Visible LinkNewParamsVariant0WaitForSelectorVisibleOptional 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.links%20%3E%20(method)%20create%20%3E%20(params)%200>) ##### ReturnsExpand Collapse type LinkNewResponseEnvelopeResult \[]string [Link to this property](<#(resource)%20browser_rendering.links%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Get Links. 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"), ) links, err := client.BrowserRendering.Links.New(context.TODO(), browser_rendering.LinkNewParams{ AccountID: cloudflare.F("account_id"), Body: browser_rendering.LinkNewParamsBodyObject{ URL: cloudflare.F("https://www.example.com/"), }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", links) } ``` 200 example 429 example ``` { "meta": { "finalUrl": "finalUrl", "headers": { "foo": "string" }, "redirectChain": [ { "headers": { "foo": "string" }, "status": 0, "url": "url" } ], "status": 0, "title": "title" }, "result": [ "string" ], "success": true, "errors": [ { "code": 0, "message": "message" } ] } ``` ``` { "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" }, "result": [ "string" ], "success": true, "errors": [ { "code": 0, "message": "message" } ] } ``` ``` { "errors": [ { "code": 2001, "message": "Rate limit exceeded" } ], "success": false } ```