🏢 Facebook Place Search Scraper This actor allows you to search and extract Facebook places based on keywords, with support for location filtering and automatic pagination. It leverages the latest Facebook Place Search API, ensuring robust and up-to-date results. ## Features - Keyword Search: Find places by any keyword or phrase. - Location Filter: Filter places by a specific location UID. - Auto Pagination: Automatically fetches multiple pages using the API cursor until the desired number of results (maxResults) is reached. - Structured Output: Returns a structured list of place objects with detailed metadata. ## Input Parameters | Field | Type | Required | Description | | -------------- | --------- | -------- | ---------------------------------------------------------------- | | query | string | Yes | Keywords to search for Facebook places. | | location_uid | string | No | Location unique identifier for filtering places. | | maxResults | integer | No | Maximum number of places to fetch (default: 5, max: 5000). | ## Output The output is a list of place objects, each containing: - type: Place type - profile_url: Place profile URL - url: Place URL - image: Place image information (uri, width, height, scale) - name: Place name - facebook_id: Facebook ID - is_verified: Whether the place is verified Example output: json [ { "type": "place", "profile_url": "https://www.facebook.com/lamejoroficial", "url": "https://www.facebook.com/lamejoroficial", "image": { "uri": "https://scontent.fmec2-1.fna.fbcdn.net/v/t39.30808-1/449711698_792789212975000_2635271177200978456_n.jpg?stp=dst-jpg_s120x120_tt6&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=xOI8Frogo_IQ7kNvwH_jogK&_nc_oc=Adk58JRbz1z0cF3lWjCdtZ0LwsHbA_Yvcxi5V0uvHEiO6a26LY3G9YJpDTF1AT9C7Js&_nc_zt=24&_nc_ht=scontent.fmec2-1.fna&_nc_gid=Dr4of4TG9_eKL-VdZLFvhw&oh=00_AfKg-4lx7KMsHWm5Kgea9II4GofIUi4HMjrRDZJ74TBCsA&oe=683B6D92", "width": 120, "height": 120, "scale": 2 }, "name": "La Mejor", "facebook_id": "100067317853332", "is_verified": true, "scrapedAt": "2025-05-27T09:19:06.229Z" }, ... ] ## Use Cases - Business research and analysis - Location-based marketing - Competitor analysis - Local business discovery - Market research ## Notes - The actor will automatically paginate using the API cursor until the maxResults limit is reached or no more results are available. - Make sure your query is specific enough to get relevant results. - The API may have rate limits, so consider using appropriate delays between requests. --- Enjoy fast and reliable Facebook place data extraction!