Web Scraper API

Web Scraper API is an all-in-one web data collection platform. It covers every stage of web scraping, from crawling URLs and bypassing IP blocks to precise data parsing and delivery to your preferred cloud storage. Extract data from search engines, e-commerce sites, travel platforms, and any other website.

Getting started

Create your API user credentials: Sign up for a free trial or purchase the product in the Oxylabs dashboard to create your API user credentials (USERNAME and PASSWORD).

If you need more than one API user for your account, please contact our customer support or message our 24/7 live chat support.

Request samples

Below, you'll find sample cURL requests. For examples in other programming languages, please refer to the relevant sections: Amazon, Google, Other Websites.

Amazon

curl 'https://realtime.oxylabs.io/v1/queries' \
--user "USERNAME:PASSWORD" \
-H "Content-Type: application/json" \
-d '{
        "source": "amazon_product",
        "query": "B07FZ8S74R",
        "geo_location": "90210",
        "parse": true
    }'

Google

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "adidas",
        "geo_location": "California,United States",
        "parse": true
    }'

Other

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://sandbox.oxylabs.io/"
    }'

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

17KB

amazon_product output example.json

23KB

Generic URL output example.json

Request parameter values

1. source - This parameter sets the scraper that will be used to process your request.

2. URL or query - Provide the URL or query for the type of page you want to scrape. Refer to the table below and the corresponding target sub-pages for detailed guidance on when to use each parameter.

3. Optionally, you can include additional parameters such as geo_location, user_agent_type, parse (find the list of our parsers here), render and more to customize your scraping request. Read more: Features.

- mandatory parameter

Scraping with URLs or parametrized inputs

Oxylabs support two general groups of inputs - URLs and parametrized inputs like queries, product or video IDs. Generic targets which do not have a dedicated source can be scraped with universal source.

Target	Source (Scraping URL)	Source (Using Query, Product or Video ID)
Amazon	amazon	amazon_product, amazon_search, amazon_pricing, amazon_sellers, amazon_bestsellers, amazon_reviews, amazon_questions
Google	google	google_search, google_ads, google_images, google_lens, google_maps, google_travel_hotels, google_suggest, google_trends_explore, google_shopping_product, google_shopping_search, google_shopping_pricing
Bing	bing	bing_search
YouTube	universal	youtube_transcript, youtube_search, youtube_metadata, youtube_downloader
ChatGPT	universal	chatgpt
Walmart	universal	walmart_search, walmart_product
eBay	universal	ebay_search
Kroger	kroger	kroger_product, kroger_search
Lowe's	lowes	lowes_search, lowes_product
Etsy	universal	etsy_search, etsy_product
Best Buy	universal	bestbuy_search, bestbuy_product
Target	universal	target_search, target_product
Costco	universal	costco_search
Menards	universal	menards_search
Staples	universal	staples_search
Petco	universal	petco_search
Grainger	universal	grainger_search
Instacart	universal	instacart_search
Bed Bath & Beyond	universal	bedbathandbeyond_search
Allegro	universal	allegro_search, allegro_product
MediaMarkt	universal	mediamarkt_search
Cdiscount	universal	cdiscount_search
IndiaMART	universal	idealo_search
MercadoLibre	universal	mercadolibre_search
MercadoLivre	universal	mercadolivre_search
Falabella	universal	falabella_search
Magazine Luiza	universal	magazineluiza_search
Dcard	universal	dcard_search
Alibaba	universal	alibaba_search
AliExpress	universal	aliexpress_search
Flipkart	universal	flipkart_search
Rakuten	universal	rakuten_search
SHEIN	universal	shein_search
Tokopedia	universal	tokopedia_search
Avnet	universal	avnet_search
IndiaMART	universal	indiamart_search
Lazada	universal	lazada_search
Other Websites	universal	Using query parameter is not supported

If you need any assistance in making your first request, feel free to contact us via the 24/7 available live chat.

Testing via Scraper APIs Playground

Try Web Scraper API and OxyCopilot in the Scraper APIs Playground.

Testing via Postman

Get started with our API using Postman, a handy tool for making HTTP requests. Download our Web Scraper API Postman collection and import it. This collection includes examples that demonstrate the functionality of the scraper. Customize the examples to your needs or start scraping right away.

For step-by-step instructions, watch our video tutorial below. If you're new to Postman, check out this short guide.

All information herein is provided on an "as is" basis and for informational purposes only. We make no representation and disclaim all liability with respect to your use of any information contained on this page. Before engaging in scraping activities of any kind you should consult your legal advisors and carefully read the particular website's terms of service or receive a scraping license.