Skip to content
    ↑↓ to choose · Enter to open

    · 18 min read

    Fyple Scraper - Local Business Directory: 37 Data Fields per Record

    By CrawlerBros Engineering Team

    Fyple Scraper collects names, addresses, phone numbers, emails, websites, ratings, and more for local businesses across 7 countries. Each record carries 37 output fields. This Actor supports three modes: browsing by category, running a keyword search, or fetching specific business profiles by URL. It operates on Fyple's publicly available pages, requiring no login or API key, and can return up to 1,000 results per month on Apify's free plan. This Actor is designed for users who need structured local business data for lead generation, market analysis, or populating a local search product. It is not for anyone who requires historical data or real-time updates, as the scraper provides a snapshot at the time of the run.

    Try it: open Fyple Scraper - Local Business Directory on Apify, sign in on the free plan and run the prefilled example.

    Can you try Fyple Scraper - Local Business Directory before paying?

    Yes. Apify's free plan includes $5.00 of prepaid usage every month and asks for no credit card. At $0.005 per result, that covers up to 1,000 results of Fyple Scraper - Local Business Directory a month, before run-start charges and platform usage.

    The example request further down caps maxItems at 20, so a first run returns at most 20 results and costs at most $0.10 in result charges. That is enough to see the real shape of the data before deciding anything.

    Fyple Scraper - Local Business Directory was last updated on 2026-07-21. It is one of 1,725 Actors CrawlerBros publishes on Apify, which together have 692,561 lifetime public runs and an average rating of 4.63 out of 5 across 416 reviews.

    What does it cost to run Fyple Scraper - Local Business Directory?

    Each result costs $0.005 on Apify's free plan, which is $5.00 per 1,000 results. Starting a run is charged separately at $0.005 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

    Apify plan Per result Per 1,000 results
    FREE $0.005 $5.00
    BRONZE $0.00433 $4.33
    SILVER $0.00367 $3.67
    GOLD $0.003 $3.00
    PLATINUM $0.003 $3.00
    DIAMOND $0.003 $3.00

    The primary driver of cost for this Actor is the number of results returned, which is controlled by the "maxItems" input. Since results are charged at $0.005 per result on the free tier, a higher "maxItems" value directly translates to a higher bill. To test the Actor's suitability for your needs cheaply, set "maxItems" to a low number like 20, which on the free plan will incur at most $0.10 in result charges.

    How do you run Fyple Scraper - Local Business Directory from the API?

    The schema marks 2 of its 11 controls as required: mode, country. Every value in the payload below comes from the published schema's own prefills, which means you can paste it, swap the token, and get a real result.

    Call the synchronous endpoint to start a run and receive dataset items in one request:

    curl -X POST "https://api.apify.com/v2/acts/crawlerbros~fyple-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"mode":"search","country":"us","category":"food-drink/restaurant","keyword":"Pizza","location":"New York","businessUrls":[],"minRating":0,"maxItems":20}'
    

    The same run from Python, using the official client:

    from apify_client import ApifyClient
    
    client = ApifyClient("<YOUR_APIFY_TOKEN>")
    
    run_input = {
      "mode": "search",
      "country": "us",
      "category": "food-drink/restaurant",
      "keyword": "Pizza",
      "location": "New York",
      "businessUrls": [],
      "minRating": 0,
      "maxItems": 20
    }
    
    run = client.actor("crawlerbros~fyple-scraper").call(run_input=run_input)
    
    for item in client.dataset(run["defaultDatasetId"]).iterate_items():
        print(item)
    

    And from Node.js:

    import { ApifyClient } from 'apify-client'
    
    const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })
    
    const input = {
      "mode": "search",
      "country": "us",
      "category": "food-drink/restaurant",
      "keyword": "Pizza",
      "location": "New York",
      "businessUrls": [],
      "minRating": 0,
      "maxItems": 20
    }
    
    const run = await client.actor('crawlerbros~fyple-scraper').call(input)
    const { items } = await client.dataset(run.defaultDatasetId).listItems()
    console.log(items)
    

    That endpoint blocks until the run completes. Fine while you are testing a handful of records, risky once a run takes minutes: a dropped connection loses the response even though the run itself finished. Switch to an asynchronous start with polling or a webhook before you schedule anything.

    Which Fyple Scraper - Local Business Directory inputs matter, and which can you skip?

    This Actor has 11 controls, with "mode" and "country" being the only two required inputs. For most initial runs, set the "mode" to "search" and specify a "country" and "category" to get a broad set of results. For a first run, it is best to leave "minRating" and other filtering options at their defaults and only adjust them once you have confirmed the basic data output.

    • mode (string): What to fetch: browse a category (optionally narrowed to a region/city), run a free-text keyword search, or fetch business profiles from direct Fyple URLs. Default: "search".
    • country (string): Which Fyple country edition to scrape. Each country is a separate directory of local businesses (mode=search, mode=keyword). Default: "us".
    • category (string): Business category to browse. Pick a common category, or choose 'Custom category' and type your own path below (mode=search). Default: "food-drink/restaurant".
    • customCategory (string): Free-text category path in the form 'parent-group/subcategory', e.g. 'legal-financial/notary' or 'shopping-service/jewelry-store' (mode=search). Takes priority over 'Category' when set. Fyple has 500+ subcategories; browse https://www.fyple.com/categories/ to find exact slugs.
    • region (string): State, province, or region to narrow the category browse to, e.g. 'ca' for California or 'on' for Ontario. Optional -- omit to browse the category nationwide (mode=search).
    • city (string): City to narrow the category browse to, e.g. 'Los Angeles'. Requires 'Region' to also be set (mode=search).
    • keyword (string): Business name or type to search for, e.g. 'Pizza' or 'Plumber' (mode=keyword, required).
    • location (string): City, state, or ZIP code to search near, e.g. 'New York' or 'Los Angeles, CA' (mode=keyword).
    • businessUrls (array): Direct Fyple business profile URLs to fetch, e.g. https://www.fyple.com/company/some-business-abc123/. Use the 'sourceUrl' field from search results. Default: [].
    • minRating (integer): Only return businesses rated at least this many stars, e.g. 4 for 4.0+. 0 means no minimum. Businesses with no rating are excluded once this is set above 0. Default: 0.
    • maxItems (integer): Hard cap on the number of business records to return. Default: 20.

    Fixed-choice controls: mode accepts search (Browse by category, region & city), keyword (Keyword search (business name / type + location)), byUrl (Fetch business profiles by URL); country accepts us (United States (fyple.com)), gb (United Kingdom (fyple.co.uk)), ca (Canada (fyple.ca)), za (South Africa (fyple.co.za)), nz (New Zealand (fyple.co.nz)), au (Australia (fyple.biz)), ie (Ireland (fyple.net)); category accepts 54 values (default food-drink/restaurant), including food-drink/restaurant (Restaurants), custom (Custom category (type path below)), food-drink/cafe (Cafes), food-drink/bar-and-pub (Bars & Pubs).

    What does Fyple Scraper - Local Business Directory return?

    The records returned are comprehensive business profiles, including contact details like phone numbers, emails, and websites, along with detailed information such as opening hours, accepted payment types, and GPS coordinates. Notably, the output includes individual customer reviews up to the 20 most recent per business, which is useful for qualitative analysis. However, it does not include granular historical data for changes over time, nor does it provide a direct method for real-time monitoring of business updates.

    • name - business name
    • streetAddress, city, region, postalCode, country - full postal address
    • phone, mobile, fax - contact numbers (when published)
    • email - decoded from the business's published contact details
    • website - the business's own website
    • category - primary (most specific) listed category, categories[] - every category breadcrumb chain the business is listed under
    • rating, reviewCount - average star rating (1-5) and number of reviews
    • reviews[] - individual customer reviews ({author, rating, text, date} per review, up to 20 most recent), when the business has any
    • description - the business's own full description (falls back to Fyple's page summary when a business hasn't written one)
    • images[] - photo gallery URLs, when the business has uploaded photos
    • openingHours[] - structured opening hours ({day, hours} per day, when published)
    • acceptedPayments[] - payment types the business accepts (e.g. Visa, PayPal, Cash), when published
    • employeeCount, yearEstablished - company size and founding year, when the business has published them
    • amenities[] - business amenity flags the owner has ticked (e.g. Parking Available, Wi-Fi, Wheelchair Access, Takeaway & Delivery, Female Friendly), when published
    • facebookUrl, yelpUrl, twitterUrl, instagramUrl, linkedinUrl, pinterestUrl, youtubeUrl - social media and review-site profile links, when published
    • keywords[] - search keyword tags the business has associated with its listing, when published
    • latitude, longitude - GPS coordinates from the business's map listing
    • logoUrl - business logo/photo
    • nearbyBusinesses[] - other businesses located close by ({name, url, address, distance}), useful for competitor/area mapping
    • sourceUrl - canonical Fyple profile URL for the business
    • recordType: "business", scrapedAt

    These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

    How do you build the workflow end to end?

    Open Fyple Scraper - Local Business Directory and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

    1. Set the "mode" to "search" and choose a "country" to start, then pick an initial "category".
    2. Run the Actor once with "maxItems" set to a low number, such as 20, to verify the output structure.
    3. Examine the dataset for the name, streetAddress, phone, and category fields. Confirm they are present and correctly formatted.
    4. If the initial run is satisfactory, increase "maxItems" and refine your "category", "region", and "city" inputs as needed for your target volume.
    5. For keyword searches, change "mode" to "keyword" and provide values for "keyword" and "location". Note that keyword searches do not paginate.
    6. For specific businesses, set "mode" to "byUrl" and populate the "businessUrls" array with the sourceUrl values from previous results or directly obtained Fyple profile links.
    7. Integrate the data into your system, paying attention to the scrapedAt timestamp for freshness and the sourceUrl for deduplication.
    8. Schedule the Actor to run at intervals appropriate for your use case, ensuring you monitor for changes in data structure or unexpected empty fields.

    How do you apply it? Three worked playbooks

    These are Fyple Scraper - Local Business Directory's own documented use cases, each worked through as an operating pattern rather than a description.

    Use case 1: Local lead generation

    Outcome: Build a prospect list of businesses by trade, region, and city for B2B outreach

    Configure: Set "mode" to "search", select your target "country", then define a "category" (or "customCategory"), "region", and "city" for your desired market. Use "minRating" to filter for higher-quality leads.

    Working method: Start by selecting a single, well-defined category and a specific region and city to generate a focused list. Run with a low maxItems to review the output, ensuring email and website fields are present for a good proportion of the records. If satisfied, expand your search by adding more city or region inputs, or iterating through related category values.

    Deliverable: A CSV file or database table containing business names, addresses, phone numbers, emails, websites, and categories for targeted businesses.

    Stop condition: More than 10% of results are missing both an email and website, making them unsuitable for lead generation.

    Use case 2: Market research

    Outcome: Measure business density and average ratings for a category across markets

    Configure: Set "mode" to "search". Iterate through different "country" and "category" combinations. Leave "region" and "city" blank to get nationwide data. Set "maxItems" to a sufficiently high number to capture all businesses.

    Working method: Begin by running the Actor for a single category across several country editions, leaving region and city undefined to collect nationwide data. Collect the rating and reviewCount for each business. Aggregate this data to calculate average ratings and business counts per category per country, allowing for cross-market comparisons.

    Deliverable: A spreadsheet or dashboard showing business counts, average ratings, and distribution of businesses per category across the selected countries.

    Stop condition: The reviewCount or rating fields are frequently missing, preventing accurate aggregation of market data.

    Use case 3: Directory aggregation

    Outcome: Feed structured local-business data into your own local-search product

    Configure: Set "mode" to "search", choose your target "country", and select broad "category" values or iterate through customCategory values. Set "maxItems" to 2000 to maximize data collection per run.

    Working method: Start by extracting data for broad categories nationwide, collecting the full business profiles, including openingHours[], acceptedPayments[], and latitude/longitude. Ensure the sourceUrl is retained for deduplication and future updates. Gradually refine your inputs to cover all relevant categories and regions for your product's coverage, scheduling regular runs to keep data fresh.

    Deliverable: A populated database of structured local business data, ready for integration into a local search product, with fields like name, address, categories, contact information, and geo-coordinates.

    Stop condition: The latitude or longitude fields are frequently null, making it difficult to accurately map businesses in your product.

    What breaks, and how do you design around it?

    • Keyword search returns a single page. Fyple's free-text keyword search does not expose further pagination in its results page, so mode=keyword returns up to ~20 results per run. For larger volumes, use mode=search (category browse), which paginates fully.
    • Category browsing requires a curated or custom category path. Fyple's free-text search endpoint occasionally rejects unusual keyword/location combinations; mode=search (category + optional region/city) is the more reliable bulk-scraping path and is recommended for large runs.
    • region is a short code, not a free-text place name. Fyple's region URLs use short codes (e.g. ca for California, on for Ontario) rather than full names. Check a business's own region output field or Fyple's site navigation for the exact code for your market.
    • minRating is applied client-side. A business with no rating on Fyple is only excluded once minRating is set above 0 (which requires a rating to compare against).
    • Opening hours, accepted payments, mobile/fax numbers, email, reviews, photos, social links, and "more details" fields (employee count, year established, keywords, amenities) are only present when the business itself has published them - most listings have at least a name, address, and phone number, but the richer fields vary per business.
    • reviews[] is capped at the 20 most recent reviews per business to keep records a manageable size; reviewCount still reflects the business's true total review count.

    When running a keyword search using mode=keyword, be aware that results are limited to a single page. For larger data volumes, switch to mode=search (category browse) to leverage full pagination. If a region input fails to narrow results, verify the short code against Fyple's site navigation or a business's region output field, as these codes are not free-text. Be prepared for some records to lack richer fields like email or openingHours[]; design your downstream processes to gracefully handle their absence.

    When should you not use Fyple Scraper - Local Business Directory?

    This Actor is not suitable if your primary need is real-time monitoring of business changes, as it provides a snapshot at the time of the scrape. For continuous tracking, consider implementing a custom solution with change detection logic, or for very high-volume, real-time data, an official API would be more appropriate if one exists for your target directory. Furthermore, if you require contact details that are not publicly displayed on Fyple, such as direct owner emails not listed on the business profile, this Actor will not provide them. In such cases, a more specialized B2B lead generation service might be a better fit. If your project is focused exclusively on business directories in New Zealand, the Kiwi Directory Scraper - New Zealand Business Directory is a more targeted option; for Swiss businesses, consider the local.ch Scraper - Swiss Business Directory; and for German directories, the DasTelefonbuch Scraper - German Business Directory or 11880.com Scraper - German Business Directory are available.

    What should you check before trusting the output?

    • Verify that the name field is always present and not null, as a missing business name indicates a structural scraping issue.
    • Check for missing or malformed streetAddress, city, and region fields in a sample of records, particularly for businesses in different geographical areas.
    • Ensure that phone numbers, when present, conform to expected international formats for the country chosen.
    • Confirm that rating and reviewCount fields, when present, contain valid numerical values and that reviews[] contains up to 20 individual review objects.
    • Monitor for records where the category field is missing or generic, especially if you are using customCategory for niche markets.
    • Periodically inspect a subset of website and email fields to ensure they are valid and functional, as these are critical for outreach.

    None of this proves a record is correct. It gives a scheduled Fyple Scraper - Local Business Directory run defined points where it should stop instead of quietly passing bad data downstream.

    Frequently asked questions

    Which countries are covered by Fyple Scraper?

    Fyple Scraper covers local business directories in seven countries: the United States (fyple.com), United Kingdom (fyple.co.uk), Canada (fyple.ca), South Africa (fyple.co.za), New Zealand (fyple.co.nz), Australia (fyple.biz), and Ireland (fyple.net). You select the desired country using the country input field. Each country edition is treated as a separate directory.

    How much does it cost to use Fyple Scraper?

    On Apify's free plan, the Actor costs $0.005 per result, which is $5.00 per 1,000 results, plus platform usage. Apify's free plan includes $5.00 of monthly usage without requiring a credit card, which covers up to 1,000 results from this Actor before any run-start charges. Higher Apify plans offer lower per-result rates.

    Why are some fields like email or website missing from business profiles?

    Fyple Scraper only returns data that businesses have publicly provided and published on their Fyple profile pages. If a business has not provided an email, website, or other optional details like opening hours or social links, those fields will simply be omitted from the Actor's output record rather than being shown as empty or null. Most listings have at least a name, address, and phone number.

    Can I get individual customer reviews for businesses?

    Yes, when a business has received customer reviews, the Actor extracts up to its 20 most recent reviews. These are returned in the reviews[] array, with each review object containing the author, rating, text, and date of the review. The reviewCount field reflects the business's total number of reviews.

    What are the limitations when using keyword search?

    When using the mode=keyword setting, the Actor can only scrape results from a single page of Fyple's keyword search results. This typically limits the output to around 20 results per run. For collecting larger volumes of data, it is recommended to use mode=search (category browse), as this mode fully supports pagination across multiple result pages.

    Where to go next

    When you are ready to run it, open Fyple Scraper - Local Business Directory on Apify; the free plan covers up to 1,000 results a month.

    Start with the Fyple Scraper - Local Business Directory Actor page for the current input schema, pricing tier, and run history.

    Other Actors we maintain for related data:

    Related guides:

    Resources

    • Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-28.

    • Actor last updated by its maintainers on 2026-07-21.

    • Run outcome figures cover the 30 day public window ending 2026-09-28.

    • Fyple Scraper - Local Business Directory on Apify

    Featured actors

    Fyple Scraper - Local Business Directory

    Scrape Fyple, a local business directory covering the US, UK, Canada, South Africa, New Zealand, Australia, and Ireland. Browse by category, region and city, run a keyword search, or fetch full business profiles by URL. Get names, addresses, phone numbers, emails, websites, ratings, and more.

    Run on Apify ↗