{"id":37154,"date":"2025-02-07T16:11:38","date_gmt":"2025-02-07T13:11:38","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=37154"},"modified":"2026-01-30T11:52:45","modified_gmt":"2026-01-30T08:52:45","slug":"como-usar-a-api-de-pesquisa-de-dominio","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/br\/como-usar-a-api-de-pesquisa-de-dominio\/","title":{"rendered":"Como usar a API de Pesquisa de Dom\u00ednio"},"content":{"rendered":"<p>Este artigo descreve a <a href=\"https:\/\/snov.io\/br\/api\">API de Pesquisa de Dom\u00ednio da Snov.io<\/a>, o processo geral de uso, as solicita\u00e7\u00f5es dispon\u00edveis, seus par\u00e2metros e respostas.<\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Esta \u00e9 a vers\u00e3o em <a href=\"https:\/\/app.snov.io\/domain-search\">API da ferramenta de Pesquisa de Dom\u00ednio<\/a> no aplicativo da Snov.io. Ela oferece as mesmas op\u00e7\u00f5es de busca por meio de solicita\u00e7\u00f5es \u00e0 API. Com a API, voc\u00ea pode solicitar e obter informa\u00e7\u00f5es sobre empresas e seus contatos (e-mails e perfis de prospects) com base nos dom\u00ednios fornecidos.<\/p>\n<\/div>\n<\/div>\n<p><a href=\"#solicitar-informacoes-empresa-api\">Pesquisa de Dom\u00ednio (solicitar informa\u00e7\u00f5es da empresa)<\/a><br \/>\n<a href=\"#obter-informacoes-empresa-api\">Pesquisa de Dom\u00ednio (obter informa\u00e7\u00f5es da empresa)<\/a><br \/>\n<a href=\"#buscar-prospects-por-dominio\">Buscar prospects por dom\u00ednio<\/a><br \/>\n<a href=\"#obter-prospects-dominio\">Obter prospects de um dom\u00ednio<\/a><br \/>\n<a href=\"#buscar-email-prospect\">Buscar o endere\u00e7o de e-mail de um prospect<\/a><br \/>\n<a href=\"#obter-email-prospect\">Obter endere\u00e7o de e-mail de um prospect<\/a><br \/>\n<a href=\"#buscar-emails-dominio\">Buscar e-mails por dom\u00ednio<\/a><br \/>\n<a href=\"#obter-emails-dominio\">Obter e-mails de dom\u00ednio<\/a><br \/>\n<a href=\"#buscar-contatos-genericos-por-dominio\">Buscar contatos gen\u00e9ricos por dom\u00ednio<\/a><br \/>\n<a href=\"#obter-contatos-genericos-de-um-dominio\">Obter contatos gen\u00e9ricos de um dom\u00ednio<\/a><\/p>\n<p>Vamos revisar os endpoints dispon\u00edveis na API de Pesquisa de Dom\u00ednio, seu prop\u00f3sito no fluxo de trabalho geral e seus principais par\u00e2metros.<\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">Antes de fazer qualquer solicita\u00e7\u00e3o \u00e0 Snov.io, use o <a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\">endpoint de autentica\u00e7\u00e3o<\/a> para obter o access_token. Use-o como um token do tipo bearer para suas pr\u00f3ximas solicita\u00e7\u00f5es. O tempo de vida do access_token \u00e9 de 1 hora (3600 segundos).<\/div>\n<\/div>\n<h2 id=\"solicitar-informacoes-empresa-api\">Pesquisa de Dom\u00ednio (solicitar informa\u00e7\u00f5es da empresa)<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> POST<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/start\/\" target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/start\/<\/a><\/p>\n<p>Este \u00e9 um endpoint base que envia uma solicita\u00e7\u00e3o \u00e0 API da Snov.io para buscar informa\u00e7\u00f5es de uma empresa usando um dom\u00ednio fornecido.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>No campo <strong>\"domain\"<\/strong> desta solicita\u00e7\u00e3o, insira o nome de dom\u00ednio (site da empresa) que deseja pesquisar.<\/p>\n<h4>A resposta cont\u00e9m dois itens principais:<\/h4>\n<ul>\n<li>Um <strong>\"task_hash\"<\/strong> exclusivo que identifica sua solicita\u00e7\u00e3o. Voc\u00ea usar\u00e1 esse identificador na pr\u00f3xima solicita\u00e7\u00e3o para obter os resultados da pesquisa.<\/li>\n<li>Uma <strong>URL direta<\/strong> (no campo <strong>\"result\"<\/strong>) para recuperar os resultados da pesquisa (obter informa\u00e7\u00f5es da empresa).<\/li>\n<\/ul>\n<h2 id=\"obter-informacoes-empresa-api\">Pesquisa de Dom\u00ednio (obter informa\u00e7\u00f5es da empresa)<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> GET<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/result\/{task_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para recuperar os resultados da pesquisa gerados pela solicita\u00e7\u00e3o anterior.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer nenhum par\u00e2metro. Adicione o <strong>\"task_hash\"<\/strong> \u00e0 URL ou use o link direto fornecido na resposta anterior.<\/p>\n<h4>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/h4>\n<ul>\n<li>Detalhes da empresa (localiza\u00e7\u00e3o, site, nome, telefone da matriz, setor, tamanho, etc.).<\/li>\n<li>Contagem de contatos por tipo (prospects, e-mails do dom\u00ednio, contatos gen\u00e9ricos).<\/li>\n<\/ul>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<div class=\"flex max-w-full flex-col flex-grow\">\n<div class=\"min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words text-start [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"d780d57b-ec52-450b-a687-39c6eaa73f5e\" data-message-model-slug=\"gpt-4o\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose w-full break-words dark:prose-invert light\">\n<p>No campo <strong>\"links\"<\/strong> da resposta, voc\u00ea encontrar\u00e1 URLs diretas para pesquisar e filtrar contatos por tipo: <strong>\"prospects\"<\/strong>, <strong>\"domain_emails\"<\/strong>, <strong>\"generic_contacts\"<\/strong>. Use essas URLs em suas solicita\u00e7\u00f5es subsequentes.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<h2 id=\"buscar-prospects-por-dominio\">Buscar prospects por dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> POST<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/prospects\/start?domain=\" target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/start?domain=<\/a><\/p>\n<p>Use este endpoint para enviar uma solicita\u00e7\u00e3o \u00e0 API da Snov.io para pesquisar perfis de prospects no dom\u00ednio fornecido.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<ul>\n<li>No campo <strong>\"domain\"<\/strong> desta solicita\u00e7\u00e3o, insira o nome de dom\u00ednio (site da empresa) que voc\u00ea deseja pesquisar.<\/li>\n<li>Use o par\u00e2metro <strong>\"page\"<\/strong> para especificar qual p\u00e1gina de resultados voc\u00ea deseja pesquisar para prospects.<\/li>\n<\/ul>\n<h4>Pagina\u00e7\u00e3o nos resultados da API:<\/h4>\n<p>Por padr\u00e3o, qualquer solicita\u00e7\u00e3o sem o par\u00e2metro <strong>\"page\"<\/strong> pesquisa automaticamente a primeira p\u00e1gina de resultados. Para pesquisar em outra p\u00e1gina, especifique o n\u00famero da p\u00e1gina nos par\u00e2metros da solicita\u00e7\u00e3o.<\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>No par\u00e2metro <strong>\"positions\"<\/strong>, liste os t\u00edtulos de cargos pelos quais voc\u00ea deseja filtrar, como um array (m\u00e1ximo de 10). Coloque-os entre colchetes, separados por v\u00edrgulas. Por exemplo: <strong>positions[]<\/strong>: [Developer, Product Manager, Software Engineer]<\/p>\n<p>A resposta cont\u00e9m dois itens principais:<\/p>\n<ul>\n<li>Um <strong>\"task_hash\"<\/strong> exclusivo que identifica sua solicita\u00e7\u00e3o. Voc\u00ea usar\u00e1 esse identificador na pr\u00f3xima solicita\u00e7\u00e3o para obter os resultados da pesquisa.<\/li>\n<li>Uma <strong>URL direta<\/strong> para a pr\u00f3xima solicita\u00e7\u00e3o (no campo <strong>\"result\"<\/strong>) para recuperar os resultados da pesquisa.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<h2 id=\"obter-prospects-dominio\">Obter prospects de um dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> GET<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/result\/{task_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para recuperar os resultados da pesquisa de prospects gerados pela solicita\u00e7\u00e3o anterior.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer par\u00e2metros. Adicione o <strong>\"task_hash\"<\/strong> \u00e0 URL ou use o link direto fornecido na resposta anterior.<\/p>\n<h4>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/h4>\n<p>A resposta fornece detalhes sobre os prospects encontrados no dom\u00ednio. Cada prospect cont\u00e9m os seguintes campos:<\/p>\n<ul>\n<li><strong>\"first_name\"<\/strong> (primeiro nome)<\/li>\n<li><strong>\"last_name\"<\/strong> (sobrenome)<\/li>\n<li><strong>\"position\"<\/strong> (cargo)<\/li>\n<li><strong>\"source_page\"<\/strong> (p\u00e1gina de origem)<\/li>\n<li><strong>\"search_emails_start\"<\/strong> (in\u00edcio do e-mail de pesquisa)<\/li>\n<\/ul>\n<h4>Pagina\u00e7\u00e3o nos resultados da API:<\/h4>\n<p>Cada solicita\u00e7\u00e3o retorna resultados para uma p\u00e1gina. Se voc\u00ea n\u00e3o especificar o par\u00e2metro <strong>\"page\"<\/strong> em sua solicita\u00e7\u00e3o anterior, a primeira p\u00e1gina ser\u00e1 retornada por padr\u00e3o.<\/p>\n<p>O campo <strong>\"total_count\"<\/strong> mostra o n\u00famero total de prospects para o dom\u00ednio. Se houver mais p\u00e1ginas dispon\u00edveis, voc\u00ea ver\u00e1 um campo <strong>\"next\"<\/strong> com a URL para recuperar a pr\u00f3xima p\u00e1gina de resultados.<\/p>\n<div class=\"notification-block tip\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/academicons_ideas-repec.svg\" alt=\"tip\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<div class=\"flex max-w-full flex-col flex-grow\">\n<div class=\"min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words text-start [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"7442bccb-4395-41d0-8e86-5594cf2404a7\" data-message-model-slug=\"gpt-4o-mini\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose w-full break-words dark:prose-invert light\">\n<p><strong>Importante: <\/strong>Os endere\u00e7os de e-mail n\u00e3o est\u00e3o inclu\u00eddos na resposta desta solicita\u00e7\u00e3o. Para encontrar o endere\u00e7o de e-mail de um prospect, use a URL fornecida no campo <strong>\"search_emails_start\"<\/strong> para aquele prospect. O link inclui um <strong>\"prospect_hash\"<\/strong> \u00fanico para cada prospect. Cada prospect \u00e9 consultado com uma solicita\u00e7\u00e3o separada.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"flex max-w-full flex-col flex-grow\">\n<div class=\"min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words text-start [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"bdec59ec-dab3-4f05-98d4-45f11bfca220\" data-message-model-slug=\"gpt-4o-mini\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose w-full break-words dark:prose-invert light\">\n<h2 id=\"buscar-email-prospect\">Buscar o endere\u00e7o de e-mail de um prospect<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> POST<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails\/start\/{prospect_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para encontrar o endere\u00e7o de e-mail de um prospect (retornado nos resultados da solicita\u00e7\u00e3o anterior <strong>Obter prospects de um dom\u00ednio<\/strong>).<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer par\u00e2metros adicionais. Um <strong>\"prospect_hash\"<\/strong> \u00fanico (ID do prospect) \u00e9 automaticamente adicionado \u00e0 URL, usando o valor do campo <strong>\"search_emails_start\"<\/strong> na resposta anterior.<\/p>\n<h4>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/h4>\n<ul>\n<li>Um <strong>\"task_hash\"<\/strong> exclusivo que identifica sua solicita\u00e7\u00e3o. Voc\u00ea usar\u00e1 esse identificador na pr\u00f3xima solicita\u00e7\u00e3o para obter os resultados da pesquisa.<\/li>\n<li>Uma <strong>URL direta<\/strong> para a pr\u00f3xima solicita\u00e7\u00e3o (no campo <strong>\"result\"<\/strong>) para verificar o status da pesquisa e recuperar o endere\u00e7o de e-mail do prospect.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"mb-2 flex gap-3 empty:hidden -ml-2\">\n<div class=\"items-center justify-start rounded-xl p-1 flex\"><strong>Dica:<\/strong> Para equipes com necessidades de automa\u00e7\u00e3o ou integra\u00e7\u00e3o com sistemas pr\u00f3prios, a <strong data-start=\"2627\" data-end=\"2708\"><a class=\"decorated-link\" href=\"https:\/\/snov.io\/br\/localizador-de-emails-api\" target=\"_new\" rel=\"noopener\" data-start=\"2629\" data-end=\"2706\">API do Localizador de e-mails<\/a><\/strong> permite coletar dados de leads diretamente em seus fluxos de trabalho e aplica\u00e7\u00f5es.<\/div>\n<\/div>\n<div class=\"flex max-w-full flex-col flex-grow\">\n<div class=\"min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words text-start [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"d47ebdee-9409-40ce-8e97-a0c06462d5d9\" data-message-model-slug=\"gpt-4o-mini\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose w-full break-words dark:prose-invert light\">\n<h2 id=\"obter-email-prospect\">Obter o endere\u00e7o de e-mail de um prospect<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> GET<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails\/result\/{task_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para recuperar o endere\u00e7o de e-mail do prospect encontrado na solicita\u00e7\u00e3o anterior.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer par\u00e2metros adicionais. Um <strong>\"task_hash\"<\/strong> \u00fanico \u00e9 automaticamente adicionado \u00e0 URL, usando o valor da resposta anterior.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Se a pesquisa ainda estiver em andamento, a resposta mostrar\u00e1 \"in_progress\". Assim que a pesquisa estiver \"completada\" e o endere\u00e7o de e-mail for encontrado, ele ser\u00e1 inclu\u00eddo na resposta.<\/p>\n<h4>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/h4>\n<p>A resposta inclui o <strong>endere\u00e7o de e-mail<\/strong> do prospect e seu <strong>status de verifica\u00e7\u00e3o<\/strong>, que pode ser <strong>v\u00e1lido<\/strong> (verde) ou <strong>desconhecido<\/strong> (amarelo). Saiba mais sobre os <a href=\"https:\/\/snov.io\/knowledgebase\/br\/status-de-email\/\">status de e-mail.<\/a><\/p>\n<\/div>\n<\/div>\n<h2 id=\"buscar-emails-dominio\">Buscar e-mails por dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> POST<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/start?domain=\" target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/start?domain=<\/a><\/p>\n<p>Use este endpoint para enviar uma solicita\u00e7\u00e3o \u00e0 API da Snov.io para buscar e-mails de dom\u00ednio no dom\u00ednio fornecido.<\/p>\n<p>Um <strong>e-mail de dom\u00ednio<\/strong> \u00e9 um endere\u00e7o de e-mail n\u00e3o verificado que pertence ao dom\u00ednio de uma empresa. Pode ser o endere\u00e7o de e-mail de um funcion\u00e1rio ou um endere\u00e7o de e-mail gen\u00e9rico.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>No campo <strong>\"domain\"<\/strong> desta solicita\u00e7\u00e3o, insira o nome de dom\u00ednio (site da empresa) que voc\u00ea deseja pesquisar.<\/p>\n<h4>A resposta cont\u00e9m dois itens principais:<\/h4>\n<ul>\n<li>Um <strong>\"task_hash\"<\/strong> exclusivo que identifica sua solicita\u00e7\u00e3o. Voc\u00ea usar\u00e1 esse identificador na pr\u00f3xima solicita\u00e7\u00e3o para obter os resultados da pesquisa.<\/li>\n<li>Uma <strong>URL direta<\/strong> (no campo <strong>\"result\"<\/strong>) para recuperar os resultados da pesquisa.<\/li>\n<\/ul>\n<div class=\"flex max-w-full flex-col flex-grow\">\n<div class=\"min-h-8 text-message flex w-full flex-col items-end gap-2 whitespace-normal break-words text-start [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"e7803f0b-4973-4935-a0d9-39ffa28bcfce\" data-message-model-slug=\"gpt-4o-mini\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose w-full break-words dark:prose-invert light\">\n<h2 id=\"obter-emails-dominio\">Obter e-mails de dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> GET<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/result\/{task_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para recuperar os resultados da pesquisa de e-mails gerados pela solicita\u00e7\u00e3o anterior.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer par\u00e2metros adicionais. Adicione o <strong>\"task_hash\"<\/strong> ao final da URL ou use o link direto fornecido na resposta anterior.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Se a pesquisa ainda estiver em andamento, a resposta mostrar\u00e1 \"in_progress\". Assim que a pesquisa estiver \"completada\", os endere\u00e7os de e-mail ser\u00e3o inclu\u00eddos na resposta.<\/p>\n<h4>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/h4>\n<ul>\n<li>A resposta fornece uma lista de <strong>endere\u00e7os de e-mail<\/strong> encontrados no dom\u00ednio.<\/li>\n<\/ul>\n<h4>Pagina\u00e7\u00e3o nos resultados da API:<\/h4>\n<ul>\n<li>Uma solicita\u00e7\u00e3o fornece at\u00e9 <strong>50 e-mails<\/strong> (uma p\u00e1gina de resultados). A primeira p\u00e1gina \u00e9 retornada por padr\u00e3o.<\/li>\n<li>O campo <strong>\"total_count\"<\/strong> na resposta mostra o n\u00famero total de e-mails dispon\u00edveis.<\/li>\n<li>Se houver mais p\u00e1ginas dispon\u00edveis, voc\u00ea receber\u00e1 a URL para recuperar a pr\u00f3xima p\u00e1gina de resultados no campo <strong>\"next\"<\/strong>.<\/li>\n<li>O campo <strong>\"next\"<\/strong> na resposta fornece a URL que voc\u00ea pode usar para solicitar a pr\u00f3xima p\u00e1gina de resultados.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\"><strong>Nota:<\/strong> O <strong>status de verifica\u00e7\u00e3o de e-mail<\/strong> n\u00e3o est\u00e1 inclu\u00eddo nesta resposta. Para verificar os e-mails de dom\u00ednio, use a <a href=\"https:\/\/snov.io\/br\/api?lang=br\"><strong>API de Verifica\u00e7\u00e3o de E-mail<\/strong>.<\/a> Para coletar listas maiores de prospects mesmo dentro das pol\u00edticas de uso, a <strong data-start=\"1579\" data-end=\"1667\"><a class=\"decorated-link\" href=\"https:\/\/snov.io\/br\/extensao-para-localizar-emails\" target=\"_new\" rel=\"noopener\" data-start=\"1581\" data-end=\"1665\">Extens\u00e3o do localizador de e-mails<\/a><\/strong> pode capturar leads diretamente enquanto voc\u00ea pesquisa perfis no navegador.<\/div>\n<\/div>\n<h2 id=\"buscar-contatos-genericos-por-dominio\">Buscar contatos gen\u00e9ricos por dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> POST<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/start\" target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/start<\/a><\/p>\n<p>Use este endpoint para enviar uma solicita\u00e7\u00e3o \u00e0 API da Snov.io para buscar contatos gen\u00e9ricos no dom\u00ednio fornecido.<\/p>\n<p>Um <strong>contato gen\u00e9rico<\/strong> \u00e9 um endere\u00e7o de e-mail n\u00e3o verificado do dom\u00ednio da empresa, frequentemente utilizado para e-mails t\u00e9cnicos ou de servi\u00e7o, como <strong><a rel=\"noopener\">info@dominio.com<\/a><\/strong>.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>No campo <strong>\"domain\"<\/strong> desta solicita\u00e7\u00e3o, insira o nome de dom\u00ednio (site da empresa) que voc\u00ea deseja pesquisar.<\/p>\n<h4>A resposta cont\u00e9m dois itens principais:<\/h4>\n<ul>\n<li>Um <strong>\"task_hash\"<\/strong> \u00fanico que identifica sua solicita\u00e7\u00e3o. Voc\u00ea usar\u00e1 esse identificador na pr\u00f3xima solicita\u00e7\u00e3o para obter os resultados da pesquisa.<\/li>\n<li>Uma <strong>URL direta<\/strong> (no campo <strong>\"result\"<\/strong>) para recuperar os resultados da pesquisa.<\/li>\n<\/ul>\n<h2 id=\"obter-contatos-genericos-de-um-dominio\">Obter contatos gen\u00e9ricos de um dom\u00ednio<\/h2>\n<p><strong>Tipo de solicita\u00e7\u00e3o:<\/strong> GET<\/p>\n<p><strong>URL da solicita\u00e7\u00e3o:<\/strong> <a target=\"_new\" rel=\"noopener\">https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/result\/{task_hash}<\/a><\/p>\n<p>Use esta solicita\u00e7\u00e3o para recuperar os resultados da pesquisa gerados pela solicita\u00e7\u00e3o anterior.<\/p>\n<h4>Par\u00e2metros de entrada:<\/h4>\n<p>Esta solicita\u00e7\u00e3o n\u00e3o requer par\u00e2metros adicionais. Adicione o <strong>\"task_hash\"<\/strong> ao final da URL ou use o link direto fornecido na resposta anterior.<\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Se a pesquisa ainda estiver em andamento, a resposta mostrar\u00e1 \"in_progress\". Assim que a pesquisa estiver \"completada\", os resultados ser\u00e3o inclu\u00eddos na resposta.<\/p>\n<p><strong>A resposta desta solicita\u00e7\u00e3o cont\u00e9m:<\/strong><\/p>\n<p>A resposta fornece uma lista de contatos de e-mail gen\u00e9ricos encontrados no dom\u00ednio.<\/p>\n<p>Pagina\u00e7\u00e3o nos resultados da API:<br \/>\nUma solicita\u00e7\u00e3o fornece at\u00e9 50 contatos (uma p\u00e1gina de resultados). A primeira p\u00e1gina \u00e9 retornada por padr\u00e3o.<br \/>\nO campo \"total_count\" na resposta mostra o n\u00famero total de contatos dispon\u00edveis. Se houver mais p\u00e1ginas dispon\u00edveis, voc\u00ea receber\u00e1 a URL para recuperar a pr\u00f3xima p\u00e1gina de resultados no campo \"next\".<\/p>\n<\/div>\n<\/div>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\"><strong>Nota:<\/strong> O status de verifica\u00e7\u00e3o de e-mail n\u00e3o est\u00e1 inclu\u00eddo nesta resposta. Para verificar os e-mails de dom\u00ednio, use a <a href=\"https:\/\/snov.io\/br\/api\">API de Verifica\u00e7\u00e3o de E-mail.<\/a><\/div>\n<\/div>\n<h2>Custo de cr\u00e9dito da API de Pesquisa de Dom\u00ednio<\/h2>\n<p>Cada solicita\u00e7\u00e3o do tipo <strong>POST<\/strong> \u00e0 API de <a href=\"https:\/\/app.snov.io\/account\/billing\">Pesquisa de Dom\u00ednio<\/a> ir\u00e1 descontar um cr\u00e9dito da sua cota de conta.<\/p>\n<p>A solicita\u00e7\u00e3o n\u00e3o descontar\u00e1 cr\u00e9ditos nas seguintes situa\u00e7\u00f5es:<\/p>\n<ol>\n<li style=\"font-weight: 400;\" aria-level=\"1\">A solicita\u00e7\u00e3o n\u00e3o fornecer resultados (por exemplo, nenhuma informa\u00e7\u00e3o sobre a empresa, nenhum prospecto ou nenhum e-mail na resposta)<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\">A solicita\u00e7\u00e3o de pesquisa n\u00e3o encontrar nenhum e-mail verificado (verde ou amarelo) para um prospecto.<\/li>\n<\/ol>\n<table style=\"border-color: #a8a8a8;\" border=\"1\">\n<tbody>\n<tr>\n<td><strong>URL da solicita\u00e7\u00e3o<\/strong><\/td>\n<td><strong>Uso de cr\u00e9dito<\/strong><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\"><strong>Pesquisa de Dom\u00ednio (solicite informa\u00e7\u00e3o da companhia): <\/strong>https:\/\/api.snov.io\/v2\/domain-search<\/span><\/td>\n<td>1 cr\u00e9dito para cada solicita\u00e7\u00e3o do tipo <strong>\u201cPOST\u201d.<\/strong><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\"><strong>Pesquise prospects por dom\u00ednio: <\/strong>https:\/\/api.snov.io\/v2\/domain-search\/prospects<\/span><\/td>\n<td>1 cr\u00e9dito para cada solicita\u00e7\u00e3o do tipo \u201cPOST\u201d (at\u00e9 20 perfis de prospectos sem e-mails por solicita\u00e7\u00e3o).<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\"><strong>Pesquise e-mails por dom\u00ednio:\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <\/strong>https:\/\/api.snov.io\/v2\/domain-search\/domain-emails<\/span><\/td>\n<td>1 cr\u00e9dito para cada solicita\u00e7\u00e3o do tipo \u201cPOST\u201d (at\u00e9 50 e-mails de dom\u00ednio n\u00e3o verificados por solicita\u00e7\u00e3o).<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\"><strong>Pesquise contatos gen\u00e9ricos por dom\u00ednio: <\/strong>https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts<\/span><\/td>\n<td>1 cr\u00e9dito para cada solicita\u00e7\u00e3o do tipo \u201cPOST\u201d (at\u00e9 50 contatos gen\u00e9ricos n\u00e3o verificados por solicita\u00e7\u00e3o).<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\"><strong>Pesquise o e-mail do prospect:\u00a0 \u00a0 \u00a0 <\/strong>https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails<\/span><\/td>\n<td>1 cr\u00e9dito para cada prospecto se um e-mail v\u00e1lido (verde) ou desconhecido (amarelo) for encontrado. Se nenhum e-mail verificado for encontrado, nenhum cr\u00e9dito ser\u00e1 cobrado.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Veja as informa\u00e7\u00f5es t\u00e9cnicas completas em nossa documenta\u00e7\u00e3o da <a href=\"https:\/\/snov.io\/br\/api\">API de Pesquisa de Dom\u00ednio.<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Este artigo descreve a API de Pesquisa de Dom\u00ednio da Snov.io, o processo geral de uso, as solicita\u00e7\u00f5es dispon\u00edveis, seus par\u00e2metros e respostas. Esta \u00e9 a vers\u00e3o em API da ferramenta de Pesquisa de Dom\u00ednio no aplicativo da Snov.io. Ela oferece as mesmas op\u00e7\u00f5es de busca por meio de solicita\u00e7\u00f5es \u00e0 API. Com a API, [&hellip;]<\/p>\n","protected":false},"author":31,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2310],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/37154"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/31"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=37154"}],"version-history":[{"count":24,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/37154\/revisions"}],"predecessor-version":[{"id":44649,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/37154\/revisions\/44649"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=37154"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=37154"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=37154"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}