Words API

Hoje, apresentaremos uma API especializada no idioma inglês da série chamada Words API. Com esta API você terá acesso a definições, palavras relacionadas e muito mais, tudo através de uma interface REST de fácil utilização. Além disso, o melhor de tudo é que a Words API oferece até 2500 solicitações gratuitas por dia, tornando-a uma opção acessível para quem precisa de recursos linguísticos em seus projetos. Então, se você está buscando aprimorar suas habilidades com o idioma inglês ou precisa incorporar recursos linguísticos em suas aplicações, não deixe de conferir mais informações sobre a Words API neste artigo. Então, para mais detalhes veja 7 APIs públicas, gratuitas e de qualidade e aproveite todas as vantagens dessa incrível ferramenta!

Funcionamento da API

Assim, na página inicial da API, existem várias rotas disponíveis para fazer pesquisas. Então, uma delas é a API de sinônimos, onde você pode inserir um termo e obter os sinônimos relacionados a ele. Desse modo para fazer a requisição, é necessário incluir o termo desejado, o método utilizado (no caso, “synonyms”), a data e hora exata da requisição e um token de autenticação.

A URL gerada para essa requisição é a seguinte: https://www.wordsapi.com/mashape/words/{term}/{method}?when={date-time-zulu}&encrypted={token}. Como exemplo, pode-se utilizar o termo “dog”, a data e hora da requisição foi “2023-09-18T18:49:05.379Z” e o token de autenticação foi “8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8”.

Se você está apenas realizando experimentos, pode gerar um token atualizado diretamente na página da api e praticar. No entanto, se você tem interesse em um uso mais profissional, é recomendado fazer uma assinatura na API através do RapidAPI. A API oferece planos gratuitos e pagos, mas se for por esse caminhoa será necessário fornecer informações de cartão de crédito.

EndPoint: Api de definições de dicionário /definitions

O endpoint em questão é responsável por receber um termo e retornar sua definição de dicionário. Para ilustrar isso, vamos analisar um exemplo simples e direto:

GET https://www.wordsapi.com/mashape/words/dog/definitions?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
    "word": "dog",
    "definitions": [
        {
            "definition": "a smooth-textured sausage of minced beef or pork usually smoked; often served on a bread roll",
            "partOfSpeech": "noun"
        },
        {
            "definition": "go after with the intent to catch",
            "partOfSpeech": "verb"
        },
        {
            "definition": "a hinged catch that fits into a notch of a ratchet to move a wheel forward or prevent it from moving backward",
            "partOfSpeech": "noun"
        },
        {
            "definition": "someone who is morally reprehensible",
            "partOfSpeech": "noun"
        },
        {
            "definition": "a dull unattractive unpleasant girl or woman",
            "partOfSpeech": "noun"
        },
        {
            "definition": "a member of the genus Canis (probably descended from the common wolf) that has been domesticated by man since prehistoric times; occurs in many breeds",
            "partOfSpeech": "noun"
        },
        {
            "definition": "metal supports for logs in a fireplace",
            "partOfSpeech": "noun"
        },
        {
            "definition": "informal term for a man",
            "partOfSpeech": "noun"
        }
    ]
}

EndPoint: API de Sinônimos /synonyms

Muitos semelhante ao exemplo anterior, esse endpoint oferece os diferentes sinônimos de um termo.

GET https://www.wordsapi.com/mashape/words/people/synonyms?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
  "word": "people",
  "synonyms": [
    "hoi polloi",
    "mass",
    "masses",
    "multitude",
    "the great unwashed",
    "citizenry"
  ]
}

EndPoint: API de Antônimos /antonyms

Além desses há um endpoint especializado em antônimos. No exemplo que produzimos, insiro a palavra good e vejo o seu respectivo resultado.

GET https://www.wordsapi.com/mashape/words/good/antonyms?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
    "word": "good",
    "antonyms": [
        "bad",
        "evil"
    ]
}

EndPoint: API de Exemplos de frases /examples

Esse endpoint é especialmente útil para quem está estudando inglês. Nesse caso é possível inserir uma palavra e vê-la utilizada em diferentes contextos, como é o caso da palavra smart no exemplo a seguir.

GET https://www.wordsapi.com/mashape/words/smart/examples?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
    "word": "smart",
    "examples": [
        "smart children talk earlier than the average",
        "a smart new dress",
        "smart weapons",
        "he gave the dog a smart blow",
        "I gave him a smart salute",
        "we walked at a smart pace"
    ]
}

EndPoint: API de Rimas /rhymes

Além dessas há um endpoint específico para lidar com rimas. Basicamente um termo é passado como entrada e diversos termos de saída são obtidos facilmente.

GET https://www.wordsapi.com/mashape/words/dog/rhymes?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
    "word": "dog",
    "rhymes": {
        "all": [
            "antilog",
            "apologue",
            "backlog",
            "bulldog",
            "decalogue",
            "demagogue",
            "dialog",
            "dialogue",
        ]
    }
}

EndPoint: API de Frequência de uso de palavras /frequency

Esse endpoint é curioso por dar a frequencia de uso de uma palavra. Na prática ele entrega informações de zipf, uso por milhão e diversidade de usos do termo. Esse tipo de solução é especialmente util para tradutores e afins. Veja o exemplo do termo fog (neblina).

GET https://www.wordsapi.com/mashape/words/fog/frequency?when=2023-09-18T18:49:05.379Z&encrypted=8cfdb189e7229a9beb9907bee758bab0aeb0280933f89eb8

{
    "word": "fog",
    "frequency": {
        "zipf": 3.88,
        "perMillion": 7.54,
        "diversity": 0.02
    }
}

Outros endpoint

A API oferece um grande conjunto de endpoint além dos citados até o momento. Todos seguem o mesmo formato de uso e podem ser testados através da tela inicial do site da api. Entretanto, para quem deseja apenas fazer estudos com APIs, as APIs aqui citadas são mais do que suficientes para um bom trabalho.

Conclusão de Words API

Por fim, no artigo, exploramos diferentes aspectos da API Words, que oferece uma variedade de recursos úteis para desenvolvedores. Então, analisamos as APIs disponíveis, como a API de definições de dicionário, de sinônimos, de antônimos, de exemplos de frases, rimas e a API de frequência de uso de palavras.

Essa gama de APIs permite aos desenvolvedores obter informações detalhadas sobre as palavras, enriquecendo assim suas aplicações e oferecendo uma experiência mais completa aos usuários.

Além disso, mencionamos a opção de assinatura da API através do RapidAPI, que oferece planos gratuitos e pagos para diferentes necessidades.

Em suma, a API Words se mostrou uma ferramenta poderosa e versátil para explorar e aprimorar o uso de palavras em projetos de desenvolvimento. Recomendamos que os leitores explorem essas APIs e aproveitem ao máximo seus recursos para criar aplicativos e serviços ainda mais inteligentes e eficientes.