{"id":61,"date":"2026-09-24T14:53:04","date_gmt":"2026-09-24T17:53:06","guid":{"rendered":"https:\/\/ferdy.com.br\/blog\/chave-api-web-of-science\/"},"modified":"2026-09-24T14:53:13","modified_gmt":"2026-09-24T17:53:13","slug":"chave-api-web-of-science","status":"publish","type":"post","link":"https:\/\/ferdy.com.br\/blog\/chave-api-web-of-science\/","title":{"rendered":"Como obter a chave gratuita da API do Web of Science (passo a passo)"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Quem \u00e9 de uma universidade que assina o Web of Science tem direito a uma <strong>chave gratuita da API<\/strong> \u2014 e quase ningu\u00e9m sabe. Com ela, o Web of Science entra na busca do ferdy junto com as bases abertas, trazendo as cita\u00e7\u00f5es de cada artigo e um conjunto de refer\u00eancias que as bases abertas simplesmente n\u00e3o t\u00eam.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Este guia \u00e9 o caminho completo, escrito depois de percorr\u00ea-lo com uma curadora da UFPR em setembro de 2026 \u2014 inclusive as partes que deram errado. Leva cerca de 15 minutos no portal da Clarivate, mais o tempo de aprova\u00e7\u00e3o.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Antes de come\u00e7ar: voc\u00ea tem direito?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A chave gratuita \u00e9 para <strong>membros de institui\u00e7\u00f5es que assinam o Web of Science<\/strong> \u2014 no Brasil, normalmente via Portal CAPES. Para confirmar: acesse <em>webofscience.com<\/em> pela rede da sua universidade ou com a sess\u00e3o CAFe ativa. Se a busca completa abre sem pedir pagamento, a sua institui\u00e7\u00e3o assina.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O que voc\u00ea vai obter \u00e9 a chave da <strong>Web of Science Starter API<\/strong>, no plano <strong>Free Institutional Member<\/strong>. A cota que medimos na pr\u00e1tica com uma chave real: <strong>5.000 requisi\u00e7\u00f5es por dia<\/strong> e 5 por segundo \u2014 muito al\u00e9m do que uma revis\u00e3o consome, j\u00e1 que cada p\u00e1gina de busca no ferdy gasta uma requisi\u00e7\u00e3o.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 1 \u00b7 Criar a conta no portal de desenvolvedores<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Acesse <strong>developer.clarivate.com<\/strong> e entre em <em>Sign in<\/em> (ou registre-se).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Use o seu e-mail institucional<\/strong> \u2014 e, se poss\u00edvel, fa\u00e7a isso conectado \u00e0 rede da universidade ou com a sess\u00e3o do CAFe ativa. \u00c9 esse v\u00ednculo que faz a Clarivate reconhecer voc\u00ea como membro da institui\u00e7\u00e3o assinante. Conta criada com Gmail, de casa, sem sess\u00e3o institucional, costuma acabar s\u00f3 com o plano de teste.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 2 \u00b7 Registrar uma aplica\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">No menu, v\u00e1 em <strong>Applications \u2192 Register an application<\/strong>. O portal usa o vocabul\u00e1rio de quem desenvolve software, mas voc\u00ea s\u00f3 precisa preencher quatro campos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Application ID<\/strong> \u2014 um identificador sem espa\u00e7os, por exemplo <code>ferdy-busca<\/code>.<\/li>\n<li><strong>Name<\/strong> \u2014 um nome leg\u00edvel, por exemplo <code>ferdy<\/code>.<\/li>\n<li><strong>Description<\/strong> \u2014 descreva o uso real, sem inventar: <em>&#8220;busca bibliogr\u00e1fica para revis\u00f5es sistem\u00e1ticas por meio da ferramenta ferdy; chave pessoal, guardada cifrada no servidor; membro da institui\u00e7\u00e3o assinante [sua universidade], via Portal CAPES&#8221;<\/em>. Essa descri\u00e7\u00e3o \u00e9 lida na aprova\u00e7\u00e3o.<\/li>\n<li><strong>Client Type<\/strong> \u2014 escolha <strong>Confidential (server side)<\/strong>. N\u00e3o \u00e9 preciso configurar OAuth nem URLs de redirecionamento.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 3 \u00b7 Assinar a Web of Science Starter API<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">V\u00e1 em <strong>APIs \u2192 Web of Science Starter API \u2192 Subscribe<\/strong> (em algumas telas, <em>Add to application<\/em>) e escolha a aplica\u00e7\u00e3o que voc\u00ea acabou de criar. Aqui aparecem os planos gratuitos, e a escolha importa:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Free Institutional Member<\/strong> \u2014 \u00e9 o que voc\u00ea quer. Destinado a qualquer membro da institui\u00e7\u00e3o assinante, uma chave por pessoa.<\/li>\n<li><strong>Free Trial<\/strong> \u2014 50 requisi\u00e7\u00f5es por dia, restrito a estudantes e acad\u00eamicos com e-mail institucional, uso pessoal e sem dados de cita\u00e7\u00e3o. Serve para experimentar enquanto o institucional n\u00e3o sai.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Se o plano institucional <em>n\u00e3o<\/em> aparecer, \u00e9 sinal de que a sua conta ainda n\u00e3o est\u00e1 reconhecida como da institui\u00e7\u00e3o \u2014 v\u00e1 direto ao \u00faltimo bloco deste guia.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 4 \u00b7 Esperar a aprova\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A assinatura fica com o status <strong>&#8220;Subscription approval is pending&#8221;<\/strong>. A Clarivate revisa e envia um e-mail quando libera \u2014 no nosso caso veio de <code>AGEntitlements@Clarivate.com<\/code>, com n\u00famero de chamado e o aviso de que a libera\u00e7\u00e3o pode levar <strong>at\u00e9 seis horas para entrar em vigor<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na pr\u00e1tica, o e-mail chegou \u00e0s 9h38 e a chave j\u00e1 respondia \u00e0s 10h24. Mas o intervalo entre &#8220;aprovado&#8221; e &#8220;funcionando&#8221; existe de verdade, e \u00e9 a origem do erro mais confuso deste processo \u2014 veja o Passo 6.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 5 \u00b7 Copiar a chave certa<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Volte em <strong>Applications \u2192 sua aplica\u00e7\u00e3o<\/strong>. Na linha da assinatura da Starter API h\u00e1 a coluna <strong>API Key<\/strong> com um bot\u00e3o <strong>Reveal<\/strong>. A chave tem 40 caracteres, s\u00f3 letras e n\u00fameros.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cuidado com a confus\u00e3o mais comum:<\/strong> a aplica\u00e7\u00e3o tamb\u00e9m exibe <em>Client ID<\/em> e <em>Client Secret<\/em>. N\u00e3o s\u00e3o a chave da API. Se voc\u00ea colar o Client ID, o resultado ser\u00e1 um erro de autoriza\u00e7\u00e3o que parece problema de aprova\u00e7\u00e3o \u2014 e n\u00e3o \u00e9.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Passo 6 \u00b7 Colar no ferdy e testar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">No ferdy: <strong>Minha conta \u2192 Integra\u00e7\u00f5es \u2192 Web of Science<\/strong>. Cole a chave e salve. O ferdy faz uma consulta de teste <em>antes<\/em> de guardar e mostra o plano e a cota di\u00e1ria que a Clarivate devolveu. Se o teste falhar, a chave n\u00e3o \u00e9 salva.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As mensagens de erro e o que cada uma significa, traduzidas das respostas reais da API:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>O que aparece<\/th><th>O que aconteceu<\/th><th>O que fazer<\/th><\/tr><\/thead><tbody>\n<tr><td>A credencial foi recusada<\/td><td>A chave existe e passou pelo port\u00e3o de entrada, mas o acesso ao Web of Science ainda n\u00e3o est\u00e1 ativo<\/td><td>Se a aprova\u00e7\u00e3o saiu h\u00e1 menos de seis horas, espere. Se j\u00e1 passou, a conta provavelmente n\u00e3o est\u00e1 vinculada \u00e0 assinatura da institui\u00e7\u00e3o<\/td><\/tr>\n<tr><td>Esta chave n\u00e3o tem acesso \u00e0 Starter API<\/td><td>A chave \u00e9 v\u00e1lida, mas assina outro produto da Clarivate<\/td><td>Volte em APIs e assine a <em>Web of Science Starter API<\/em> com essa aplica\u00e7\u00e3o<\/td><\/tr>\n<tr><td>Chave n\u00e3o reconhecida<\/td><td>Caractere a mais, espa\u00e7o no come\u00e7o ou fim, ou o Client ID no lugar da API Key<\/td><td>Revele a chave de novo e copie pelo bot\u00e3o do portal<\/td><\/tr>\n<tr><td>Limite de consultas atingido<\/td><td>A cota di\u00e1ria acabou<\/td><td>Volta sozinha no dia seguinte; as bases abertas continuam funcionando normalmente<\/td><\/tr>\n<\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">O que muda depois de ativar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O Web of Science passa a aparecer na mesma busca, junto com as sete bases abertas, e os resultados repetidos s\u00e3o unificados por DOI \u2014 voc\u00ea v\u00ea &#8220;encontrado em N bases&#8221;. Cada registro traz as cita\u00e7\u00f5es, que as bases abertas nem sempre t\u00eam.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Quanto isso acrescenta, medido aqui: numa busca real, <strong>83% dos DOIs recentes trazidos pelo Web of Science n\u00e3o apareciam<\/strong> na busca federada das bases abertas para o mesmo recorte. \u00c9 cobertura nova de verdade, principalmente em peri\u00f3dicos de editora comercial.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Um limite importante, para n\u00e3o gerar expectativa errada: <strong>a API do Web of Science n\u00e3o entrega o PDF<\/strong> nem o resumo. Ela devolve a ficha do artigo. Os que forem de editora paga aparecem no ferdy como &#8220;PDF n\u00e3o obtido&#8221; \u2014 sem consumir cr\u00e9dito \u2014 para voc\u00ea baixar pelo acesso da sua universidade e enviar o arquivo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">A chave \u00e9 sua, e s\u00f3 sua<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A licen\u00e7a da Clarivate \u00e9 pessoal: uma chave por membro da institui\u00e7\u00e3o. No ferdy ela fica <strong>cifrada<\/strong>, vinculada \u00e0 sua conta, nunca \u00e9 exibida de novo depois de salva e n\u00e3o aparece em relat\u00f3rio nenhum. Os resultados que ela traz tamb\u00e9m n\u00e3o s\u00e3o compartilhados: o cache do Web of Science \u00e9 separado por usu\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Isso vale inclusive dentro de uma equipe: <strong>um curador n\u00e3o empresta a chave para os orientandos<\/strong>. Cada pesquisador gera a sua, com a pr\u00f3pria conta institucional. Quem n\u00e3o \u00e9 de institui\u00e7\u00e3o assinante continua com as sete bases abertas, que n\u00e3o exigem configura\u00e7\u00e3o nenhuma.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Voc\u00ea pode trocar ou remover a chave quando quiser, em Minha conta \u2192 Integra\u00e7\u00f5es.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Se o plano institucional n\u00e3o aparecer<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u00c9 o obst\u00e1culo mais comum, e quase sempre significa que a conta do portal n\u00e3o foi associada \u00e0 assinatura da universidade. Tr\u00eas caminhos, na ordem:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Refa\u00e7a o acesso com v\u00ednculo institucional<\/strong>: entre no portal a partir da rede da universidade ou com a sess\u00e3o CAFe ativa, usando o e-mail institucional.<\/li>\n<li><strong>Abra um chamado<\/strong> em <em>Contact<\/em> ou <em>Support<\/em> no pr\u00f3prio portal, informando o e-mail institucional e pedindo a vincula\u00e7\u00e3o da conta \u00e0 assinatura da sua institui\u00e7\u00e3o (mencione o Portal CAPES, se for o caso).<\/li>\n<li><strong>Procure a biblioteca<\/strong> da universidade e pergunte quem administra o Web of Science na institui\u00e7\u00e3o \u2014 \u00e9 essa pessoa que resolve a &#8220;institutional integration&#8221; do lado de l\u00e1.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Enquanto isso, o plano <em>Free Trial<\/em> (50 requisi\u00e7\u00f5es por dia) j\u00e1 permite experimentar a integra\u00e7\u00e3o no ferdy sem esperar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Guia relacionado: <a href=\"https:\/\/ferdy.com.br\/blog\/ferramentas-revisao-sistematica-2026\/\">as ferramentas de revis\u00e3o sistem\u00e1tica em 2026<\/a> e <a href=\"https:\/\/ferdy.com.br\/curadores\">o guia do curador<\/a>.<\/em><\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>Quem \u00e9 de institui\u00e7\u00e3o que assina o Web of Science tem direito a uma chave gratuita da API. O caminho completo no portal da Clarivate, com os erros que aparecem e o que cada um significa.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-61","post","type-post","status-publish","format-standard","hentry","category-bases-de-dados"],"_links":{"self":[{"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/posts\/61","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/comments?post=61"}],"version-history":[{"count":1,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/posts\/61\/revisions"}],"predecessor-version":[{"id":62,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/posts\/61\/revisions\/62"}],"wp:attachment":[{"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/media?parent=61"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/categories?post=61"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ferdy.com.br\/blog\/wp-json\/wp\/v2\/tags?post=61"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}