# Youparade Reviews Scraper (`getdataforme/youparade-reviews-scraper`)

The Youparade Reviews Scraper extracts customer reviews from YourParade product pages, including ratings, text, and sizing feedback. With proxy support and customizable limits, it delivers structured JSON for sentiment analysis, market research, or e-commerce optimization.

- **URL**: https://beta-securitybyobscurity.apify.com/getdataforme/youparade-reviews-scraper.md
- **Developed by:** [GetDataForMe](https://beta-securitybyobscurity.apify.com/getdataforme) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 results

This Actor is paid per result. You are not charged for the Apify platform usage, but only a fixed price for dataset items the Actor outputs.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-result

# README

### Youparade Reviews Scraper

The **Youparade Reviews Scraper** is an Apify Actor that extracts customer reviews from YourParade product pages. By providing product URLs, users can collect detailed review data, including ratings, review text, and sizing feedback, for customer sentiment analysis or market research.

### Input Parameters

The Actor requires a JSON input with the following parameters:

| Parameter            | Type   | Description                                                                 | Default                              |
|----------------------|--------|-----------------------------------------------------------------------------|--------------------------------------|
| `item_limit`         | Integer | Maximum number of reviews to scrape per URL.                                | 30                                   |
| `proxyConfiguration` | Object | Proxy settings for reliable scraping. Set `useApifyProxy: true` and specify `apifyProxyGroups` (e.g., `["RESIDENTIAL"]`). | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }` |
| `urls`               | Array  | List of YourParade product page URLs to scrape reviews from.                | `[]`                                 |

#### Example Input

```json
{
  "item_limit": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "urls": [
    "https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"
  ]
}
```

### Features

- **Comprehensive Review Extraction**: Captures review IDs, ratings, titles, review text, and sizing details.
- **Proxy Support**: Utilizes Apify's residential proxies for reliable and anonymous scraping.
- **Customizable Limits**: Set a maximum number of reviews with the `item_limit` parameter.
- **Structured JSON Output**: Delivers clean, organized data for easy integration into analysis tools.
- **Robust Error Handling**: Ensures consistent performance on dynamic YourParade review pages.

### Output

The Actor outputs an array of review objects in JSON format, each containing detailed review information.

#### Example Output

```json
[
  {
    "url": "https://apps.bazaarvoice.com/api/data/reviews.json?resource=reviews&action=REVIEWS_N_STATS&filter=productid%3Aeq%3A7585429028912&filteredstats=reviews&Stats=Reviews&limit=30&offset=0&limit_comments=3&sort=rating%3Adesc&passkey=cayMlJXpyNN6awZ7xW14sfaED9ooQbiOAxqIDlBDVkfj4&apiversion=5.5&displaycode=15870-en_us",
    "product_id": "7585429028912",
    "review_id": "350966910",
    "rating": "5",
    "title": "Wish they made more cheekies!",
    "review_text": "Please make more in this style! Cheeky briefs are awesome- I hate that you don't carry very many in the replay style that you used to have, because those are my very favorite. These are a close second. When I first put them on I suspected they might become a thong by the end of the day, but that was not the case- they are soft and  you forget you're wearing them - huge win. Please don't stop making the cheekies!",
    "submission_time": "2025-06-30T19:22:47.000+00:00",
    "user_nickname": "None",
    "is_verified_purchaser": true,
    "product_name": "N/A",
    "product_url": "N/A",
    "author_id": "f03b7149-8a54-5fd2-9382-29341adf0d9c",
    "author_location": "N/A",
    "size_purchased": "Small",
    "usual_size": "Small",
    "comfort_rating": "5",
    "fit_rating": "3",
    "is_recommended": "True",
    "comments": []
  }
]
```

### Use Cases

- **Customer Sentiment Analysis**: Analyze ratings and review text to understand customer satisfaction with YourParade products.
- **Product Feedback Collection**: Gather sizing and comfort feedback to inform inventory or design decisions.
- **Market Research**: Assess customer preferences for specific product styles, like cheeky briefs, for competitive analysis.
- **E-commerce Optimization**: Use review data to enhance product listings or marketing strategies.

### Support

For bug reports or custom needs, please contact us at **support@getdataforme.com** or use our contact form: <https://getdataforme.com/contact/>.\
Make sure to include a clear subject line in your message, such as "Youparade Reviews Scraper Support."

Thank you for using the Youparade Reviews Scraper!

# Actor input Schema

## `urls` (type: `array`):

Urls to scrape from

## `item_limit` (type: `integer`):

The maximum number of items to scrape.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "urls": [
    "https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"
  ],
  "item_limit": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"
    ],
    "item_limit": 30,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/youparade-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"],
    "item_limit": 30,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/youparade-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"
  ],
  "item_limit": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getdataforme/youparade-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/youparade-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Youparade Reviews Scraper",
        "description": "The Youparade Reviews Scraper extracts customer reviews from YourParade product pages, including ratings, text, and sizing feedback. With proxy support and customizable limits, it delivers structured JSON for sentiment analysis, market research, or e-commerce optimization.",
        "version": "0.0",
        "x-build-id": "DhgF9ZVNyck0ijJXr"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~youparade-reviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-youparade-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/getdataforme~youparade-reviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-youparade-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/getdataforme~youparade-reviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-youparade-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "Anker Product Urls",
                        "type": "array",
                        "description": "Urls to scrape from",
                        "default": [
                            "https://yourparade.com/collections/best-sellers/products/vintage-high-cut-cheeky-new-cotton-olive-night"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "item_limit": {
                        "title": "Max_limit",
                        "type": "integer",
                        "description": "The maximum number of items to scrape.",
                        "default": 30
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
