DecodoSDK

The TypeScript SDK for Web Scraping Workflows

The Decodo TypeScript SDK is a Node.js-compatible client library for the Decodo Web Scraping API. Typed interfaces, IDE autocomplete, and built-in async handling take you from install to first result in minutes.

Start for free View on GitHub

14-day money-back option

Add live web data to your TypeScript or Node.js app

The SDK wraps the full Decodo Web Scraping API into typed, developer-friendly methods – so your team spends time building, not wiring up boilerplate.

Per-target typed interfaces

100+ targets with dedicated parameter types. Amazon exposes currency and autoselect_variant. Google Search exposes google_tbm and geo. Discover them directly in your IDE.

Full IDE autocomplete

TypeScript inference surfaces the right parameters for each target as you type. No docs tab required.

Built-in async handling

Async scraping jobs manage their own polling. No custom retry logic, no manual status checks.

Typed error handling

Authentication failures, rate limits, validation errors, and timeouts throw distinct, typed exceptions.

Minimal setup

Native fetch, no extra HTTP client. Node.js 18+, TypeScript 5.0+ recommended. Install, authenticate, scrape.

Markdown-ready output

Get clean Markdown directly from any supported target. Pass markdown:true and skip the HTML parsing step.

Quick setup & integration

Install the TypeScript SDK via npm, compatible with Node.js 18+ and TypeScript 5.0+.

1//Setup:
2mkdir scrape-with-decodo
3cd scrape-with-decodo
4npm init -y
5npm install --save @decodo/sdk-ts
6touch main.js
7// main.js
8import { DecodoClient, Target } from '@decodo/sdk-ts';
9

//Example code:
import { DecodoClient, Target } from '@decodo/sdk-ts';
const client = new DecodoClient({
  webScrapingApi: {
    token: '<basic_auth_token>',
  },
});

const result = await client.webScrapingApi.scrape({
  target: Target.GoogleSearch,
  query: 'coffee shops',
  geo: 'United States',
  parse: true,
});

One client, every workflow

Sync for quick lookups, async for long-running jobs, batch for scale, all through the same typed client.

Scrape and wait

Returns when the result is ready. Ideal for real-time lookups and lightweight pipelines.

Fire and retrieve

Create a task, get a job ID, and retrieve results when ready. Built for delayed or heavy scrapes.

Many queries at once

Send arrays of queries or URLs in a single call. Built for monitoring feeds and data pipelines at scale.

Trusted by:

Power your workflows with live web data

The Decodo SDK fits into the workflows your team is already running, from SERP monitoring to AI pipelines.

SERP monitoring

Pull live search results, rankings, and featured snippets for SEO tracking and content intelligence.

eCommerce tracking

Monitor competitor prices, product listings, and reviews across Amazon, Walmart, and more.

AI data pipelines

Feed structured, up-to-date web data into LLM training sets, RAG pipelines, and AI agents.

Market intelligence

Aggregate social signals, news, and marketplace data for research teams and analyst workflows.

Rapid prototyping

Spin up scraping experiments fast. Typed interfaces mean less debugging and faster iteration.

Internal tooling

Embed scraping into dashboards, automations, and internal apps without managing raw API calls.

What does Web Scraping API cost?

Choose a plan based on your scraping volume. All plans include the same powerful features – you only pay for what you use. Start with the free plan to test before committing.

Plan price

+VAT / Billed monthly

Request type

Price per 1k req.

Standard proxies

2K req.

$0.50

Standard proxies + JS

1K req.

$0.75

Premium Proxies

1K req.

$1.00

Premium proxies + JS

667 req.

$1.50

Rate limit

10 req/s

Start for free

Plan price

$19

+VAT / Billed monthly

Request type

Price per 1k req.

Standard proxies

38K req.

$0.50

Standard proxies + JS

25K req.

$0.75

Premium Proxies

19K req.

$1.00

Premium proxies + JS

12K req.

$1.50

Rate limit

10 req/s

Buy now

Plan price

$49

+VAT / Billed monthly

Request type

Price per 1k req.

Standard proxies

163K req.

$0.30

Standard proxies + JS

75K req.

$0.65

Premium Proxies

54K req.

$0.90

Premium proxies + JS

39K req.

$1.25

Rate limit

25 req/s

Buy now

What people are saying about us

We're thrilled to have the support of our 130K+ clients and the industry's best.

Attentive service

The professional expertise of the Decodo solution has significantly boosted our business growth while enhancing overall efficiency and effectiveness.

Novabeyond

Easy to get things done

Decodo provides great service with a simple setup and friendly support team.

RoiDynamic

A key to our work

Decodo enables us to develop and test applications in varied environments while supporting precise data collection for research and audience profiling.

Cybereg

Best Usability 2025

Awarded for the ease of use and fastest time to value for proxy and scraping solutions.

Best User Adoption 2025

Praised for the seamless onboarding experience and impactful engagement efforts.

Best Value 2025

Recognized for the 5th year in a row for top-tier proxy and scraping solutions.

Techradar

The best proxy of 2025, that’s highly affordable for most use cases.

Proxyway

The provider has become an all-rounder that tries to retain these winning qualities.

PCMag

Decodo’s residential proxy service is crucial for your business’s data collection.

Frequently asked questions

What is the Decodo TypeScript SDK?

The Decodo TypeScript SDK is a Node.js client library that wraps the Decodo Web Scraping API. It provides typed interfaces for 100+ scraping targets - including Google, Amazon, and TikTok - with built-in async handling, CAPTCHA bypassing, and proxy rotation, so TypeScript and Node.js developers can collect structured web data without managing infrastructure.

Does Decodo TypeScript SDK work with plain JavaScript?

Yes. The SDK is installable in any Node.js project. Without TypeScript, you won't get IDE autocomplete or type safety, but all methods work the same way.

Who is the SDK for?

TypeScript and Node.js developers building scraping workflows, data pipelines, or applications that need live web data. It's especially well-suited for teams that want fast implementation and strong developer experience without managing custom HTTP wrappers.

How is this different from calling the API directly?

The raw API requires manually constructing requests, handling authentication, writing polling logic, and parsing generic error responses. The SDK removes all of that – typed parameters, IDE autocomplete, built-in async handling, and typed errors are all included out of the box. Unlike building on top of Cheerio, Puppeteer, or Playwright directly, you don't manage browser instances, proxy rotation, or CAPTCHA handling. That's all handled server-side

No feature loss compared to raw API usage.

What targets are supported?

58+ targets across search engines, eCommerce platforms, social media, and AI tools – including Target.GoogleSearch, Target.AmazonProduct, Target.TiktokPost, Target.YoutubeSearch, Target.Chatgpt, Target.Perplexity, and many more. Each target exposes its own typed interface directly in your IDE.

Do I need to manage proxies or handle CAPTCHAs?

No. Decodo handles proxy rotation, CAPTCHA bypassing, JavaScript rendering, retries, and parsing behind the scenes – all backed by a 125M+ IP pool. You just call the typed method and get structured results back. Parsed results are available on selected targets, including Google, Bing, Amazon, Walmart, and others.

Is there a free plan?

Yes. You can start with a free plan from the Decodo dashboard – enough requests to test integrations and validate your scraping workflows before committing to a plan.

Add Live Web Data to Any TypeScript or Node.js App

No custom scrapers, no proxy juggling – install the SDK and start scraping production-ready data in minutes.

Start for free GitHub

14-day money-back option