Pontuação do Evento API API ID: 11878

O que a API faz Quando um painel envia uma solicitação (ex: "Mostre-me eventos perto desta localização de loja"), a API retorna: Eventos futuros perto da localização Detalhes do evento (nome, data, tipo, descrição) Pontuação de impacto (quão provável é que influencie o fluxo de pessoas) Justificativa do impacto (por que recebeu essa pontuação) Filtragem opcional por: persona (indivíduo, família, viajante, etc.) interesses (música, comida, esportes, etc.) faixa de data modo eventos vs lugares idioma (inglês / espanhol) pontuação de impacto em modo de negócios (focado no varejo)
Use esta API do seu agente de IA via MCP
Funciona com OpenClaw, Claude Code/Desktop, Cursor, Windsurf, Cline e qualquer cliente de IA compatível com MCP.
Docs e configuração
Crie uma skill envolvendo este MCP: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

Como a API Local Event Score se encaixa no seu painel

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.


O que a API faz

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)


O que isso permite para os parceiros

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.


O que isso significa em uma frase

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.

Documentação da API

Endpoints


🔹 Pontuação de Evento Local – Ponto de Impacto do Evento

Propósito do Ponto

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": ""
}



                                                                            
POST https://pr138-testing.zylalabs.com/api/11878/event+score+api/22581/local+event+api
                                                                            
                                                                        

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...
Testar endpoint

RESPOSTA DE EXEMPLO DA API

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"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"}}
                                                                                                                                                                                                                    
                                                                                                    

Evento Local - TRECHOS DE CÓDIGO


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' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Pontuação do Evento API basta incluir seu token Bearer no cabeçalho Authorization.
Cabeçalhos
Cabeçalho Descrição
Authorization [Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Preços simples e transparentes

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

🚀 Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Recursos favoritos dos clientes

  • ✔︎ Pague apenas por requisições bem-sucedidas
  • ✔︎ Teste 7 dias gratis
  • ✔︎ Suporte multilíngue
  • ✔︎ Uma chave de API, todas as APIs.
  • ✔︎ Painel intuitivo
  • ✔︎ Tratamento de erros abrangente
  • ✔︎ Documentação amigável para desenvolvedores
  • ✔︎ Integração com Postman
  • ✔︎ Conexões HTTPS seguras
  • ✔︎ Alta disponibilidade

Pontuação do Evento API FAQs

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

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas


Você também pode gostar