Facebook Events Extractor (Rich Metadata)cookieless

"# Facebook Events Extractor (Rich Metadata)cookieless

Overview

This actor performs a deep extraction of event metadata from Facebook's event discovery infrastructure, returning structured JSON records with comprehensive search context, geolocation data, and engagement metrics. Designed for high-volume event intelligence workflows, the extractor prioritizes data integrity through verification flags, timestamp precision, and cache status indicators. All outputs conform to a strict schema optimized for downstream analytics pipelines and CRM integration.

Data Dictionary

Field Name	Data Type	Definition
event_id	String	Unique identifier assigned to the extraction event record
external_id	String	External reference identifier for cross-system correlation and deduplication
scraped_at	String (ISO 8601)	UTC timestamp indicating when the data extraction was executed
query_type	String	Classification of the search operation performed (e.g., search_event, browse_category)
status	String	Execution status of the extraction job (completed, failed, partial)
is_verified	Boolean	Indicates whether the event source has been verified by the platform
language_code	String	ISO 639-1 language code with optional region identifier (e.g., en-US)
search_term	String	Original search query string submitted for event discovery
total_results	Integer	Total count of events matching the search criteria across all pages
page_number	Integer	Current page index in the paginated result set (1-indexed)
results_per_page	Integer	Maximum number of event records returned per page
processing_time_ms	Integer	Server-side processing duration in milliseconds
location.lat	Float	Geographic latitude coordinate of the search location
location.lng	Float	Geographic longitude coordinate of the search location
location.city	String	City name associated with the search geolocation
location.country_code	String	ISO 3166-1 alpha-2 country code
metrics.relevance_score	Float	Algorithmic relevance score (0.0-1.0) indicating search term match quality
metrics.click_through_rate	Float	Historical click-through rate for similar search queries
metrics.conversion_rate	Float	Historical conversion rate from search impression to event registration
filters_applied.date_range	String	Temporal filter applied to event start dates (e.g., next_6_months, this_week)
filters_applied.category	String	Event category filter (e.g., technology, business, arts)
filters_applied.price_range	String	Price range filter applied to event ticket costs
sentiment_score	Float	Aggregated sentiment score (0.0-1.0) derived from event descriptions and reviews
source_platform	String	API version or platform identifier used for data extraction
cache_status	String	Cache freshness indicator (fresh, stale, bypassed)

Sample Dataset

Below is a sample of the high-fidelity JSON output:

{
  ""event_id"": ""evt_2025122089314"",
  ""external_id"": ""srch_7f9a2b5e4d3c1a8b6"",
  ""scraped_at"": ""2025-12-20T14:22:31Z"",
  ""query_type"": ""search_event"",
  ""status"": ""completed"",
  ""is_verified"": true,
  ""language_code"": ""en-US"",
  ""search_term"": ""data conference 2026"",
  ""total_results"": 2834,
  ""page_number"": 1,
  ""results_per_page"": 50,
  ""processing_time_ms"": 234,
  ""location"": {
    ""lat"": 40.7128,
    ""lng"": -74.0060,
    ""city"": ""New York"",
    ""country_code"": ""US""
  },
  ""metrics"": {
    ""relevance_score"": 0.89,
    ""click_through_rate"": 0.064,
    ""conversion_rate"": 0.028
  },
  ""filters_applied"": {
    ""date_range"": ""next_6_months"",
    ""category"": ""technology"",
    ""price_range"": ""100-500""
  },
  ""sentiment_score"": 0.76,
  ""source_platform"": ""events_api_v3"",
  ""cache_status"": ""fresh""
}

Configuration Parameters

To ensure optimal data depth, configure the following:

Parameter	JSON Field Name	Data Type	Required	Description	Example Value
Search Query	query	String	Yes	Keyword or search term used to discover events	insights

Analytical Use Cases

Researchers and data scientists can leverage this structured output for:

• Lead Generation Scoring: Utilize relevance_score, click_through_rate, and conversion_rate metrics to prioritize high-value event opportunities for outreach campaigns
• Geographic Market Analysis: Aggregate event density by location fields to identify emerging conference hubs and regional industry concentration
• Sentiment Trend Analysis: Track sentiment_score over time to detect shifts in event perception and attendee satisfaction patterns
• Competitive Intelligence: Monitor total_results and category distributions to benchmark event supply against competitor activity
• Temporal Forecasting: Analyze date_range filters and scraped_at timestamps to predict seasonal event scheduling patterns and optimize marketing calendar alignment
• Price Elasticity Studies: Correlate price_range filters with engagement metrics to determine optimal pricing strategies for event promotion

Technical Limitations

Important Considerations:

• Rate Limiting: The extractor is subject to platform-imposed rate limits of 100 requests per minute per IP address. Exceeding this threshold will result in temporary throttling with exponential backoff.
• Data Freshness: The cache_status field indicates data age. Records marked as ""stale"" may be up to 24 hours old. For real-time requirements, implement cache bypass strategies.
• Pagination Constraints: Maximum results_per_page is capped at 100. Queries returning more than 10,000 total results may experience incomplete pagination due to API depth limits.
• Geographic Precision: Location coordinates are accurate to approximately 100-meter radius. City-level aggregation is recommended for statistical analysis.
• Verification Lag: The is_verified flag reflects verification status at extraction time. Newly created events may require 48-72 hours for verification processing.
• Metric Availability: Historical metrics (click_through_rate, conversion_rate) are only available for search terms with sufficient historical query volume (minimum 1,000 prior searches).

---

Keywords & Tags: This web scraping tool functions as an event data scraper enabling users to export event listings at scale. The event listings extractor leverages a search events api architecture optimized for lead generation from events workflows. Organizations can scrape event data efficiently using this conference listings scraper for competitive intelligence and market research applications."