ferdyComo obter a chave gratuita da API do Web of Science (passo a passo)
Quem é de uma universidade que assina o Web of Science tem direito a uma chave gratuita da API — e quase ninguém sabe. Com ela, o Web of Science entra na busca do ferdy junto com as bases abertas, trazendo as citações de cada artigo e um conjunto de referências que as bases abertas simplesmente não têm.
Este guia é o caminho completo, escrito depois de percorrê-lo com uma curadora da UFPR em setembro de 2026 — inclusive as partes que deram errado. Leva cerca de 15 minutos no portal da Clarivate, mais o tempo de aprovação.
Antes de começar: você tem direito?
A chave gratuita é para membros de instituições que assinam o Web of Science — no Brasil, normalmente via Portal CAPES. Para confirmar: acesse webofscience.com pela rede da sua universidade ou com a sessão CAFe ativa. Se a busca completa abre sem pedir pagamento, a sua instituição assina.
O que você vai obter é a chave da Web of Science Starter API, no plano Free Institutional Member. A cota que medimos na prática com uma chave real: 5.000 requisições por dia e 5 por segundo — muito além do que uma revisão consome, já que cada página de busca no ferdy gasta uma requisição.
Passo 1 · Criar a conta no portal de desenvolvedores
Acesse developer.clarivate.com e entre em Sign in (ou registre-se).
Use o seu e-mail institucional — e, se possível, faça isso conectado à rede da universidade ou com a sessão do CAFe ativa. É esse vínculo que faz a Clarivate reconhecer você como membro da instituição assinante. Conta criada com Gmail, de casa, sem sessão institucional, costuma acabar só com o plano de teste.
Passo 2 · Registrar uma aplicação
No menu, vá em Applications → Register an application. O portal usa o vocabulário de quem desenvolve software, mas você só precisa preencher quatro campos:
- Application ID — um identificador sem espaços, por exemplo
ferdy-busca. - Name — um nome legível, por exemplo
ferdy. - Description — descreva o uso real, sem inventar: “busca bibliográfica para revisões sistemáticas por meio da ferramenta ferdy; chave pessoal, guardada cifrada no servidor; membro da instituição assinante [sua universidade], via Portal CAPES”. Essa descrição é lida na aprovação.
- Client Type — escolha Confidential (server side). Não é preciso configurar OAuth nem URLs de redirecionamento.
Passo 3 · Assinar a Web of Science Starter API
Vá em APIs → Web of Science Starter API → Subscribe (em algumas telas, Add to application) e escolha a aplicação que você acabou de criar. Aqui aparecem os planos gratuitos, e a escolha importa:
- Free Institutional Member — é o que você quer. Destinado a qualquer membro da instituição assinante, uma chave por pessoa.
- Free Trial — 50 requisições por dia, restrito a estudantes e acadêmicos com e-mail institucional, uso pessoal e sem dados de citação. Serve para experimentar enquanto o institucional não sai.
Se o plano institucional não aparecer, é sinal de que a sua conta ainda não está reconhecida como da instituição — vá direto ao último bloco deste guia.
Passo 4 · Esperar a aprovação
A assinatura fica com o status “Subscription approval is pending”. A Clarivate revisa e envia um e-mail quando libera — no nosso caso veio de [email protected], com número de chamado e o aviso de que a liberação pode levar até seis horas para entrar em vigor.
Na prática, o e-mail chegou às 9h38 e a chave já respondia às 10h24. Mas o intervalo entre “aprovado” e “funcionando” existe de verdade, e é a origem do erro mais confuso deste processo — veja o Passo 6.
Passo 5 · Copiar a chave certa
Volte em Applications → sua aplicação. Na linha da assinatura da Starter API há a coluna API Key com um botão Reveal. A chave tem 40 caracteres, só letras e números.
Cuidado com a confusão mais comum: a aplicação também exibe Client ID e Client Secret. Não são a chave da API. Se você colar o Client ID, o resultado será um erro de autorização que parece problema de aprovação — e não é.
Passo 6 · Colar no ferdy e testar
No ferdy: Minha conta → Integrações → Web of Science. Cole a chave e salve. O ferdy faz uma consulta de teste antes de guardar e mostra o plano e a cota diária que a Clarivate devolveu. Se o teste falhar, a chave não é salva.
As mensagens de erro e o que cada uma significa, traduzidas das respostas reais da API:
| O que aparece | O que aconteceu | O que fazer |
|---|---|---|
| A credencial foi recusada | A chave existe e passou pelo portão de entrada, mas o acesso ao Web of Science ainda não está ativo | Se a aprovação saiu há menos de seis horas, espere. Se já passou, a conta provavelmente não está vinculada à assinatura da instituição |
| Esta chave não tem acesso à Starter API | A chave é válida, mas assina outro produto da Clarivate | Volte em APIs e assine a Web of Science Starter API com essa aplicação |
| Chave não reconhecida | Caractere a mais, espaço no começo ou fim, ou o Client ID no lugar da API Key | Revele a chave de novo e copie pelo botão do portal |
| Limite de consultas atingido | A cota diária acabou | Volta sozinha no dia seguinte; as bases abertas continuam funcionando normalmente |
O que muda depois de ativar
O Web of Science passa a aparecer na mesma busca, junto com as sete bases abertas, e os resultados repetidos são unificados por DOI — você vê “encontrado em N bases”. Cada registro traz as citações, que as bases abertas nem sempre têm.
Quanto isso acrescenta, medido aqui: numa busca real, 83% dos DOIs recentes trazidos pelo Web of Science não apareciam na busca federada das bases abertas para o mesmo recorte. É cobertura nova de verdade, principalmente em periódicos de editora comercial.
Um limite importante, para não gerar expectativa errada: a API do Web of Science não entrega o PDF nem o resumo. Ela devolve a ficha do artigo. Os que forem de editora paga aparecem no ferdy como “PDF não obtido” — sem consumir crédito — para você baixar pelo acesso da sua universidade e enviar o arquivo.
A chave é sua, e só sua
A licença da Clarivate é pessoal: uma chave por membro da instituição. No ferdy ela fica cifrada, vinculada à sua conta, nunca é exibida de novo depois de salva e não aparece em relatório nenhum. Os resultados que ela traz também não são compartilhados: o cache do Web of Science é separado por usuário.
Isso vale inclusive dentro de uma equipe: um curador não empresta a chave para os orientandos. Cada pesquisador gera a sua, com a própria conta institucional. Quem não é de instituição assinante continua com as sete bases abertas, que não exigem configuração nenhuma.
Você pode trocar ou remover a chave quando quiser, em Minha conta → Integrações.
Se o plano institucional não aparecer
É o obstáculo mais comum, e quase sempre significa que a conta do portal não foi associada à assinatura da universidade. Três caminhos, na ordem:
- Refaça o acesso com vínculo institucional: entre no portal a partir da rede da universidade ou com a sessão CAFe ativa, usando o e-mail institucional.
- Abra um chamado em Contact ou Support no próprio portal, informando o e-mail institucional e pedindo a vinculação da conta à assinatura da sua instituição (mencione o Portal CAPES, se for o caso).
- Procure a biblioteca da universidade e pergunte quem administra o Web of Science na instituição — é essa pessoa que resolve a “institutional integration” do lado de lá.
Enquanto isso, o plano Free Trial (50 requisições por dia) já permite experimentar a integração no ferdy sem esperar.
Guia relacionado: as ferramentas de revisão sistemática em 2026 e o guia do curador.