GoodFirms Reviews and Companies Scraper A web scraper built with Apify SDK to extract company information and reviews from GoodFirms.co. ## Features - Scrapes company listings from category pages - Extracts detailed company information and reviews - Supports Apify proxy configuration - Handles pagination ## Input Parameters The scraper accepts the following input parameters: | Parameter | Type | Description | Required | |-----------|------|-------------|-----------| | mode | string | Scraping mode: index for company listings or company for detailed company information | No (defaults to "index") | | url | string | The URL to scrape. Can be either a category page (e.g., "https://www.goodfirms.co/companies/web-development-agency") or a company page (e.g., "https://www.goodfirms.co/company/unified-infotech") | Yes | ## Example inputs: ### For scraping company listings (index mode). The scraper will respect these filters and return only the companies that match the specified criteria: json { "mode": "index", "url": "https://www.goodfirms.co/companies/web-development-agency?employees%5B2%5D=10+-+49&reviews=5" } ### For scraping individual company details (company mode): json { "mode": "company", "url": "https://www.goodfirms.co/<company_url>" } ## Output Format ### Company Listing (mode: "index") typescript { name: string; link: string | null; employRange: string; location: string; founded: string; website: string | null; metaRatings: { ratingValue: string | null; bestRating: string | null; worstRating: string | null; reviewCount: string | null; } } ### Company Detail (mode: "company") typescript { address: string; city: string; region: string; zipCode: string; phoneNumber: string; socialLinks: string[]; totalReviews: number; reviews: Array<{ id: string; title: string; author: string; position?: string; date: string; description: string; rating: { quality?: string; schedule?: string; communication?: string; overall?: string; } }> } ## Output Examples ### Company Listing Output (mode: "index") json [ { "name": "Unified Infotech", "link": "https://www.goodfirms.co/company/unified-infotech", "employRange": "50-249", "location": "New York, United States", "founded": "2010", "website": "https://www.unifiedinfotech.net", "metaRatings": { "ratingValue": "4.9", "bestRating": "5", "worstRating": "1", "reviewCount": "32" } }, { "name": "Another Company", "link": "https://www.goodfirms.co/company/another-company", "employRange": "10-49", "location": "San Francisco, United States", "founded": "2015", "website": "https://www.anothercompany.com", "metaRatings": { "ratingValue": "4.7", "bestRating": "5", "worstRating": "1", "reviewCount": "25" } } ] ### Company Detail Output (mode: "company") json { "address": "711 3rd Avenue", "city": "New York", "region": "NY", "zipCode": "10017", "phoneNumber": "+1 (929) 222-1234", "socialLinks": [ "https://www.linkedin.com/company/example", "https://twitter.com/example", "https://www.facebook.com/example" ], "totalReviews": 32, "reviews": [ { "id": "review123", "title": "Excellent Web Development Partner", "author": "John Smith", "position": "Project Manager", "date": "2023-12-15", "description": "They delivered our project on time and with excellent quality...", "rating": { "quality": "5", "schedule": "4.5", "communication": "5", "overall": "4.8" } }, { "id": "review124", "title": "Great Experience", "author": "Jane Doe", "position": "CTO", "date": "2023-11-30", "description": "Professional team with strong technical expertise...", "rating": { "quality": "4.8", "schedule": "4.7", "communication": "4.9", "overall": "4.8" } } ] } ## 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 Goodfirms's public review directory. Please ensure your usage complies with goodfirms.co's terms of service and robots.txt policies.