For the complete documentation index, see llms.txt. This page is also available as Markdown.

Dedicated Scrapers

Discover Oxylabs Web API dedicated scrapers for structured field extraction from specialized web targets.

Beyond the generic /scrape scraper, Web API offers purpose-built and actively maintained scrapers for specific targets:

POST /v1/scrape/{target}/{collection}

The generic scraper hands you the whole page, while a dedicated scraper hands you the fields on that page, such as product price and availability, a SERP's organic positions and ads, a video's duration and view count, etc. Results are parsed and named, with the parser maintained by Oxylabs when the site's markup changes.

Which endpoint to call

Each endpoint takes either a query or a url (not both):

query (recommended)

If you have an identifier or a search term.

Identifier or search term (e.g., ASIN on /amazon/product, a keyword on /amazon/search, a video ID on /youtube/metadata, etc.). The endpoint builds the URL for you.

url

If you already have the URL.

URL you already have from a /search result or your own data. The target-level endpoint (/amazon, /walmart, no {collection} segment) takes a URL on that site and picks the correct parser from its shape.

Target overview

Target
Endpoints
Capabilities

/google/search, /google/ads, /google/aimode, /google/shopping, /google/maps, /google/lens, /google/trends, /google/travel/hotels

Organic SERPs, Google Ads, AI Overviews, AI Mode answers, local business listings, product search, hotel details with booking prices.

/amazon/product, /amazon/search, /amazon/pricing, /amazon/sellers, /amazon/bestsellers

Product details, search results, Buy Box offer listings across all sellers, category bestsellers.

/media/youtube/metadata, /media/youtube/subtitles, /media/youtube/download, /media/youtube/search

Video metadata, clean subtitles, media clip downloads, AI trainability permission flags.

/media

Media file download from various sources (TikTok, BiliBili, and more).

/bing/search, /bing

Organic Bing SERPs for multi-engine comparisons.

/chatgpt, /gemini, /perplexity

Query conversational AI assistants and extract generated text and cited sources (Async only).

/walmart, /target, /ebay, /etsy, /aliexpress, /kroger, /homeimprovement, & more...

Product specifications, local inventory, fulfillment pricing, seller storefronts, etc.

For full reference of parameter indexes, technical specs, and schemas per endpoint, see the API Reference. For an up-to-date list of dedicated scraper and parameters use Endpoint Discovery.

Quick scraper reference

Full scraper list

Most dedicated scrapers exist in two variants:

  • /v1/scrape/... returns the result in the response (sync/realtime)

  • /v1/async/scrape/... returns a job and accepts callback_url (async)

A few of the dedicated scrapers run only as jobs, some also support batch of values. Learn more in Delivery Modes.

Endpoint
Modes
Target-specific parameters

/v1/scrape

sync · async · batch

url

/v1/scrape/alibaba

sync · async

url

/v1/scrape/alibaba/product

sync · async

query, domain

/v1/scrape/alibaba/search

sync · async

query, domain, start_page

/v1/scrape/aliexpress

sync · async

url

/v1/scrape/aliexpress/product

sync · async

query, domain, subdomain

/v1/scrape/aliexpress/search

sync · async

query, domain, start_page

/v1/scrape/allegro/product

sync · async

query

/v1/scrape/allegro/search

sync · async

query, delivery_time, domain, shipping_from, start_page, store_city, store_region

/v1/scrape/amazon

sync · async · batch

url, autoselect_variant, category_id, check_empty_geo, condition, currency, locale, max_price, merchant_id, min_price, pages, refinements, safe_search, sort_by, start_page

/v1/scrape/amazon/bestsellers

sync · async · batch

query, category_id, check_empty_geo, currency, domain, locale, pages, safe_search, start_page

/v1/scrape/amazon/pricing

sync · async · batch

query, check_empty_geo, condition, currency, domain, locale, pages, safe_search, start_page

/v1/scrape/amazon/product

sync · async · batch

query, autoselect_variant, check_empty_geo, currency, domain, locale, safe_search

/v1/scrape/amazon/search

sync · async · batch

query, category_id, check_empty_geo, currency, domain, locale, max_price, merchant_id, min_price, pages, refinements, safe_search, sort_by, start_page

/v1/scrape/amazon/sellers

sync · async · batch

query, check_empty_geo, currency, domain, locale, safe_search

/v1/scrape/bakersplus

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/bakersplus/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/bakersplus/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/bedbathandbeyond

sync · async

url

/v1/scrape/bedbathandbeyond/product

sync · async

query, domain

/v1/scrape/bedbathandbeyond/search

sync · async

query, domain, start_page

/v1/scrape/bestbuy

sync · async

url, delivery_zip, store_id

/v1/scrape/bestbuy/product

sync · async

query, delivery_zip, domain, store_id

/v1/scrape/bestbuy/search

sync · async

query, delivery_zip, domain, fulfillment_type, start_page, store_id

/v1/scrape/bing

sync · async · batch

url, locale

/v1/scrape/bing/search

sync · async · batch

query, domain, locale, pages, safe_search, start_page

/v1/scrape/bodegaaurrera

sync · async

url, delivery_zip, store_id

/v1/scrape/bodegaaurrera/product

sync · async

query, delivery_zip, domain, fulfillment_type, store_id, subdomain

/v1/scrape/bodegaaurrera/search

sync · async

query, delivery_zip, domain, fulfillment_type, store_id, subdomain

/v1/scrape/cdiscount

sync · async

url

/v1/scrape/cdiscount/product

sync · async

query, domain

/v1/scrape/cdiscount/search

sync · async

query, domain, start_page

/v1/async/scrape/chatgpt

async · batch

query, search

/v1/scrape/citymarket

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/citymarket/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/citymarket/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/costco

sync · async

url

/v1/scrape/costco/product

sync · async

query, domain

/v1/scrape/costco/search

sync · async

query, domain, start_page

/v1/scrape/dcard/search

sync · async

query, domain

/v1/scrape/dillons

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/dillons/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/dillons/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/ebay

sync · async

url

/v1/scrape/ebay/product

sync · async

query, domain

/v1/scrape/ebay/search

sync · async

query, domain, start_page

/v1/scrape/etsy

sync · async

url

/v1/scrape/etsy/product

sync · async

query

/v1/scrape/etsy/search

sync · async

query, domain, ship_to, start_page, store_id

/v1/scrape/falabella

sync · async

url

/v1/scrape/falabella/product

sync · async

query, domain

/v1/scrape/falabella/search

sync · async

query, domain, start_page

/v1/scrape/flipkart

sync · async

url

/v1/scrape/flipkart/product

sync · async

query, domain

/v1/scrape/flipkart/search

sync · async

query, domain, start_page

/v1/scrape/foodfourless

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/foodfourless/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/foodfourless/search

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/fredmeyer

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/fredmeyer/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/fredmeyer/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/frysfood

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/frysfood/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/frysfood/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/async/scrape/gemini

async · batch

query

/v1/scrape/gerbes

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/gerbes/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/gerbes/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/google

sync · async · batch

url, adstest, adults, aomd, category_id, children, cr, date_from, date_to, disable_scripts, expand_aio, filter, fpstate, hotel_classes, hotel_dates, hotel_occupancy, limit, limit_per_page, locale, max_price, min_price, nfpr, pages, results_language, safe_search, search_type, sort_by, start_page, tbm, tbs, udm

/v1/scrape/google/ads

sync · async · batch

query, adstest, disable_scripts, domain, expand_aio, locale, pages, start_page

/v1/scrape/google/aimode

sync · async · batch

query

/v1/scrape/google/lens

sync · async · batch

query, keywords

/v1/scrape/google/maps

sync · async · batch

query, domain, hotel_dates, hotel_occupancy, locale, pages, start_page

/v1/scrape/google/search

sync · async · batch

query, aomd, cr, disable_scripts, domain, expand_aio, filter, fpstate, limit_per_page, locale, nfpr, pages, results_language, safe_search, start_page, tbm, tbs, udm

/v1/scrape/google/shopping/product

sync · async · batch

query, domain, locale

/v1/scrape/google/shopping/search

sync · async · batch

query, domain, limit, locale, max_price, min_price, pages, sort_by, start_page, tbs

/v1/scrape/google/travel/hotels

sync · async · batch

query, adults, children, domain, hotel_classes, hotel_dates, hotel_occupancy, locale, pages, start_page

/v1/scrape/google/trends/explore

sync · async · batch

query, category_id, date_from, date_to, search_type

/v1/scrape/grainger

sync · async

url

/v1/scrape/grainger/product

sync · async

query, domain

/v1/scrape/grainger/search

sync · async

query, domain

/v1/scrape/harristeeter

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/harristeeter/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/harristeeter/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/idealo/search

sync · async

query, domain

/v1/scrape/indiamart

sync · async

url

/v1/scrape/indiamart/product

sync · async

query, domain

/v1/scrape/indiamart/search

sync · async

query, domain

/v1/scrape/instacart

sync · async

url

/v1/scrape/instacart/product

sync · async

query, domain

/v1/scrape/instacart/search

sync · async

query, domain

/v1/scrape/kingsoopers

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/kingsoopers/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/kingsoopers/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/kroger

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/kroger/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/kroger/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/lazada

sync · async

url, start_page

/v1/scrape/lazada/product

sync · async

query, domain

/v1/scrape/lazada/search

sync · async

query, domain, start_page

/v1/scrape/lowes

sync · async

url, delivery_zip, store_id

/v1/scrape/lowes/product

sync · async

query, delivery_zip, store_id

/v1/scrape/lowes/search

sync · async

query, delivery_today_tomorrow, delivery_zip, domain, free_delivery, pickup_today, store_id

/v1/scrape/magazineluiza

sync · async

url

/v1/scrape/magazineluiza/product

sync · async

query, domain

/v1/scrape/magazineluiza/search

sync · async

query, domain, start_page

/v1/scrape/marianos

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/marianos/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/marianos/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/async/scrape/media

async · batch

url, video_quality

/v1/scrape/media/youtube/autocomplete

sync · async

query, language

/v1/scrape/media/youtube/channel

sync · async

query, limit

/v1/async/scrape/media/youtube/download

async · batch

query, audio_format, audio_language, output, end_at, start_at, video_format, video_quality

/v1/scrape/media/youtube/metadata

sync · async · batch

query

/v1/scrape/media/youtube/search

sync · async

query, 360, 3d, 4k, creative_commons, duration, hd, hdr, live, purchased, sort_by, subtitles, type, upload_date, vr180

/v1/scrape/media/youtube/search/max

sync · async

query, 360, 3d, 4k, creative_commons, duration, hd, hdr, live, purchased, sort_by, subtitles, type, upload_date, vr180

/v1/scrape/media/youtube/subtitles

sync · async · batch

query, language_code, subtitle_origin

/v1/scrape/media/youtube/video/trainability

sync · async

query

/v1/scrape/mediamarkt

sync · async

url

/v1/scrape/mediamarkt/product

sync · async

query, domain

/v1/scrape/mediamarkt/search

sync · async

query, domain, start_page

/v1/scrape/menards

sync · async

url, store_id

/v1/scrape/menards/product

sync · async

query, domain, store_id

/v1/scrape/menards/search

sync · async

query, delivery_eligible, domain, fulfillment_center, in_stock_today, pickup_at_store_eligible, start_page, store_id

/v1/scrape/mercadolibre

sync · async

url

/v1/scrape/mercadolibre/product

sync · async

query, domain

/v1/scrape/mercadolibre/search

sync · async

query, domain

/v1/scrape/mercadolivre/product

sync · async

query, domain

/v1/scrape/mercadolivre/search

sync · async

query, domain

/v1/scrape/metromarket

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/metromarket/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/metromarket/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/neobits/search

sync · async

query, domain

/v1/async/scrape/perplexity

async · batch

query

/v1/scrape/petco

sync · async

url, store_id

/v1/scrape/petco/search

sync · async

query, domain, fulfillment_type, start_page, store_id

/v1/scrape/picknsave

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/picknsave/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/picknsave/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/publix

sync · async

url, store_id

/v1/scrape/publix/product

sync · async

query, store_id

/v1/scrape/publix/search

sync · async

query, store_id

/v1/scrape/qfc

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/qfc/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/qfc/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/rakuten

sync · async

url

/v1/scrape/rakuten/search

sync · async

query, domain

/v1/scrape/ralphs

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/ralphs/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/ralphs/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/safeway/category

sync · async

query, zip_code, zip_code_url

/v1/scrape/safeway/product

sync · async

query, zip_code

/v1/scrape/safeway/search

sync · async

query, zip_code

/v1/scrape/smithsfoodanddrug

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/smithsfoodanddrug/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/smithsfoodanddrug/search

sync · async

query, brand, delivery_zip, fulfillment_type, price_range, store_id

/v1/scrape/target

sync · async

url, delivery_zip, fulfillment_type, store_id

/v1/scrape/target/category

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/target/product

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/target/search

sync · async

query, delivery_zip, fulfillment_type, store_id

/v1/scrape/tiktok

sync · async

url

/v1/scrape/tiktok/shop/product

sync · async

query, country, uuid

/v1/scrape/tiktok/shop/search

sync · async

query, country

/v1/scrape/walmart

sync · async

url, fulfillment_type, store_id

/v1/scrape/walmart/product

sync · async

query, domain, fulfillment_type, store_id

/v1/scrape/walmart/search

sync · async

query, domain, fulfillment_speed, fulfillment_type, max_price, min_price, sort_by, start_page, store_id

Last updated

Was this helpful?