Feefo Reviews Scraper

This Apify actor scrapes customer reviews data from feefo.com for specified company pages.

Input Parameters

The input parameters are defined as a JSON object with the following fields:

Parameter	Type	Required	Description	Default	Options
url	string	Yes	Full URL of the company page (e.g., https://www.feefo.com/en-GB/reviews/emperor-divers)	-	-
date	string	No	Filter reviews by time period	"ALL"	"ALL", "WEEK", "MONTH", "SIX_MONTHS", "YEAR"
score	string	No	Filter reviews by rating score	"" (All)	"", "5", "4", "3", "2", "1"
pages	integer	No	Maximum number of review pages to scrape	10	-

Example Input

1{
2    "url": "https://www.feefo.com/en-GB/reviews/emperor-divers",
3    "date": "MONTH",
4    "score": "5",
5    "pages": 5
6}

Output Structure

The actor outputs structured review data from Feefo in the following format:

1interface ScraperOutput {
2    reviews: Review[];
3    domain: string;
4    rating: AggregateRating;
5    name: string;
6    description: string;
7    website: string;
8    url: string;
9    ID: string;
10    image: string;
11    phone: string;
12    country: string;
13    address: string;
14    city: string;
15    zipCode: string;
16    region: string;
17}
18
19interface Review {
20    id: string;
21    author: {
22        "@type": "Person";
23        name: string;
24    };
25    url: string;
26    comment: string;
27    reviewRating: {
28        "@type": "Rating";
29        ratingValue: number;
30    };
31    inLanguage: string;
32}
33
34interface AggregateRating {
35    "@type": "AggregateRating";
36    bestRating: number;
37    reviewCount: number;
38    ratingValue: number;
39    worstRating: number;
40}

Example Response

1{
2    "reviews": [
3        {
4            "id": "123a456be7c8f9d012345678",
5            "author": {
6                "@type": "Person",
7                "name": "Trusted Customer"
8            },
9            "url": "https://www.feefo.com/reviews/example-company/123a456be7c8f9d012345678/customer-review-great-experience",
10            "comment": "The staff was very professional and attentive. The facilities were excellent and the overall experience was very enjoyable. Would definitely recommend their services.",
11            "reviewRating": {
12                "@type": "Rating",
13                "ratingValue": 5
14            },
15            "inLanguage": "en-GB"
16        }
17    ],
18    "domain": "example-company",
19    "rating": {
20        "@type": "AggregateRating",
21        "bestRating": 5,
22        "reviewCount": 1234,
23        "ratingValue": 4.8,
24        "worstRating": 1
25    },
26    "name": "Example Company",
27    "description": "Professional services with experienced staff. We offer various packages and solutions tailored to customer needs.",
28    "website": "https://www.example-company.com",
29    "url": "https://www.feefo.com/reviews/example-company",
30    "ID": "example-company",
31    "image": "https://www.feefo.com/api/merchant-image/example-company-logo.jpg",
32    "phone": "0123 456 7890",
33    "country": "United Kingdom",
34    "address": "123 Business Street, Suite 456",
35    "city": "London",
36    "zipCode": "SW1A 1AA",
37    "region": "Greater London"
38}

Note: The reviews array structure will be populated with actual review data when scraping is performed.

Usage

1. Configure input: Set the required company URL and optional filters (date range, score, page limit)
2. Run the actor: Execute the Apify actor with your input configuration
3. Process results: Access the structured review data from Apify's storage

Disclaimer

This actor is designed for legitimate data collection from Feefo's public review directory. Please ensure your usage complies with feefo.com's terms of service and robots.txt policies.