A Local Event Score oferece uma API que permite a outra empresa integrar nossa inteligência de eventos diretamente em sua própria plataforma—para que seus usuários possam ver eventos locais futuros + impacto previsto no tráfego sem sair do seu painel.
Em vez de construir descoberta de eventos, categorização, pontuação e filtragem do zero, eles simplesmente chamam nossa API usando um endereço de loja (ou código postal), e retornamos uma lista estruturada de eventos com um Impact Score e metadados de suporte.
Quando um painel envia uma solicitação (ex: “Mostre-me eventos perto desta localização de loja”), a API retorna:
Eventos futuros próximos à localização
Detalhes do evento (nome, data, tipo, descrição)
Impact Score (quão provável é que influencie o tráfego de pessoas)
Raciocínio do impacto (por que foi pontuado dessa forma)
Filtragem opcional por:
persona (individual, família, viajante, etc.)
interesses (música, comida, esportes, etc.)
faixa de datas
modo eventos vs lugares
idioma (inglês / espanhol)
pontuação de impacto em modo negócios (focado no varejo)
Uma vez integrado, um parceiro pode exibir a Local Event Score dentro de sua própria interface, como:
1) Widget de "Impacto de Evento" da Localização
Um cartão mostrando os 5 principais eventos deste mês que poderiam mover o tráfego, com distintivos de pontuação (Alto/Médio/Baixo).
2) Experiência de calendário + exportação
Eventos populam uma visualização de calendário e podem ser exportados, salvos ou adicionados a um planejador de viagem.
3) Alertas de pessoal & marketing
“Evento de alto impacto neste sábado → ajuste de pessoal / execute anúncios / estenda horários.”
4) Camada de contexto de desempenho
Quando o tráfego aumenta ou diminui, os usuários podem ver por que (eventos locais, interrupções, etc.)—reduzindo a suposição.
A API transforma um endereço em um contexto de tráfego de pessoas impulsionado por eventos—para que qualquer painel possa mostrar o que está por vir, o que isso significa e como se preparar.
O ponto de Pontuação de Evento Local analisa eventos locais futuros próximos a um endereço de negócio especificado e atribui a cada evento uma Pontuação de Impacto — um indicador preditivo de quão provável é que esse evento influencie o tráfego de clientes naquele local
Transforma listagens de eventos brutos em inteligência comercial acionável
{
"endereço": "10001",
"ação": "eventos",
"persona": "viajante",
"interesses": ["música", "comida"],
"idioma": "pt",
"data_inicial": "",
"data_final": "",
"tipo_de_negócio": ""
}
Evento Local - Recursos do endpoint
| Objeto | Descrição |
|---|---|
address |
[Obrigatório] 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'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
A API de Pontuação de Eventos retorna uma lista de eventos futuros próximos a uma localização especificada incluindo detalhes do evento como nome data tipo descrição uma Pontuação de Impacto indicando sua influência potencial no tráfego de pedestres e o raciocínio por trás dessa pontuação
Os campos chave nos dados de resposta incluem "eventos" (um array de objetos de evento), cada um contendo "nome," "data," "tipo," "descrição," "impacto," e "razão do impacto," fornecendo insights abrangentes sobre a relevância de cada evento
Os usuários podem personalizar suas solicitações especificando parâmetros como "persona" (por exemplo, individual, família), "interesses" (por exemplo, música, comida), "intervalo de datas," "modo eventos vs lugares," "idioma" (inglês/espanhol) e "tipo_de_negócio" para pontuação focada no varejo
Os dados de resposta estão organizados em um formato JSON com um array "events" contendo objetos de eventos individuais Cada objeto inclui campos estruturados para fácil acesso a detalhes do evento pontuações de impacto e raciocínio
Os dados são obtidos de diversas listas de eventos locais calendários comunitários e associações com organizadores de eventos o que garante uma ampla gama de eventos que refletem os interesses e atividades locais
Casos de uso típicos incluem aprimorar estratégias de varejo identificando eventos de alto impacto para ajustes de pessoal campanhas de marketing e compreensão dos padrões de tráfego local em relação a eventos comunitários
Os usuários podem utilizar os dados retornados integrando-os em seus painéis para visualizar eventos futuros avaliar seu impacto potencial no fluxo de pessoas e tomar decisões informadas sobre pessoal e esforços de marketing
A precisão dos dados é mantida por meio de atualizações regulares validação contra múltiplas fontes e verificações de qualidade para garantir que os detalhes do evento sejam atuais e relevantes proporcionando informações confiáveis para os usuários
Nível de serviço:
100%
Tempo de resposta:
469ms
Nível de serviço:
100%
Tempo de resposta:
12.216ms
Nível de serviço:
100%
Tempo de resposta:
4.362ms
Nível de serviço:
100%
Tempo de resposta:
16ms
Nível de serviço:
100%
Tempo de resposta:
7.208ms
Nível de serviço:
100%
Tempo de resposta:
8.825ms
Nível de serviço:
100%
Tempo de resposta:
1.256ms
Nível de serviço:
100%
Tempo de resposta:
2.617ms
Nível de serviço:
100%
Tempo de resposta:
327ms
Nível de serviço:
100%
Tempo de resposta:
878ms
Nível de serviço:
100%
Tempo de resposta:
1.094ms
Nível de serviço:
100%
Tempo de resposta:
1.710ms
Nível de serviço:
100%
Tempo de resposta:
95ms
Nível de serviço:
100%
Tempo de resposta:
528ms
Nível de serviço:
100%
Tempo de resposta:
294ms
Nível de serviço:
100%
Tempo de resposta:
1.318ms
Nível de serviço:
100%
Tempo de resposta:
1.072ms
Nível de serviço:
100%
Tempo de resposta:
421ms
Nível de serviço:
100%
Tempo de resposta:
490ms
Nível de serviço:
100%
Tempo de resposta:
19ms