View as Markdown
Decodo icon

Decodo ACTION

Scrape URL

Fetch the live contents of a web page through Decodo's scraping proxies. Use when you need the current content of a URL — a public page, a search-engine results page via a target template (e.g. google_search with a query), or a JavaScript-heavy page (set headless to html to render it first). Returns an array of results, each with the page content, the HTTP status_code, response headers, and cookies. Example: to read https://example.com as clean Markdown, set url to https://example.com and markdown to true; the returned content is the page converted to Markdown (# Example Domain ...). See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Decodo account once, then configure and run Scrape URL from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "decodo-scrape-url",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    decodo: { authProvisionId: "apn_xxxxxxx" },
    url: "URL",
    query: "Query",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Scrape URL inputs
Property Type Description
url URL string
The URL to scrape. Required unless using a target template that accepts query instead. E.g. https://ip.decodo.com
Optional
query Query string
Search query for target templates that support it (instead of or in addition to url). E.g. pizza near me
Optional
target Target string
Target template for specialized scrapers. E.g. google_search. See the documentation
Optional
proxyPool Proxy Pool string
standard handles simple pages; premium resolves complex anti-bot measures and is used for target templates. Defaults to premium.
Optional
headless Headless string
html enables JavaScript rendering. png enables a screenshot response. Some target templates force JS rendering by default. See the documentation
Optional
geo Geo string
The geographical location for the request. Defaults to auto-randomized. E.g. United States
Optional
domain Domain string
Top-level domain for localized results. E.g. com, co.uk, fr. Defaults to com.
Optional
locale Locale string
Changes the search page web interface language (not the results). Matched with the domain parameter by default. E.g. en-US, en-GB
Optional
headers Headers object
Additional request headers to send to the target. By default these are not forwarded unless Force Headers is enabled. E.g. {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}
Optional
cookies Cookies object
Cookies to send with the request, e.g. to access pages as a logged-in user, as a map of cookie name to value (values are sent as strings). By default these are not forwarded unless Force Cookies is enabled. E.g. {"sessionid": "8e1f3b56-7abc-47e6-b2e2-1d273b0a1c4d", "logged_in": "true", "locale": "en-US"}
Optional
forceCookies Force Cookies boolean
By default, user-provided cookies are not forwarded to the target. Set to true to override this behaviour.
Optional
forceHeaders Force Headers boolean
By default, user-provided headers are not forwarded to the target. Set to true to override this behaviour.
Optional
deviceType Device Type string
Device type and browser for the request. Defaults to desktop. See the documentation
Optional
parse Parse boolean
For certain target templates, set to true to retrieve structured/parsed data instead of raw HTML.
Optional
sessionId Session ID string
Reuse the same IP for multiple requests for up to 10 minutes. E.g. 1234
Optional
httpMethod HTTP Method string
HTTP method for the target request. Defaults to GET. Use POST with a base64-encoded Payload.
Optional
payload Payload string
Base64-encoded POST request body. Used when HTTP Method is POST. E.g. eyJmb28iOiJiYXIifQ== for {"foo":"bar"}.
Optional
successfulStatusCodes Successful Status Codes integer[]
HTTP response codes to treat as successful so content is still returned. E.g. [401, 404]
Optional
markdown Markdown boolean
Parse HTML output into Markdown. Useful for reducing tokens when feeding results into LLM models.
Optional
xhr XHR boolean
When enabled, retrieves a list of XHR and fetch requests made by the page.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
decodo-scrape-url
Version
0.0.1
App
Decodo
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes