## Get PDF.

`client.BrowserRendering.PDF.New(ctx, params) (*Response, error)`

**post** `/accounts/{account_id}/browser-rendering/pdf`

Fetches rendered PDF from provided URL or HTML. Check available options like `gotoOptions` and `waitFor*` to control page load behaviour.

### Parameters

- `params PDFNewParams`

  - `AccountID param.Field[string]`

    Path param: Account ID.

  - `HTML param.Field[string]`

    Body param: Set the content of the page, eg: `<h1>Hello World!!</h1>`. Either `html` or `url` must be set.

  - `CacheTTL param.Field[float64]`

    Query param: Cache TTL default is 5s. Set to 0 to disable.

  - `ActionTimeout param.Field[float64]`

    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.

  - `AddScriptTag param.Field[[]PDFNewParamsVariant0AddScriptTag]`

    Body param: Adds a `<script>` tag into the page with the desired URL or content.

    - `ID string`

    - `Content string`

    - `Type string`

    - `URL string`

  - `AddStyleTag param.Field[[]PDFNewParamsVariant0AddStyleTag]`

    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 string`

    - `URL string`

  - `AllowRequestPattern param.Field[[]string]`

    Body param: Only allow requests that match the provided regex patterns, eg. '/^.*.(css)'.

  - `AllowResourceTypes param.Field[[]PDFNewParamsVariant0AllowResourceType]`

    Body param: Only allow requests that match the provided resource types, eg. 'image' or 'script'.

    - `const PDFNewParamsVariant0AllowResourceTypeDocument PDFNewParamsVariant0AllowResourceType = "document"`

    - `const PDFNewParamsVariant0AllowResourceTypeStylesheet PDFNewParamsVariant0AllowResourceType = "stylesheet"`

    - `const PDFNewParamsVariant0AllowResourceTypeImage PDFNewParamsVariant0AllowResourceType = "image"`

    - `const PDFNewParamsVariant0AllowResourceTypeMedia PDFNewParamsVariant0AllowResourceType = "media"`

    - `const PDFNewParamsVariant0AllowResourceTypeFont PDFNewParamsVariant0AllowResourceType = "font"`

    - `const PDFNewParamsVariant0AllowResourceTypeScript PDFNewParamsVariant0AllowResourceType = "script"`

    - `const PDFNewParamsVariant0AllowResourceTypeTexttrack PDFNewParamsVariant0AllowResourceType = "texttrack"`

    - `const PDFNewParamsVariant0AllowResourceTypeXHR PDFNewParamsVariant0AllowResourceType = "xhr"`

    - `const PDFNewParamsVariant0AllowResourceTypeFetch PDFNewParamsVariant0AllowResourceType = "fetch"`

    - `const PDFNewParamsVariant0AllowResourceTypePrefetch PDFNewParamsVariant0AllowResourceType = "prefetch"`

    - `const PDFNewParamsVariant0AllowResourceTypeEventsource PDFNewParamsVariant0AllowResourceType = "eventsource"`

    - `const PDFNewParamsVariant0AllowResourceTypeWebsocket PDFNewParamsVariant0AllowResourceType = "websocket"`

    - `const PDFNewParamsVariant0AllowResourceTypeManifest PDFNewParamsVariant0AllowResourceType = "manifest"`

    - `const PDFNewParamsVariant0AllowResourceTypeSignedexchange PDFNewParamsVariant0AllowResourceType = "signedexchange"`

    - `const PDFNewParamsVariant0AllowResourceTypePing PDFNewParamsVariant0AllowResourceType = "ping"`

    - `const PDFNewParamsVariant0AllowResourceTypeCspviolationreport PDFNewParamsVariant0AllowResourceType = "cspviolationreport"`

    - `const PDFNewParamsVariant0AllowResourceTypePreflight PDFNewParamsVariant0AllowResourceType = "preflight"`

    - `const PDFNewParamsVariant0AllowResourceTypeOther PDFNewParamsVariant0AllowResourceType = "other"`

  - `Authenticate param.Field[PDFNewParamsVariant0Authenticate]`

    Body param: Provide credentials for HTTP authentication.

    - `Password string`

    - `Username string`

  - `BestAttempt param.Field[bool]`

    Body param: Attempt to proceed when 'awaited' events fail or timeout.

  - `Cookies param.Field[[]PDFNewParamsVariant0Cookie]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.page.setcookie).

    - `Name string`

      Cookie name.

    - `Value string`

    - `Domain string`

    - `Expires float64`

    - `HTTPOnly bool`

    - `PartitionKey string`

    - `Path string`

    - `Priority PDFNewParamsVariant0CookiesPriority`

      - `const PDFNewParamsVariant0CookiesPriorityLow PDFNewParamsVariant0CookiesPriority = "Low"`

      - `const PDFNewParamsVariant0CookiesPriorityMedium PDFNewParamsVariant0CookiesPriority = "Medium"`

      - `const PDFNewParamsVariant0CookiesPriorityHigh PDFNewParamsVariant0CookiesPriority = "High"`

    - `SameParty bool`

    - `SameSite PDFNewParamsVariant0CookiesSameSite`

      - `const PDFNewParamsVariant0CookiesSameSiteStrict PDFNewParamsVariant0CookiesSameSite = "Strict"`

      - `const PDFNewParamsVariant0CookiesSameSiteLax PDFNewParamsVariant0CookiesSameSite = "Lax"`

      - `const PDFNewParamsVariant0CookiesSameSiteNone PDFNewParamsVariant0CookiesSameSite = "None"`

    - `Secure bool`

    - `SourcePort float64`

    - `SourceScheme PDFNewParamsVariant0CookiesSourceScheme`

      - `const PDFNewParamsVariant0CookiesSourceSchemeUnset PDFNewParamsVariant0CookiesSourceScheme = "Unset"`

      - `const PDFNewParamsVariant0CookiesSourceSchemeNonSecure PDFNewParamsVariant0CookiesSourceScheme = "NonSecure"`

      - `const PDFNewParamsVariant0CookiesSourceSchemeSecure PDFNewParamsVariant0CookiesSourceScheme = "Secure"`

    - `URL string`

  - `EmulateMediaType param.Field[string]`

    Body param

  - `GotoOptions param.Field[PDFNewParamsVariant0GotoOptions]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.gotooptions).

    - `Referer string`

    - `ReferrerPolicy string`

    - `Timeout float64`

    - `WaitUntil PDFNewParamsVariant0GotoOptionsWaitUntilUnion`

      - `PDFNewParamsVariant0GotoOptionsWaitUntilString`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilStringLoad PDFNewParamsVariant0GotoOptionsWaitUntilString = "load"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilStringDomcontentloaded PDFNewParamsVariant0GotoOptionsWaitUntilString = "domcontentloaded"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle0 PDFNewParamsVariant0GotoOptionsWaitUntilString = "networkidle0"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle2 PDFNewParamsVariant0GotoOptionsWaitUntilString = "networkidle2"`

      - `PDFNewParamsVariant0GotoOptionsWaitUntilArray`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilArrayLoad PDFNewParamsVariant0GotoOptionsWaitUntilArray = "load"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilArrayDomcontentloaded PDFNewParamsVariant0GotoOptionsWaitUntilArray = "domcontentloaded"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle0 PDFNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle0"`

        - `const PDFNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle2 PDFNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle2"`

  - `PDFOptions param.Field[PDFNewParamsVariant0PDFOptions]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.pdfoptions).

    - `DisplayHeaderFooter bool`

      Whether to show the header and footer.

    - `FooterTemplate string`

      HTML template for the print footer.

    - `Format PDFNewParamsVariant0PDFOptionsFormat`

      Paper format. Takes priority over width and height if set.

      - `const PDFNewParamsVariant0PDFOptionsFormatLetter PDFNewParamsVariant0PDFOptionsFormat = "letter"`

      - `const PDFNewParamsVariant0PDFOptionsFormatLegal PDFNewParamsVariant0PDFOptionsFormat = "legal"`

      - `const PDFNewParamsVariant0PDFOptionsFormatTabloid PDFNewParamsVariant0PDFOptionsFormat = "tabloid"`

      - `const PDFNewParamsVariant0PDFOptionsFormatLedger PDFNewParamsVariant0PDFOptionsFormat = "ledger"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA0 PDFNewParamsVariant0PDFOptionsFormat = "a0"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA1 PDFNewParamsVariant0PDFOptionsFormat = "a1"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA2 PDFNewParamsVariant0PDFOptionsFormat = "a2"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA3 PDFNewParamsVariant0PDFOptionsFormat = "a3"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA4 PDFNewParamsVariant0PDFOptionsFormat = "a4"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA5 PDFNewParamsVariant0PDFOptionsFormat = "a5"`

      - `const PDFNewParamsVariant0PDFOptionsFormatA6 PDFNewParamsVariant0PDFOptionsFormat = "a6"`

    - `HeaderTemplate string`

      HTML template for the print header.

    - `Height PDFNewParamsVariant0PDFOptionsHeightUnion`

      Sets the height of paper. Can be a number or string with unit.

      - `UnionString`

      - `UnionFloat`

    - `Landscape bool`

      Whether to print in landscape orientation.

    - `Margin PDFNewParamsVariant0PDFOptionsMargin`

      Set the PDF margins. Useful when setting header and footer.

      - `Bottom PDFNewParamsVariant0PDFOptionsMarginBottomUnion`

        - `UnionString`

        - `UnionFloat`

      - `Left PDFNewParamsVariant0PDFOptionsMarginLeftUnion`

        - `UnionString`

        - `UnionFloat`

      - `Right PDFNewParamsVariant0PDFOptionsMarginRightUnion`

        - `UnionString`

        - `UnionFloat`

      - `Top PDFNewParamsVariant0PDFOptionsMarginTopUnion`

        - `UnionString`

        - `UnionFloat`

    - `OmitBackground bool`

      Hides default white background and allows generating pdfs with transparency.

    - `Outline bool`

      Generate document outline.

    - `PageRanges string`

      Paper ranges to print, e.g. '1-5, 8, 11-13'.

    - `PreferCSSPageSize bool`

      Give CSS @page size priority over other size declarations.

    - `PrintBackground bool`

      Set to true to print background graphics.

    - `Scale float64`

      Scales the rendering of the web page. Amount must be between 0.1 and 2.

    - `Tagged bool`

      Generate tagged (accessible) PDF.

    - `Timeout float64`

      Timeout in milliseconds.

    - `Width PDFNewParamsVariant0PDFOptionsWidthUnion`

      Sets the width of paper. Can be a number or string with unit.

      - `UnionString`

      - `UnionFloat`

  - `RejectRequestPattern param.Field[[]string]`

    Body param: Block undesired requests that match the provided regex patterns, eg. '/^.*.(css)'.

  - `RejectResourceTypes param.Field[[]PDFNewParamsVariant0RejectResourceType]`

    Body param: Block undesired requests that match the provided resource types, eg. 'image' or 'script'.

    - `const PDFNewParamsVariant0RejectResourceTypeDocument PDFNewParamsVariant0RejectResourceType = "document"`

    - `const PDFNewParamsVariant0RejectResourceTypeStylesheet PDFNewParamsVariant0RejectResourceType = "stylesheet"`

    - `const PDFNewParamsVariant0RejectResourceTypeImage PDFNewParamsVariant0RejectResourceType = "image"`

    - `const PDFNewParamsVariant0RejectResourceTypeMedia PDFNewParamsVariant0RejectResourceType = "media"`

    - `const PDFNewParamsVariant0RejectResourceTypeFont PDFNewParamsVariant0RejectResourceType = "font"`

    - `const PDFNewParamsVariant0RejectResourceTypeScript PDFNewParamsVariant0RejectResourceType = "script"`

    - `const PDFNewParamsVariant0RejectResourceTypeTexttrack PDFNewParamsVariant0RejectResourceType = "texttrack"`

    - `const PDFNewParamsVariant0RejectResourceTypeXHR PDFNewParamsVariant0RejectResourceType = "xhr"`

    - `const PDFNewParamsVariant0RejectResourceTypeFetch PDFNewParamsVariant0RejectResourceType = "fetch"`

    - `const PDFNewParamsVariant0RejectResourceTypePrefetch PDFNewParamsVariant0RejectResourceType = "prefetch"`

    - `const PDFNewParamsVariant0RejectResourceTypeEventsource PDFNewParamsVariant0RejectResourceType = "eventsource"`

    - `const PDFNewParamsVariant0RejectResourceTypeWebsocket PDFNewParamsVariant0RejectResourceType = "websocket"`

    - `const PDFNewParamsVariant0RejectResourceTypeManifest PDFNewParamsVariant0RejectResourceType = "manifest"`

    - `const PDFNewParamsVariant0RejectResourceTypeSignedexchange PDFNewParamsVariant0RejectResourceType = "signedexchange"`

    - `const PDFNewParamsVariant0RejectResourceTypePing PDFNewParamsVariant0RejectResourceType = "ping"`

    - `const PDFNewParamsVariant0RejectResourceTypeCspviolationreport PDFNewParamsVariant0RejectResourceType = "cspviolationreport"`

    - `const PDFNewParamsVariant0RejectResourceTypePreflight PDFNewParamsVariant0RejectResourceType = "preflight"`

    - `const PDFNewParamsVariant0RejectResourceTypeOther PDFNewParamsVariant0RejectResourceType = "other"`

  - `SetExtraHTTPHeaders param.Field[map[string, string]]`

    Body param

  - `SetJavaScriptEnabled param.Field[bool]`

    Body param

  - `UserAgent param.Field[string]`

    Body param

  - `Viewport param.Field[PDFNewParamsVariant0Viewport]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.page.setviewport).

    - `Height float64`

    - `Width float64`

    - `DeviceScaleFactor float64`

    - `HasTouch bool`

    - `IsLandscape bool`

    - `IsMobile bool`

  - `WaitForSelector param.Field[PDFNewParamsVariant0WaitForSelector]`

    Body param: Wait for the selector to appear in page. Check [options](https://pptr.dev/api/puppeteer.page.waitforselector).

    - `Selector string`

    - `Hidden PDFNewParamsVariant0WaitForSelectorHidden`

      - `const PDFNewParamsVariant0WaitForSelectorHiddenTrue PDFNewParamsVariant0WaitForSelectorHidden = true`

    - `Timeout float64`

    - `Visible PDFNewParamsVariant0WaitForSelectorVisible`

      - `const PDFNewParamsVariant0WaitForSelectorVisibleTrue PDFNewParamsVariant0WaitForSelectorVisible = true`

  - `WaitForTimeout param.Field[float64]`

    Body param: Waits for a specified timeout before continuing.

### Returns

- `type PDFNewResponse interface{…}`

### Example

```go
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"),
  )
  pdf, err := client.BrowserRendering.PDF.New(context.TODO(), browser_rendering.PDFNewParams{
    AccountID: cloudflare.F("account_id"),
    Body: browser_rendering.PDFNewParamsBodyObject{
      URL: cloudflare.F("https://www.example.com/"),
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", pdf)
}
```

#### Response

```json
{
  "errors": [
    {
      "code": 2001,
      "message": "Rate limit exceeded"
    }
  ],
  "success": false
}
```