Unwrangle Ecommerce Content Retrieval APIs

https://docs.unwrangle.com
Admin
Unwrangle's Ecommerce Content Retrieval APIs provide structured data extraction from popular...
Tokens:72,320
Snippets:169
Trust Score:6.6
Update:1 year ago
Show doc for...
Tokens:
Raw
### Unwrangle API Platform Parameter Examples

Source: https://docs.unwrangle.com/ecommerce-data-apis

Demonstrates how to construct the `platform` parameter for the Unwrangle API to specify the retailer and data type for extraction, with real-world examples for different platforms and data types.

```text
# Get iPhone details from Amazon
platform=amazon_detail&url=https://amazon.com/dp/B0BCHJB3JH

# Search for "gaming laptop" on BestBuy
platform=bestbuy_search&search=gaming+laptop

# Browse Home Depot's power tools category
platform=homedepot_category&url=https://homedepot.com/b/Tools/N-5yc1v

# Get Walmart product reviews
platform=walmart_reviews&url=https://walmart.com/ip/12345
```

--------------------------------

### JSON Response Example from E-commerce Search

Source: https://docs.unwrangle.com/ace-hardware-search-api

Illustrates a typical JSON response structure from an e-commerce platform's search API. It details product attributes, pricing, inventory, and shipping information. This example is useful for developers integrating with such APIs or understanding data formats for product catalogs.

```json
{
    "success": true,
    "platform": "acehardware_search",
    "search": "ranges",
    "page": 1,
    "store_no": "09661",
    "total_results": 3842,
    "no_of_pages": 129,
    "result_count": 30,
    "results": [
        {
            "id": "3000537",
            "url": "https://www.acehardware.com/klein-tools-dual-range-voltage-tester-w-receptacle-tester/3000537",
            "name": "Klein Tools Dual Range Voltage Tester w/Receptacle Tester",
            "brand": "Klein Tools Dual Range Voltage Tester",
            "price": 39.99,
            "currency": "USD",
            "image_url": "https://cdn-tp3.mozu.com/24645-37138/cms/37138/files/99eae2df-2bd5-4530-8abd-8f256bc4b1d4?max=250&quality=80",
            "additional_images": [
                "https://cdn-tp3.mozu.com/24645-37138/cms/37138/files/a0fc0f0e-0eea-437e-b1ad-4bcc08d2d8b8?max=250&quality=80"
            ],
            "rating": 4.5,
            "total_reviews": 14,
            "in_stock": true,
            "shipping_options": [
                "pickup",
                "delivery"
            ],
            "category_id": null,
            "parent_category_id": null,
            "store_no": "09661",
            "upc": "092644693274",
            "mfg_part_number": "NCVT-2PKIT",
            "online_stock_available": 1,
            "online_soft_stock_available": 1,
            "online_location_code": "37138",
            "manage_stock": true,
            "out_of_stock_behavior": "DisplayMessage",
            "fulfillment_types_supported": [
                "DirectShip",
                "InStorePickup",
                "Delivery"
            ],
            "msrp": null,
            "catalog_sale_price": null,
            "catalog_list_price": 33.99,
            "sale_price_type": null,
            "price_list_entry_code": "Z01003_A",
            "price_type": "List",
            "effective_pricelist_code": "PROMO",
            "measurements": {
                "package_height": {
                    "unit": "in",
                    "value": 9.2
                },
                "package_width": {
                    "unit": "in",
                    "value": 4.5
                },
                "package_length": {
                    "unit": "in",
                    "value": 1.6
                },
                "package_weight": {
                    "unit": "lbs",
                    "value": 0.3
                }
            },
            "is_taxable": true,
            "is_recurring": false,
            "create_date": "2019-07-31T08:59:35.142Z",
            "update_date": "2025-09-02T12:37:28.924Z",
            "days_available_in_catalog": 2228,
            "whats_included": "NCVT2P Dual Range Non-Contact Voltage Tester; RT105 Receptacle Tester; Instructions; and All Required Batteries",
            "accessory_skus": " ",
            "feature_1_text": "Kit contains a non-contact voltage tester and receptacle tester",
            "feature_2_text": "Dual range NCVT-2P automatically detects and indicates low voltage range and standard voltage (48-1000V AC)",
            "feature_3_text": "NCVT-2P provides non-contact detection of standard voltage in cables, cords, circuit breakers, lighting fixtures, switches, outlets and wires",
            "feature_4_text": "NCVT-2P is a lightweight, compact tool with pocket clip for convenient storage and quick access",
            "replacement_part_skus": " ",
            "product_group_description": "TESTERS/TESTER FUSES",
            "product_type_description": "Meters and Testers",
            "merchandise_class_description": "ELECTRICAL TOOLS/TESTERS",
            "delivery_flag": "Y",
            "shipping_code": "Y",
            "warranty_code": "N",
            "country_of_origin": "CN",
            "ds_restocking_fee_pct": 0,
            "ds_return_shipping_terms": " ",
            "ds_returnable_days": " ",
            "ds_returnable_flag": " ",
            "ds_free_returns_flag": " ",
            "third_party_delivery_eligible": "Y",
            "categories_detailed": [
                {
                    "id": 2064,
                    "code": "010011101004",
                    "name": "Meters and Testers",
                    "sequence": 551,
                    "is_displayed": true,
                    "parent": {
                        "id": 227,
                        "code": "0100111",
                        "name": "Electrical Tools"
                    }
                },
                {
                    "id": 25631,
                    "code": "25631",
                    "name": "UPS Items",
                    "sequence": 62,
                    "is_displayed": false
                },
                {
                    "id": 26229,
                    "code": "26229",
                    "name": "dz test",
                    "sequence": 72,
                    "is_displayed": false
                }
            ]
        }
    ]
}

```

--------------------------------

### Fetch Ferguson Home Listings (Ruby)

Source: https://docs.unwrangle.com/fergusonhome-search-api

This Ruby example uses the built-in `net/http` and `uri` libraries to make a GET request to the Ferguson Home Search API and prints the raw response.

```ruby
require 'net/http'
require 'uri'
 uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=fergusonhome_search&search=Pedestal+Bathroom+Sinks&page=1&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response
```

--------------------------------

### Scrape Target Reviews using JavaScript

Source: https://docs.unwrangle.com/target-product-reviews-api

This JavaScript example uses the 'fetch' API to make a GET request to the Target Reviews API. It retrieves product reviews for a given URL and API key, then logs the JSON response to the console.

```JavaScript
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=target_reviews&url=https%3A%2F%2Fwww.target.com%2Fp%2Fkeurig-k-mini-single-serve-k-cup-pod-coffee-maker%2F-%2FA-53788870&with_photos=true&api_key=API_KEY')
const data = await response.json()
console.log(data)
```

--------------------------------

### Scrape Tesco Reviews using Ruby

Source: https://docs.unwrangle.com/tesco-product-reviews-api

This Ruby example shows how to get Tesco product reviews using the Net::HTTP library. It constructs the URI and performs a GET request, printing the raw response.

```ruby
require 'net/http'
require 'uri'

uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=tesco_reviews&tpn=53441318&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response
```

--------------------------------

### GET /api/getter

Source: https://docs.unwrangle.com/target-product-data-api

Scrapes product data for any product listing URL on Target.com in real-time.

```APIDOC
## GET /api/getter

### Description
This endpoint allows you to scrape product data for any product listing URL on Target.com in real-time.

### Method
GET

### Endpoint
/api/getter/

### Parameters
#### Query Parameters
- **url** (string) - Required - Product listing's URL on Target.com. Remove unnecessary query parameters and URL-encode the URL.
- **platform** (string) - Required - Specifies the scraping engine to invoke. Use `target_detail` for Target product details.
- **api_key** (string) - Required - Your account's API key.
- **store_no** (integer) - Optional - Target store number. Defaults to 3991. Affects product availability and pricing.

### Request Example
```json
{
  "example": "https://data.unwrangle.com/api/getter/?platform=target_detail&url=https%3A%2F%2Fwww.target.com%2Fp%2Fkeurig-k-mini-single-serve-k-cup-pod-coffee-maker%2F-%2FA-53788870&api_key=API_KEY"
}
```

### Response
#### Success Response (200)
- **product_name** (string) - The name of the product.
- **price** (string) - The current price of the product.
- **rating** (string) - The product's average customer rating.
- **reviews** (string) - The number of customer reviews.
- **image** (string) - The URL of the product's main image.
- **description** (string) - A description of the product.
- **store_availability** (array) - An array of objects indicating availability in different stores.

#### Response Example
```json
{
  "example": {
    "product_name": "Keurig K-Mini Single Serve K-Cup Pod Coffee Maker",
    "price": "$79.99",
    "rating": "4.7",
    "reviews": "3280",
    "image": "https://image.url/for/keurig.jpg",
    "description": "Compact and versatile coffee maker...",
    "store_availability": [
      {
        "store_no": "3991",
        "in_stock": true,
        "pickup_time": "1-2 hours"
      }
    ]
  }
}
```
```

--------------------------------

### Scrape Bed Bath & Beyond Product Details with JavaScript

Source: https://docs.unwrangle.com/bedbathbeyond-product-data-api

This JavaScript example uses the `fetch` API to asynchronously retrieve product information from Bed Bath & Beyond. It sends a GET request to the specified endpoint with the product URL and API key, and then logs the resulting JSON data to the console.

```javascript
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=bedbathbeyond_detail&url=https%3A%2F%2Fwww.bedbathandbeyond.com%2FHome-Garden%2FAlexander-Home-Megan-Traditional-Area-Rug%2F32828549%2Fproduct.html&api_key=API_KEY')
const data = await response.json()
console.log(data)
```

--------------------------------

### GET /api/getter/

Source: https://docs.unwrangle.com/walmart-product-reviews-api

Retrieves customer reviews for a specified Walmart product listing URL.

```APIDOC
## GET /api/getter/

### Description
Retrieves customer reviews for a specified Walmart product listing URL.

### Method
GET

### Endpoint
`https://data.unwrangle.com/api/getter/`

### Parameters
#### Query Parameters
- **url** (string) - Required - The URL of the product listing page on Walmart.com.
- **page** (integer) - Optional - The page number for the results. Defaults to 1.
- **sort_by** (string) - Optional - The sorting order for the reviews. Possible values: `recent`, `relevant`, `lowest`, `highest`, `helpful`. Defaults to `recent`.
- **platform** (string) - Required - Specifies the scraping engine. Must be `walmart_reviews`.
- **api_key** (string) - Required - Your account's API key.

### Request Example
```
curl 'https://data.unwrangle.com/api/getter/?url=https://www.walmart.com/ip/Evenflo-Revolve360-Slim-2-in-1-Rotational-Car-Seat-Carver-Blue-Infant-Toddler/3193642084&page=1&platform=walmart_reviews&api_key=API_KEY'
```

### Response
#### Success Response (200)
- **id** (string) - Retailer ID of the review.
- **date** (string) - Date when the review was published.
- **author_name** (string) - Reviewer's name.
- **author_url** (string) - Reviewer's retailer profile link.
- **rating** (float) - Rating given by the reviewer.
- **review_title** (string) - Title of the review.
- **review_url** (string) - Link to the review.
- **review_text** (string) - Text content of the review.
- **review_imgs** (list) - List of image URLs included in the review.
- **meta_data** (dict) - Dictionary containing meta data like verified purchase status, helpful votes, etc.
- **lang_code** (string) - Language code of the review.
- **response** (string) - Seller's response to the review, if any.

#### Response Example
```json
{
  "reviews": [
    {
      "id": "some_review_id",
      "date": "2023-10-27T10:00:00Z",
      "author_name": "Jane Doe",
      "author_url": "https://www.walmart.com/reviews/reviewer/12345",
      "rating": 4.5,
      "review_title": "Great car seat!",
      "review_url": "https://www.walmart.com/reviews/12345",
      "review_text": "This car seat is amazing and very easy to install.",
      "review_imgs": [],
      "meta_data": {
        "verified_purchase": true,
        "helpful_votes": 10
      },
      "lang_code": "en",
      "response": "Thank you for your feedback!"
    }
  ]
}
```
```

--------------------------------

### GET /websites/unwrangle

Source: https://docs.unwrangle.com/acehardware-product-data-api

Retrieves detailed product information, including attributes, inventory status, and fulfillment options.

```APIDOC
## GET /websites/unwrangle

### Description
This endpoint retrieves comprehensive details about a product, including its name, brand, pricing, images, specifications, inventory status, and fulfillment options.

### Method
GET

### Endpoint
/websites/unwrangle

### Parameters

#### Query Parameters
* **id** (string) - Required - The unique identifier of the product.

### Response
#### Success Response (200)
- **name** (string) - Full product name including manufacturer part number.
- **brand** (string) - Product brand name.
- **brand_link** (string) - URL to the brand's page on Ace Hardware.
- **url** (string) - Product URL on Ace Hardware.
- **images** (list) - List of product image URLs.
- **description** (string) - Detailed product description.
- **highlights** (list) - Key product highlights.
- **model_no** (string) - Manufacturer model number.
- **upc** (string) - Universal Product Code.
- **retail_id** (string) - Retail identifier.
- **sku_id** (string) - Ace Hardware SKU identifier.
- **price** (float) - Current product price.
- **price_reduced** (float) - Reduced price if on sale.
- **currency** (string) - Currency code (e.g., USD).
- **currency_symbol** (string) - Currency symbol (e.g., $).
- **in_stock** (boolean) - Whether the product is in stock.
- **inventory_quantity** (int) - Available inventory quantity.
- **categories** (list) - Product category hierarchy with names and URLs.
- **specifications** (list) - Detailed product specifications.
- **features** (list) - Product features list.
- **retailer_badges** (list) - Special badges or labels.
- **inventory** (object) - Detailed inventory status information:
    - **quantity** (int) - Current available inventory.
    - **in_stock** (boolean) - Boolean stock status.
    - **discontinued** (boolean) - Whether the product is discontinued.
    - **buyable** (boolean) - Whether the product can be purchased.
    - **limited_quantity** (boolean) - If stock is limited.
- **key_features** (list) - Key product features.
- **product_family** (object) - Product variant and family information.
- **related_products** (object) - Related product recommendations.
- **fulfillment_options** (list) - Available fulfillment methods (pickup, delivery):
    - **pickup** (object) - Buy Online Pick Up in Store (BOSS) availability.
    - **delivery** (object) - Ship to Home (STH) options with timeline and charges.
- **classification** (object) - Product classification details.
- **additional_details** (object) - Order quantities and subscription info.
- **vendor** (object) - Vendor name and number.
- **store_details** (object) - Store-specific availability information.
- **shipping_details** (object) - Shipping charges and eligibility.
- **product_attributes** (object) - Sales rankings and accessory SKUs.
- **promotional_details** (object) - Current promotion information.
- **return_policy** (object) - Return policy details.
- **store_no** (string) - Store number if specified.

#### Response Example
```json
{
  "name": "Example Product Name",
  "brand": "Example Brand",
  "brand_link": "https://www.acehardware.com/brand/example",
  "url": "https://www.acehardware.com/product/example",
  "images": ["http://example.com/image1.jpg"],
  "description": "This is a detailed description of the example product.",
  "highlights": ["Highlight 1", "Highlight 2"],
  "model_no": "EX12345",
  "upc": "123456789012",
  "retail_id": "R12345",
  "sku_id": "SKU12345",
  "price": 19.99,
  "price_reduced": 15.99,
  "currency": "USD",
  "currency_symbol": "$",
  "in_stock": true,
  "inventory_quantity": 100,
  "categories": [{"name": "Tools", "url": "/category/tools"}],
  "specifications": [{"name": "Weight", "value": "1kg"}],
  "features": ["Feature A", "Feature B"],
  "retailer_badges": ["Bestseller"],
  "inventory": {
    "quantity": 100,
    "in_stock": true,
    "discontinued": false,
    "buyable": true,
    "limited_quantity": false
  },
  "key_features": ["Key Feature 1"],
  "product_family": {},
  "related_products": {},
  "fulfillment_options": [
    {
      "pickup": {"available": true}
    },
    {
      "delivery": {"timeline": "2-3 days", "charges": 5.99}
    }
  ],
  "classification": {},
  "additional_details": {},
  "vendor": {},
  "store_details": {},
  "shipping_details": {},
  "product_attributes": {},
  "promotional_details": {},
  "return_policy": {},
  "store_no": "STORE123"
}
```
```

--------------------------------

### Get Product Details using Python

Source: https://docs.unwrangle.com/ecommerce-data-apis

This Python script shows how to fetch product details by making an HTTP GET request to the Unwrangle API. It utilizes the `requests` library and `urllib.parse.quote` for URL encoding, requiring the product URL, platform, and API key.

```python
import requests
from urllib.parse import quote

product_url = "https://www.amazon.com/Isopure-Protein-Powder-Isolate-Flavor/dp/B000E8ZJGS/"
encoded_url = quote(product_url)

response = requests.get(
    "https://data.unwrangle.com/api/getter/",
    params={
        "url": encoded_url,
        "platform": "amazon_detail",
        "api_key": "<API_KEY>"
    }
)

print(response.json())
```

--------------------------------

### GET /api/getter/

Source: https://docs.unwrangle.com/mercado-livre-product-details-api

Retrieves product details for a given Mercado Livre product URL.

```APIDOC
## GET /api/getter/

### Description
Retrieves product details for a given Mercado Livre product URL.

### Method
GET

### Endpoint
`/api/getter/`

### Parameters
#### Query Parameters
- **platform** (string) - Required - Specifies the scraping engine. Use `mercado_detail`.
- **url** (string) - Required - The URL of the Mercado Livre product listing. Must be URL or percent encoded.
- **api_key** (string) - Required - Your unique API key.

### Request Example
```json
{
  "request": "curl -L 'https://data.unwrangle.com/api/getter/?platform=mercado_detail&url=https%3A%2F%2Fproduto.mercadolivre.com.br%2FMLB-3670297668-shampoo-bio-extratus-jaborandi-crescimento-saudavel-1l-_JM&api_key=API_KEY'"
}
```

### Response
#### Success Response (200)
- **name** (string) - Name of the product
- **url** (string) - URL of the product listing
- **image** (string) - URL of the product's main image
- **price** (float) - Current price of the product
- **listing_price** (float) - Original listing price
- **currency** (string) - Currency code (e.g. BRL)
- **currency_symbol** (string) - Currency symbol (e.g. R$)
- **brand** (string) - Brand of the product
- **description** (string) - Detailed description of the product
- **rating** (float) - Average rating out of 5
- **total_ratings** (integer) - Total number of ratings
- **images** (list) - List of product image URLs
- **specifications** (list) - Product specifications
- **features** (list) - Product features
- **reviews** (list) - Product reviews
- **is_available** (boolean) - Whether product is in stock
- **state** (string) - Condition of product (new/used)
- **sold_by** (string) - Name of the seller
- **seller_sales** (string) - Number of sales by seller
- **seller_labels** (list) - Seller status labels

#### Response Example
```json
{
  "response": {
    "name": "Shampoo Bio Extratus Jaborandi Crescimento Saudável 1l",
    "url": "https://produto.mercadolivre.com.br/MLB-3670297668-shampoo-bio-extratus-jaborandi-crescimento-saudavel-1l-_JM",
    "image": "https://http2.mlstatic.com/D_NQ_NP_884136-MLB76020357609_052024-O.webp",
    "price": 35.90,
    "listing_price": 35.90,
    "currency": "BRL",
    "currency_symbol": "R$",
    "brand": "Bio Extratus",
    "description": "Shampoo Bio Extratus Jaborandi Crescimento Saudável 1l",
    "rating": 5.0,
    "total_ratings": 1,
    "images": [
      "https://http2.mlstatic.com/D_NQ_NP_884136-MLB76020357609_052024-O.webp",
      "https://http2.mlstatic.com/D_NQ_NP_995136-MLB76020357608_052024-F.webp"
    ],
    "specifications": [],
    "features": [],
    "reviews": [],
    "is_available": true,
    "state": "new",
    "sold_by": "Vendido e entregue por: Mercado Shops",
    "seller_sales": null,
    "seller_labels": []
  }
}
```
```

--------------------------------

### GET /api/getter/?platform=fergusonhome_search

Source: https://docs.unwrangle.com/fergusonhome-search-api

Fetches live product listings from Ferguson Home based on a search query and optional pagination.

```APIDOC
## GET /api/getter/?platform=fergusonhome_search

### Description
This endpoint allows you to search for products on Ferguson Home and retrieve structured listing data in real-time. It includes details such as pricing, variant availability, and merchandising flags.

### Method
GET

### Endpoint
`/api/getter/`

### Parameters
#### Query Parameters
- **platform** (string) - Required - Must be set to `fergusonhome_search` to invoke the Ferguson Home crawler.
- **search** (string) - Required - The keyword or phrase to search on Ferguson Home. Supports product names, collections, categories, brands, and long-tail queries.
- **page** (integer) - Optional - Results page to fetch. Defaults to `1`. Each page returns up to 24 products with full merchandising details.
- **api_key** (string) - Required - Your Unwrangle API token for authentication and billing. Pass in the query string as shown above or via the `Authorization` header.

### Request Example
```json
{
  "example": "GET https://data.unwrangle.com/api/getter/?platform=fergusonhome_search&search=Pedestal+Bathroom+Sinks&page=1&api_key=API_KEY"
}
```

### Response
#### Success Response (200)
- **products** (array) - An array of product objects, each containing detailed listing information.
- **total_results** (integer) - The total number of results found for the search query.
- **page** (integer) - The current page number.
- **total_pages** (integer) - The total number of pages available.

#### Response Example
```json
{
  "example": {
    "products": [
      {
        "product_id": "12345",
        "name": "Example Sink",
        "price": "$250.00",
        "variants": [
          {
            "sku": "SKU123",
            "color": "White",
            "availability": "In Stock"
          }
        ],
        "merchandising_flags": ["New Arrival"]
      }
    ],
    "total_results": 100,
    "page": 1,
    "total_pages": 5
  }
}
```
```

--------------------------------

### Yelp Search API: Ruby Example

Source: https://docs.unwrangle.com/yelp-search-api

Demonstrates how to get Yelp search results using Ruby's Net::HTTP library. The code parses the URL and fetches the data, printing the raw response.

```ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://data.unwrangle.com/api/getter?platform=yelp_search&search=pizza&location=San Francisco, CA, United States&api_key=API_KEY")
response = Net::HTTP.get(uri)
puts response
```

--------------------------------

### Scrape Ace Hardware Product Details using cURL

Source: https://docs.unwrangle.com/acehardware-product-data-api

This snippet demonstrates how to scrape detailed product information from Ace Hardware's website using a cURL command. It requires the product URL and an API key. The 'platform' parameter must be set to 'acehardware_detail'.

```cURL
curl 'https://data.unwrangle.com/api/getter/?platform=acehardware_detail&url=https%3A%2F%2Fwww.acehardware.com%2Fp%2F7026319&api_key=API_KEY'
```

--------------------------------

### Yelp Search API: Python Example

Source: https://docs.unwrangle.com/yelp-search-api

Shows how to retrieve Yelp search results using Python's requests library. The code makes a GET request to the API endpoint and prints the JSON response.

```python
import requests

url = "https://data.unwrangle.com/api/getter?platform=yelp_search&search=pizza&location=San Francisco, CA, United States&api_key=API_KEY"
response = requests.get(url)
print(response.json())
```

--------------------------------

### Search Products using Unwrangle API (Bash)

Source: https://context7.com/context7/unwrangle/llms.txt

This bash example demonstrates how to perform product searches on e-commerce platforms like Walmart and Best Buy using the Unwrangle API. It shows the basic structure of the curl command, specifying the platform, search query, and page number. Authentication is handled via an API key.

```bash
# Walmart search
curl 'https://data.unwrangle.com/api/getter/?platform=walmart_search&search=briefcase&page=1&api_key=YOUR_API_KEY'

# BestBuy search
curl 'https://data.unwrangle.com/api/getter/?platform=bestbuy_search&search=gaming+laptop&page=1&api_key=YOUR_API_KEY'
```

--------------------------------

### Traditional vs. Unified API Endpoint Examples

Source: https://docs.unwrangle.com/ecommerce-data-apis

Compares the traditional approach requiring separate API endpoints for each platform with the unified approach provided by Unwrangle, which uses a single endpoint with a platform parameter.

```text
❌ https://api.example.com/amazon/products
❌ https://api.example.com/walmart/search
❌ https://api.example.com/target/categories

✅ https://data.unwrangle.com/api/getter/
```

--------------------------------

### Scrape Wayfair Product Details using JavaScript

Source: https://docs.unwrangle.com/wayfair-product-data-api

This JavaScript example uses the Fetch API to retrieve Wayfair product data. It makes a GET request to the specified API endpoint and logs the resulting JSON data to the console.

```javascript
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=wayfair_detail&url=https%3A%2F%2Fwww.wayfair.com%2Ffurniture%2Fpdp%2Fmercury-row-benitez-twin-or-smaller-76-wide-faux-leather-tufted-back-convertible-sofa-w005404809.html&api_key=API_KEY')\nconst data = await response.json()\nconsole.log(data)
```

--------------------------------

### JSON Response Example for Product Detail

Source: https://docs.unwrangle.com/target-product-data-api

This JSON object represents a typical response from a product detail API. It contains success status, platform information, product URL, and a detailed 'detail' object with specifics like tcin, name, pricing, image URLs, and customer review data. No external dependencies are required to parse this standard JSON.

```json
{
    "success": true,
    "platform": "target_detail",
    "url": "https://www.target.com/p/keurig-k-mini-single-serve-k-cup-pod-coffee-maker/-/A-53788870",
    "result_count": 1,
    "detail": {
        "tcin": "53788870",
        "name": "Keurig K-Mini Single-Serve K-Cup Pod Coffee Maker",
        "url": "https://www.target.com/p/keurig-k-mini-single-serve-k-cup-pod-coffee-maker/-/A-53788870",
        "category_name": "Coffee & Espresso Makers",
        "categories": [
            {
                "name": "Kitchen & Dining",
                "url": "https://www.target.com/c/kitchen-dining/-/N-hz89j"
            },
            {
                "name": "Kitchen Appliances",
                "url": "https://www.target.com/c/kitchen-appliances-dining/-/N-5xtrs"
            },
            {
                "name": "Coffee & Espresso Makers",
                "url": "https://www.target.com/c/coffee-makers-tea-espresso-kitchen-appliances-dining/-/N-5xtro"
            }
        ],
        "brand": "Keurig",
        "brand_url": "https://www.target.com/b/keurig/-/N-5uvm4",
        "brand_linking_id": "5uvm4",
        "main_image": "https://target.scene7.com/is/image/Target/GUEST_f2462a7a-35de-4683-a205-af4fe0195d4f",
        "images": [
            "https://target.scene7.com/is/image/Target/GUEST_f2462a7a-35de-4683-a205-af4fe0195d4f",
            "https://target.scene7.com/is/image/Target/GUEST_712b5de8-2bfe-4a52-a3e0-8173ce33e5fc",
            "https://target.scene7.com/is/image/Target/GUEST_afde9d50-11ea-4bcc-b1d7-0cfae2889dc8",
            "https://target.scene7.com/is/image/Target/GUEST_669d0653-704a-4bb8-bed2-f8ef015271f7",
            "https://target.scene7.com/is/image/Target/GUEST_6b479b06-98f5-43dd-85b2-8fb5038579c7",
            "https://target.scene7.com/is/image/Target/GUEST_e2aa8897-8c4a-4d61-abbe-40243b0d5bc3",
            "https://target.scene7.com/is/image/Target/GUEST_2224b419-fbc9-4aaf-80a1-a71d938517a7",
            "https://target.scene7.com/is/image/Target/GUEST_a5298b71-ac7f-485a-90cc-acde84e52309",
            "https://target.scene7.com/is/image/Target/GUEST_628e84c2-37b6-463c-8f6f-7cbf4d93a9a2",
            "https://target.scene7.com/is/image/Target/GUEST_12c1a281-98ff-4e86-9404-8f1af884d473",
            "https://target.scene7.com/is/image/Target/GUEST_6b17ac96-993a-4278-9282-f3c35415aec6",
            "https://target.scene7.com/is/image/Target/GUEST_6c937477-fd80-492a-bd9e-9761ad3485eb",
            "https://target.scene7.com/is/image/Target/GUEST_46c69d38-4026-4e0e-9c31-b1efde55b63b",
            "https://target.scene7.com/is/image/Target/GUEST_d6b3d7ab-55c6-4112-a87e-2d20117c6083"
        ],
        "price": 89.99,
        "price_reduced": 89.99,
        "currency": "USD",
        "formatted_price_range": null,
        "current_price_min": 89.99,
        "current_price_max": null,
        "reg_price_min": null,
        "reg_price_max": 89.99,
        "price_type": "reg",
        "location_id": 3991,
        "price_per_unit": null,
        "rating": 4.06,
        "total_ratings": 14244,
        "rating_distribution": {
            "one_star": 2147,
            "two_star": 675,
            "three_star": 716,
            "four_star": 1431,
            "five_star": 9275
        },
        "total_reviews": 8132,
        "percentage_recommended": 58,
        "has_verified_reviews": true,
        "recommended_count": 1884,
        "not_recommended_count": 1312,
        "question_count": 237,
        "review_photos": [
            "https://target.scene7.com/is/image/Target/GUEST_342b5613-286d-40a2-9e9d-f0cc31948c4e",
            "https://target.scene7.com/is/image/Target/GUEST_34ec4786-e9ae-415a-8b67-1e50f637f8a8",
            "https://target.scene7.com/is/image/Target/GUEST_b234737c-00b6-435a-9b3b-85fb8181cb08",
            "https://target.scene7.com/is/image/Target/GUEST_38e996ee-dfc4-4ead-94bd-3fa8188f58e8",
            "https://target.scene7.com/is/image/Target/GUEST_f3e039cb-31d4-431e-acf2-d4c085e365f1",
            "https://target.scene7.com/is/image/Target/GUEST_071301d5-d9a8-407b-b467-b58425c904eb",
            "https://target.scene7.com/is/image/Target/GUEST_17bbf25a-1b42-4dbc-b0c7-85e221f7c1ac",
            "https://target.scene7.com/is/image/Target/GUEST_66f623dc-11e5-4b04-b0fb-078d31fb88d9",
            "https://target.scene7.com/is/image/Target/GUEST_f0f0a60b-66e5-42c7-b7ea-cc995c20e4cd",
            "https://target.scene7.com/is/image/Target/GUEST_622e6c33-3387-46de-aa3e-26ddd7836ea3",
            "https://target.scene7.com/is/image/Target/GUEST_a916ae73-9b66-4d42-863d-461fb562a086",
            "https://target.scene7.com/is/image/Target/GUEST_abfaa3c5-02d5-48f4-a731-80e2cdb6a387"
        ],
        "dpci": null,
        "dpci_description": "Retailer Department Product Classification ID",
        "relationship_type_code": "VPC",
        "cart_add_on_threshold": 35.0
    }
}
```

--------------------------------

### Product Data Structure Example

Source: https://docs.unwrangle.com/fergusonhome-search-api

This JSON snippet illustrates the structure for a product, including its core details, available variants, and associated features. It covers information like pricing, shipping eligibility, inventory status, and product specifications. Note that 'null' values indicate the absence of specific data.

```json
{
    "name": "Promenade 27-1/2" Pedestal Bathroom Sink with 3 Faucet Holes Drilled and Overflow - Less Pedestal",
    "brand": "TOTO",
    "id": 181542,
    "family_id": 592155,
    "model_no": "LT530.8",
    "url": "https://www.fergusonhome.com/toto-lt530-8/s592155?uid=181542",
    "rating": 4.75,
    "total_ratings": 4,
    "is_configurable": false,
    "is_square_footage_based": false,
    "is_appointment_only_brand": false,
    "variant_count": 5,
    "has_in_stock_variants": true,
    "all_variants_in_stock": true,
    "total_inventory_quantity": 11,
    "in_stock_variant_count": 5,
    "all_variants_restricted": false,
    "price": 304.38,
    "price_min": 304.38,
    "price_max": 583.8,
    "unit_price": null,
    "currency": "USD",
    "price_type": "STANDARD",
    "images": [
        "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-811-210.jpg"
    ],
    "thumbnail": "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-811-210.jpg",
    "variants": [
        {
            "id": 181541,
            "name": "Bone",
            "model_no": "LT530.8#03",
            "swatch_color": "DDD4BB",
            "url": "https://www.fergusonhome.com/toto-lt530-8/s592155?uid=181541",
            "is_quick_ship": false,
            "shipping_info": "",
            "has_free_shipping": false,
            "price": 400,
            "unit_price": null,
            "image": "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-803-209.jpg",
            "thumbnail": "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-803-209.jpg",
            "availability_status": "in_stock",
            "in_stock": true,
            "inventory_quantity": 0,
            "is_product_restricted": false
        },
        {
            "id": 181542,
            "name": "Colonial White",
            "model_no": "LT530.8#11",
            "swatch_color": "FFF5E3",
            "url": "https://www.fergusonhome.com/toto-lt530-8/s592155?uid=181542",
            "is_quick_ship": false,
            "shipping_info": "",
            "has_free_shipping": false,
            "price": 304.38,
            "unit_price": null,
            "image": "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-811-210.jpg",
            "thumbnail": "https://www.fergusonhome.com/content/dam/ferguson/product/toto/toto-lt530-811-210.jpg",
            "availability_status": "in_stock",
            "in_stock": true,
            "inventory_quantity": 6,
            "is_product_restricted": false
        }
    ],
    "features": [
        {
            "name": "Faucet Holes",
            "value": "3"
        },
        {
            "name": "Installation Type",
            "value": "Pedestal"
        },
        {
            "name": "Length",
            "value": "24"
        },
        {
            "name": "Material",
            "value": "Vitreous China"
        },
        {
            "name": "Sink Shape",
            "value": "Rectangular"
        },
        {
            "name": "Width",
            "value": "18.25"
        }
    ],
    "collection": {
        "name": "Veer",
        "url": "https://www.fergusonhome.com/collection/Kohler/Veer"
    },
    "is_quick_ship": true,
    "shipping_info": "FREE 2-Day Shipping"
}
```

--------------------------------

### Scrape Target Reviews using Ruby

Source: https://docs.unwrangle.com/target-product-reviews-api

This Ruby code snippet demonstrates fetching Target product reviews. It uses the 'net/http' library to make a GET request to the API endpoint with the provided URL and API key. The raw response is then printed.

```Ruby
require 'net/http'
require 'uri'
 uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=target_reviews&url=https%3A%2F%2Fwww.target.com%2Fp%2Fkeurig-k-mini-single-serve-k-cup-pod-coffee-maker%2F-%2FA-53788870&with_photos=true&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response
```

--------------------------------

### Yelp Search API: PHP Example

Source: https://docs.unwrangle.com/yelp-search-api

Provides a PHP example for fetching Yelp search results. It uses file_get_contents to make the request and json_decode to parse the response.

```php
<?php
$url = "https://data.unwrangle.com/api/getter?platform=yelp_search&search=pizza&location=San Francisco, CA, United States&api_key=API_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>
```

--------------------------------

### Extract Product Details using Unwrangle API (Bash)

Source: https://context7.com/context7/unwrangle/llms.txt

This example demonstrates how to retrieve detailed product information from e-commerce platforms like Amazon and Home Depot using the Unwrangle API via curl. It shows how to specify the platform, provide a product URL or ASIN, and include localization parameters if needed. Authentication is done using an API key.

```bash
# Amazon product details
curl 'https://data.unwrangle.com/api/getter/?platform=amazon_detail&url=https%3A%2F%2Fwww.amazon.com%2FApple-iPhone-13-128GB-Blue%2Fdp%2FB09LNX6KQS%2F&api_key=YOUR_API_KEY'

# Using ASIN instead of URL
curl 'https://data.unwrangle.com/api/getter/?platform=amazon_detail&asin=B09LNX6KQS&country_code=us&api_key=YOUR_API_KEY'

# Home Depot with store localization
curl 'https://data.unwrangle.com/api/getter/?platform=homedepot_detail&url=https%3A%2F%2Fwww.homedepot.com%2Fp%2FSunnydaze-Decor-10-5-ft-Fabric-Cotton-Double-Brazilian-Hammock-with-Stand-Combo-in-Beach-Oasis-DB-Combo-Oasis%2F306248639&store_no=2414&zipcode=04401&api_key=YOUR_API_KEY'
```
Tokens:
Raw