# Experience Reviews Spider (`getdataforme/experience-reviews-spider`)

The Experience Reviews Spider is an  Actor that scrapes detailed reviews from platforms like Google. Extract review text, ratings, reviewer details, and responses from URLs. Ideal for sentiment analysis, reputation management, and market research. Fast, scalable, and delivers structured JSON output.

- **URL**: https://beta-securitybyobscurity.apify.com/getdataforme/experience-reviews-spider.md
- **Developed by:** [GetDataForMe](https://beta-securitybyobscurity.apify.com/getdataforme) (community)
- **Categories:** Agents, Developer tools
- **Stats:** 6 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$15.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

### Experience Reviews Spider

The **Experience Reviews Spider** is an Apify Actor that scrapes detailed review data from various online sources, such as Google reviews for businesses. It extracts review text, ratings, reviewer details, and responses, enabling users to analyze customer experiences and sentiments effectively.

### Input Parameters

The Actor requires a JSON input with the following parameters:

| Parameter | Type   | Description                                      | Required |
|-----------|--------|--------------------------------------------------|----------|
| `Urls`    | Array  | List of URLs containing reviews to scrape        | Yes      |

**Example Input:**

```json
{
    "Urls": [
        "https://www.experience.com/reviews/MsOceanside"
    ]
}
```

### Features

- **Detailed Review Extraction**: Captures review text, ratings, reviewer names, dates, and owner responses.
- **Multi-Source Compatibility**: Scrapes reviews from platforms like Google, with potential for other sources.
- **Structured JSON Output**: Delivers organized data for easy integration and analysis.
- **Reliable and Scalable**: Handles multiple URLs efficiently with robust error handling.
- **Contextual Metadata**: Includes source details, review IDs, and pinning status for comprehensive insights.

### Output

The Actor outputs an array of objects containing the scraped review details. Below is an example output:

```json
[
  {
    "uuid": "9d4a4b0a-c945-4d1e-8664-43dae7a77371",
    "review_detail_id": 9435870,
    "review_text": "Working with Melissa Huk was hands-down one of the best decisions we’ve made for our home. From the very beginning, she just got us—our style, our goals, and even things we didn’t know we wanted until she brought them to life.\nWhat started as a pretty uninspired space now feels like a completely new home. Every room feels intentional, yet relaxed—like it was designed with both beauty and real life in mind. The furniture, the textures, the flow—everything just works together in a way we never could have pulled off on our own.\nMelissa has an amazing eye for design, but what really stood out was how much thought she put into the details. It wasn’t just about making the space look good—it was about making it feel right. She noticed things we would’ve completely missed and made choices that elevated the whole project without ever feeling overdone. She made the whole process smooth and, honestly, fun. We always felt heard, but we also trusted her instincts completely—and that trust paid off in a big way. We’re beyond happy with how everything turned out and can’t recommend her enough.",
    "rating": 5,
    "reviewer_first_name": "Megan B",
    "reviewer_last_name": " ",
    "review_date": "Wed Jul 02 2025 14:16:23 GMT+0000 (Coordinated Universal Time)",
    "source_name": "google",
    "source_label": "Google",
    "is_pinned": false,
    "pinned_at": "",
    "replies": [
      "Owner: Hello Megan, Thank you so much for your kind words! We're thrilled to hear how happy you are with your new space. At Melissa Huk Interiors, we strive to create designs that not only look beautiful but truly reflect your lifestyle and personality. Your trust and collaboration made the process seamless, and we're so glad the results exceeded your expectations. Enjoy your refreshed home!\n\nThank you very much for this review. I can’t wait to post all the before and afters soon of this project. I’m still speechless over the transformation. Thank you for trusting me with the remodel process.  (Mon Jul 07 2025 02:51:24 GMT+0000 (Coordinated Universal Time))"
    ],
    "review_origin_link": "https://search.google.com/local/writereview?placeid=ChIJN4MIFu3524ARXPNi_MQ9r9U",
    "belongs_to_slug": "MsOceanside",
    "belongs_to_name": "Ms. Oceanside Real Estate"
  }
]
```

### Use Cases

- **Customer Sentiment Analysis**: Analyze reviews to understand customer satisfaction and experiences.
- **Business Reputation Management**: Monitor feedback for businesses to improve services or address concerns.
- **Market Research**: Collect review data to study trends in customer preferences across industries.
- **Competitor Analysis**: Compare review sentiments for similar businesses or services.
- **Data Integration**: Feed structured review data into CRM or analytics platforms for actionable insights.

### Support

For bug reports or custom needs, contact <support@getdataforme.com> or use our contact form: <https://getdataforme.com/contact/>.\
Please include a clear subject line in your message, such as "Experience Reviews Spider Support."

# Actor input Schema

## `Urls` (type: `array`):

The urls for the spider.

## Actor input object example

```json
{
  "Urls": [
    "https://www.experience.com/reviews/MsOceanside"
  ]
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/experience-reviews-spider").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/experience-reviews-spider").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 '{}' |
apify call getdataforme/experience-reviews-spider --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Experience Reviews Spider",
        "description": "The Experience Reviews Spider is an  Actor that scrapes detailed reviews from platforms like Google. Extract review text, ratings, reviewer details, and responses from URLs. Ideal for sentiment analysis, reputation management, and market research. Fast, scalable, and delivers structured JSON output.",
        "version": "0.0",
        "x-build-id": "h11KqUs77vz59hMJH"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~experience-reviews-spider/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-experience-reviews-spider",
                "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~experience-reviews-spider/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-experience-reviews-spider",
                "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~experience-reviews-spider/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-experience-reviews-spider",
                "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": "Urls",
                        "type": "array",
                        "description": "The urls for the spider.",
                        "default": [
                            "https://www.experience.com/reviews/MsOceanside"
                        ],
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
