Visão geral da Listings API
Saiba como ativar e gerenciar sua conta ListingsAPI. Os guias acompanham você passo a passo no início da integração, enquanto os guias dos endpoints cobrem cada endpoint de um recurso. É novo por aqui? Comece com sua primeira chamada à API.
Comece aqui
Faça sua primeira chamada à API
Autentique-se, liste seus locais, entenda a estrutura da resposta, percorra as páginas de resultados e saiba como os IDs funcionam.
Ler o guiaEscolha como integrar
Compare a API REST, os SDKs Python e Node, o servidor MCP e os webhooks com base na arquitetura e nos requisitos de integração da sua aplicação.
Ler o guiaLocais
Consulte países, estados e categorias
Consulte países e códigos de estado aceitos, o ID numérico da categoria de negócio e as plataformas de publicação do seu plano antes de criar um local.
Ler o guiaAdicionar um local
Crie um local com os campos necessários para as plataformas de publicação, trate erros de validação e confirme que ele foi colocado na fila para envio.
Ler o guiaAtualize os detalhes e horários de um local
Altere contatos, publique horários semanais completos com exceções, marque fechamento temporário, defina categorias do Google e confira as alterações.
Ler o guiaEnvie um logotipo, uma capa e fotos
Anexe logotipo, capa e fotos da galeria a um local por URL, liste os anexos, marque a imagem principal com estrela e remova itens desatualizados.
Ler o guiaEncontre locais e arquive aqueles que você não gerencia mais
Pesquise por palavra-chave, consulte códigos de loja e IDs em lote e agende ou cancele o arquivamento de filiais fechadas no fim do ciclo de cobrança.
Ler o guiaConectar plataformas
Conecte o Google Business Profile e importe seus locais
Crie um link de conexão do Google, associe as listagens do Google do proprietário aos seus locais, confirme e importe as que ainda não têm local.
Ler o guiaConectar Páginas do Facebook
Crie um link de conexão do Facebook, associe Páginas do proprietário aos seus locais, confirme ou escolha vínculos e desconecte a conta se o cliente sair.
Ler o guiaConecte o Apple Business Connect
Publique no Apple Maps via conta verificada do dono no Apple Business ou ListingsAPI, se não tiver uma. Confira a listagem e desconecte se o cliente sair.
Ler o guiaCrie um Google Business Profile para um local sem perfil
Envie um novo Google Business Profile para um local em uma conta Google conectada e acompanhe a verificação pelo local, suas listagens e webhooks.
Ler o guiaListagens
Verifique o status das listagens e obtenha links ativos
Por local, veja sincronização por plataforma de publicação, URLs de listagens ativas, cobertura e assistentes de voz. Receba webhooks sem consultas.
Ler o guiaEncontre e corrija erros de listagem
Filtre listagens do local que exigem atenção, veja o motivo da plataforma de publicação, corrija, consulte de novo com segurança e verifique toda a conta.
Ler o guiaEncontre e suprima listagens duplicadas
Liste listagens duplicadas por local e na conta, confirme as reais para supressão, descarte falsos positivos e acompanhe cada uma até a resolução.
Ler o guiaAvaliações
Busque avaliações de um local ou de toda a sua conta
Liste avaliações mais recentes de um local, filtre notas baixas sem resposta, pagine com cursores, consulte toda a conta e receba avisos por webhook.
Ler o guiaResponda a avaliações e depois edite ou arquive uma resposta
Encontre avaliações que aceitam resposta do proprietário, responda, confirme o recebimento na plataforma de publicação e edite ou arquive a resposta.
Ler o guiaMeça o desempenho das avaliações
Veja KPIs de avaliações de um local, trace a evolução diária, compare fontes, extraia frases comuns e receba resumos diários e semanais por webhook.
Ler o guiaPublicações
Análises
Automação
Agentes de IA
Guias dos endpoints
Locais
Endpoints de locais com cURL, Python e Node, em ordem de uso: listar, buscar, consultar por ID/código da loja, criar, atualizar, arquivar e fotos.
Ler o guiaListagens
Endpoints de listagens: cURL, Python e Node; status de sincronização premium, assistentes de voz, detecção por local/conta e supressão de duplicatas.
Ler o guiaContas conectadas
Todos os endpoints: exemplos cURL, Python e Node; conectar Google/Facebook, listar contas, associar e vincular listagens, pastas, criar GMB e desconectar.
Ler o guiaAvaliações
Cada endpoint de avaliações com cURL, Python e Node: fontes, configurações, lista, consolidação, detalhes, responder, editar, arquivar, frases e análises.
Ler o guiaPublicações
Endpoints de publicações com cURL, Python e Node: anúncios, eventos, ofertas, agendamento, campanhas por local e em massa, consulta de status e exclusão.
Ler o guiaSocial
Todos os endpoints do Social: marcas, links de conexão hospedados, publicação individual e em lote, agendamento, métricas e limite geral de conexões.
Ler o guiaAnálises
Todos os endpoints de análise de perfil com exemplos cURL, Python e Node: métricas diárias do Google/Facebook e visualizações semanais do Bing por local.
Ler o guiaAPIs de apoio
APIs de suporte: todos os endpoints com exemplos cURL, Python e Node, países e estados compatíveis, subcategorias e plataformas de publicação do seu plano.
Ler o guia