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.
Primeiros passos
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 conforme a arquitetura e os requisitos de integração da sua aplicação.
Ler o guiaAgentes de IA
Locais
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 às plataformas de publicação, trate erros de validação e confirme que ele entrou na fila de envio.
Ler o guiaAtualize os dados e horários de um local
Mude contatos, publique horários semanais com exceções pontuais, marque fechamento temporário, defina área atendida e categorias Google e releia mudanças.
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 para conectar o Google, associe as listagens do proprietário no Google aos seus locais, confirme as associações e importe listagens sem 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 guiaAuditoria de empresas
Avaliaçõ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
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
Cada endpoint de listagens: cURL, Python e Node; status de sincronização premium, assistentes de voz, detecção e supressão de duplicatas e listings scans.
Ler o guiaContas conectadas
Todos os endpoints: exemplos cURL/Python/Node; conectar Google/Facebook, listar contas, associar/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 exemplo em cURL, Python e Node: métricas diárias do Google e Facebook de um local e endpoint obsoleto do Bing.
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