{"events":[{"name":"Valentine's Day Eve - Couples' Cooking Class","date":"2026-02-11","type":"Cooking Class","description":"Learn to prepare a romantic three-course meal with your significant other, just in time for Valentine's Day. Includes a complimentary glass of wine per person.","impact":"medium","impactReason":"Couples are often in a gifting mood around Valentine's Day. While not directly jewelry-focused, the romantic atmosphere could inspire a visit to a jeweler for a 'dessert' gift."},{"name":"Art & Wine Wednesdays: 'Love in Bloom' Painting Workshop","date":"2026-02-11","type":"Art Workshop","description":"Unleash your inner artist with a guided painting session focusing on floral and romantic themes. Enjoy wine and light refreshments while you create your masterpiece.","impact":"low","impactReason":"Creative and romantic themes might subtly elevate a desire for beautiful objects, but it's not a direct driver for jewelry purchases. Participants are focused on their art."},{"name":"Local Farmers Market - Valentine's Day Edition","date":"2026-02-11","type":"Market","description":"Discover fresh produce, artisanal goods, handmade crafts, and special Valentine's Day treats from local vendors. Live acoustic music adds to the festive atmosphere.","impact":"low","impactReason":"While there will be gift-giving opportunities, the focus is on smaller, handcrafted items and food. Unlikely to directly lead to significant jewelry sales."},{"name":"Pre-Valentine's Day 'Pamper Yourself' Spa & Wellness Fair","date":"2026-02-11","type":"Wellness Event","description":"Indulge in mini-massages, sample organic skincare products, and learn about local wellness services. A perfect way to de-stress before the holiday.","impact":"medium","impactReason":"Often, self-care and pampering can lead to a desire for personal adornment. If attendees are treating themselves, a piece of jewelry could be a complementary splurge."},{"name":"Charity Gala: 'Hearts for Hope' Fundraiser","date":"2026-02-11","type":"Gala/Fundraiser","description":"An elegant evening of dinner, dancing, and a silent auction to benefit a local children's charity. Black-tie optional.","impact":"high","impactReason":"Attendees for a gala are often dressed up and likely anticipating a special occasion. Many will be looking for complementary accessories, making it a prime opportunity for jewelers. Silent auction donations could also spread brand awareness."},{"name":"The Woodlands Symphony Orchestra: 'Love Songs' Concert","date":"2026-02-11","type":"Concert","description":"Enjoy a special Valentine's program featuring classic and contemporary love songs performed by The Woodlands Symphony Orchestra. Perfect for a romantic evening out.","impact":"high","impactReason":"A romantic concert setting encourages couples to celebrate and often involves dressing up. Attendees might be considering a special gift for their partner, making it an excellent time to showcase jewelry."},{"name":"Local Business Showcase: 'Boutique Finds & Sweethearts' Delights'","date":"2026-02-11","type":"Retail Showcase","description":"Explore unique gifts and services from local small businesses, with a focus on Valentine's Day. Includes demonstrations and special offers.","impact":"high","impactReason":"This event is specifically designed for local businesses to showcase their offerings for Valentine's Day. A jeweler would be a perfect fit and could directly engage with customers actively seeking gifts."}],"meta":{"address":"77380","usage":{"used":4,"limit":100},"generated_at":"2026-02-12T02:05:58.551Z"}}
curl --location --request POST 'https://zylalabs.com/api/11878/event+score+api/22581/local+event+api?address=1600 Pennsylvania Avenue NW' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Event Score API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Local Event Score offers an API that lets another company plug our event intelligence directly into their own platform—so their users can see upcoming local events + predicted traffic impact without leaving their dashboard.
Instead of building event discovery, categorization, scoring, and filtering from scratch, they simply call our API using a store address (or zip code), and we return a structured list of events with an Impact Score and supporting metadata.
When a dashboard sends a request (ex: “Show me events near this store location”), the API returns:
Upcoming events near the location
Event details (name, date, type, description)
Impact Score (how likely it is to influence foot traffic)
Impact reasoning (why it’s scored that way)
Optional filtering by:
persona (individual, family, traveler, etc.)
interests (music, food, sports, etc.)
date range
events vs places mode
language (English / Spanish)
business mode impact scoring (retail-focused)
Once integrated, a partner can display Local Event Score inside their own UI, like:
1) Location “Event Impact” widget
A card showing the top 5 events this month that could move traffic, with score badges (High/Med/Low).
2) Calendar + export experience
Events populate a calendar view and can be exported, saved, or added to a trip planner.
3) Staffing & marketing alerts
“High-impact event this Saturday → adjust staffing / run ads / extend hours.”
4) Performance context layer
When traffic spikes or drops, users can see why (local events, disruptions, etc.)—reducing guesswork.
The API turns an address into event-driven foot-traffic context—so any dashboard can show what’s coming, what it means, and how to prepare.
The Event Score API returns a list of upcoming events near a specified location, including event details such as name, date, type, description, an Impact Score indicating its potential influence on foot traffic, and reasoning behind that score.
The key fields in the response data include "events" (an array of event objects), each containing "name," "date," "type," "description," "impact," and "impactReason," providing comprehensive insights into each event's relevance.
Users can customize their requests by specifying parameters such as "persona" (e.g., individual, family), "interests" (e.g., music, food), "date range," "events vs places mode," "language" (English/Spanish), and "business_type" for retail-focused scoring.
The response data is organized in a JSON format, with an "events" array containing individual event objects. Each object includes structured fields for easy access to event details, impact scores, and reasoning.
The data is sourced from various local event listings, community calendars, and partnerships with event organizers, ensuring a diverse range of events that reflect local interests and activities.
Typical use cases include enhancing retail strategies by identifying high-impact events for staffing adjustments, marketing campaigns, and understanding local traffic patterns in relation to community events.
Users can utilize the returned data by integrating it into their dashboards to visualize upcoming events, assess their potential impact on foot traffic, and make informed decisions regarding staffing and marketing efforts.
Data accuracy is maintained through regular updates, validation against multiple sources, and quality checks to ensure that event details are current and relevant, providing reliable insights for users.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund