Local Event Score ofrece una API que permite a otra empresa conectar nuestra inteligencia de eventos directamente en su propia plataforma—para que sus usuarios puedan ver eventos locales próximos + impacto de tráfico predicho sin salir de su panel.
En lugar de construir un sistema de descubrimiento de eventos, categorización, puntuación y filtrado desde cero, simplemente llaman a nuestra API usando una dirección de tienda (o código postal), y nosotros devolvemos una lista estructurada de eventos con un Impact Score y metadatos de apoyo.
Cuando un panel envía una solicitud (ej: “Muéstrame eventos cerca de esta ubicación de tienda”), la API devuelve:
Eventos próximos cerca de la ubicación
Detalles del evento (nombre, fecha, tipo, descripción)
Impact Score (qué tan probable es que influya en el tráfico peatonal)
Razonamiento del impacto (por qué se puntuó así)
Filtrado opcional por:
persona (individual, familia, viajero, etc.)
intereses (música, comida, deportes, etc.)
rango de fechas
modo eventos vs lugares
idioma (inglés / español)
puntuación de impacto de modo empresarial (enfocado en retail)
Una vez integrada, un socio puede mostrar Local Event Score dentro de su propia interfaz, como:
1) Widget de “Impacto del Evento” de ubicación
Una tarjeta que muestra los 5 principales eventos de este mes que podrían mover tráfico, con etiquetas de puntuación (Alto/Medio/Bajo).
2) Experiencia de calendario + exportación
Los eventos llenan una vista de calendario y pueden ser exportados, guardados o añadidos a un planificador de viajes.
3) Alertas de personal y marketing
“Evento de alto impacto este sábado → ajustar personal / correr anuncios / extender horas.”
4) Capa de contexto de rendimiento
Cuando el tráfico aumenta o disminuye, los usuarios pueden ver por qué (eventos locales, interrupciones, etc.)—reduciendo la especulación.
La API convierte una dirección en un contexto de tráfico peatonal impulsado por eventos—para que cualquier panel pueda mostrar qué está por venir, qué significa y cómo prepararse.
El punto de Puntaje de Evento Local analiza eventos locales próximos a una dirección comercial específica y asigna a cada evento un Puntaje de Impacto – un indicador predictivo de cuán probable es que ese evento influya en el tráfico de clientes en esa ubicación.
Transforma listados de eventos en inteligencia minorista accionable.
{
"dirección": "10001",
"acción": "eventos",
"persona": "viajero",
"intereses": ["música", "comida"],
"idioma": "es",
"fecha_inicio": "",
"fecha_fin": "",
"tipo_negocio": ""
}
Evento Local - Características del Endpoint
| Objeto | Descripción |
|---|---|
address |
[Requerido] Business address or US zip code to analyze |
action |
Opcional "events", "places", or "detect-type" |
persona |
Opcional individual, family, teen, young_adult, traveler |
interests |
Opcional Comma-separated interests (e.g., music,food) |
language |
Opcional Type in en for english |
start_date |
Opcional Description: Start date filter (YYYY-MM-DD) |
end_date |
Opcional Description: End date filter (YYYY-MM-DD) |
business_type |
Opcional Description: Used for business-mode impact scoring. Jeweler, furniture, coffee shop, ect... |
{"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'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
La API de Event Score devuelve una lista de eventos próximos cerca de una ubicación especificada incluyendo detalles del evento como nombre fecha tipo descripción un puntaje de impacto que indica su influencia potencial en el tráfico peatonal y la justificación detrás de ese puntaje
Los campos clave en los datos de respuesta incluyen "eventos" (un arreglo de objetos de evento), cada uno conteniendo "nombre," "fecha," "tipo," "descripción," "impacto," e "impactoRazón," proporcionando información integral sobre la relevancia de cada evento
Los usuarios pueden personalizar sus solicitudes especificando parámetros como "persona" (por ejemplo, individuo, familia), "intereses" (por ejemplo, música, comida), "rango de fechas", "modo de eventos vs lugares", "idioma" (inglés/español) y "tipo_de_negocio" para la puntuación centrada en el comercio minorista
Los datos de respuesta están organizados en un formato JSON con un arreglo de "eventos" que contiene objetos de evento individuales Cada objeto incluye campos estructurados para un fácil acceso a los detalles del evento puntajes de impacto y razonamiento
Los datos se obtienen de diversas listas de eventos locales calendarios comunitarios y asociaciones con organizadores de eventos lo que garantiza una amplia gama de eventos que reflejan los intereses y actividades locales
Los casos de uso típicos incluyen mejorar las estrategias minoristas al identificar eventos de alto impacto para ajustes de personal campañas de marketing y entender los patrones de tráfico local en relación con los eventos comunitarios
Los usuarios pueden utilizar los datos devueltos integrándolos en sus paneles para visualizar eventos futuros evaluar su posible impacto en el tráfico de personas y tomar decisiones informadas sobre la dotación de personal y los esfuerzos de marketing
La precisión de los datos se mantiene a través de actualizaciones regulares validación contra múltiples fuentes y controles de calidad para asegurar que los detalles del evento sean actuales y relevantes proporcionando información confiable para los usuarios
Nivel de Servicio:
100%
Tiempo de Respuesta:
469ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
4.362ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
55ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.256ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.407ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.726ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.617ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
9.440ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.700ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
12.216ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
6.718ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
22ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.259ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
6.570ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.041ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.483ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
525ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
835ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
501ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.413ms