Context API / Scrape HTML

Request parameters

• actions query · optional

  Optional browser actions executed in array order after the page loads and before content is captured. Requires a paid plan. Send a JSON array in the query parameter. Maximum: 5 actions.

• country query · optional

  Fetch the target page through a residential proxy in this country (ISO 3166-1 alpha-2). Example: "de"

• excludeSelectors query · optional

  CSS selectors to remove from the result. Applied after includeSelectors. Exclusion takes precedence: an element matching both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".

• headers query · optional

  Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.

• includeFrames query · optional

  When true, iframes are rendered inline into the returned HTML.

• includeSelectors query · optional

  CSS selectors. When provided, only matching subtrees (and their descendants) are kept and everything else is dropped. When omitted, the entire document is kept. Examples: "article.main", "#content", "[role=main]".

• maxAgeMs query · optional

  Return a cached result if a prior scrape for the same parameters exists and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.

• pdf query · optional

  PDF parsing controls. Use start/end to limit text extraction and embedded-image detection/OCR to an inclusive 1-based page range.

• settleAnimations query · optional

  When true, waits briefly for CSS and transition animations to settle before extracting HTML. Defaults to false. This adds a bit of latency in exchange for more stable output on animated pages.

• tags query · optional

  Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

• timeoutMS query · optional

  Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

• url query · required

  Full URL to scrape (must include http:// or https:// protocol). Example: "https://www.example.com"

• useMainContentOnly query · optional

  When true, return only the page's main content in the HTML response, excluding headers, footers, sidebars, and navigation when detectable.

• waitForMs query · optional

  Optional browser wait time in milliseconds after initial page load. Min: 0. Max: 30000 (30 seconds).

• zdr query · optional

  Set to enabled to bypass shared caches and omit request and response content from retained usage logs. Requires zero data retention to be enabled for your organization (contact support@context.dev), otherwise the request fails with ZDR_NOT_ENABLED. Successful ZDR responses include X-Context-ZDR: true.