How To Subscribe To And Consume Twinword Text Analysis APIs

Twinword provides powerful text-analysis APIs. These natural language processing (NLP) APIs work simply out-of-the-box. This is what makes us unique. You won’t have to deal with training data. If you simply want to know the relationship score between two documents, just make an API call and you got it. Best of all, it is provided as a REST API with the results in JSON format that can be easily parsed.

How to consume Twinword API?

Essentially there are two ways to consume our APIs: through RapidAPI or AWS Marketplace. Regardless of which way works best for you, the API results will be exactly the same even though the endpoint URLs are different.

Here is a table breaking down the two methods.


Connecting Through RapidAPI

Twinword APIs are listed on RapidAPI. The benefit of using this platform is the ability to leverage their ecosystems. They have many different APIs from different providers all listed.

Furthermore, RapidAPI has SDKs for Node.js, PHP, Python, Ruby, Objective-C, Java (Android), Go, C# (.NET), Elixir, and Javascript. With these SDKs, developers can easily jump in and start making API calls almost immediately to many different APIs from one account.


Get Started

The good thing is that both platforms have very similar methods of getting started.

  1. Visit RapidAPI and find the API you are interested in.
  2. Sign up for an account and create an “App” or “Project”.
  3. Select an API and click the “pricing” tab to select a plan (free plan available).
  4. Follow the sample code and install any necessary SDKs.

You can also visit the getting started guide for more details. It is the same guide for both platforms.


Connecting Through AWS Marketplace

Also, if you already have an Amazon account and would like your API subscription charges to be billed to your AWS account, this method is for you.


Get Started

  1. Visit our main API page and see our full list of APIs.
  2. Once you’ve selected an API, under the “Consume API” section of the API’s web demo page, click the “Subscribe on AWS Marketplace” button.
  3. Once on the AWS Marketplace showing the API you selected, click the “Continue” button. If prompted to, login to your AWS account.
    Screenshot of Twinword API listed on AWS Marketplace with Continue button circled
  4. Then select one of the plans and click the “Create Contract” button.
    Screenshot of Twinword API listed on AWS Marketplace on the subscribe to plan page with Create-Contract button circled
  5. Then make sure to complete your subscription setup by clicking “Click here to setup your account” link. (Clicking this link should take you back to the Twinword site to complete the setup. Please make sure to allow any pop-ups that may have been blocked by your browser.)
    Screenshot of Twinword API listed on AWS Marketplace on the modify plan page with Click-here-to-setup-your-account button circled
  6. After clicking the link, you’ll be taken back to the Twinword API My Account login page. Simply login with your Amazon account, not AWS account. For your information, Amazon Web Services uses information from your account to identify you and allow access to Amazon Web Services.  (Caution: Each user needs their own Amazon account. Shared Amazon accounts are not possible).
    Screenshot of Twinword API My Account Page Login
  7. After logging in, you should now see the API you subscribed to in your “Subscribed APIs” list. When you make requests to the API, please include your API key in the header as instructed in your account page. You can also track your API usage on this same page.Screenshot of Twinword API My Account page with the endpoint URL circled.

If your Subscription still does not show up on your “Subscribed APIs” list, check out Troubleshooting: Twinword API Account Setup via AWS Marketplace


Web Demos

If you would like to see the capabilities of our APIs, you can simply visit any of their web demo pages.

Text Similarity API Demo Screenshot



If you are looking for the API documentation, you can find the “See Documentation” button in the “Consume API” section of each API’s web demo pages. Our documentation is hosted on RapidAPI and are mostly the same for each method. The only differences are the code examples and the API endpoints.

Screenshot of Twinword API page that shows on which API marketplaces our APIs can be consumed.

If you are going through RapidAPI, you’ll use the endpoint URLs listed in their code examples.

If you are connecting through AWS, check your Twinword API My Account page for the URL endpoints of the API listed in your “Subscribed APIs” list.


API Keys and Authentication

If you are going through RapidAPI, you’ll need to create an “App” or “Project” to generate an API key for it. After creating it, your unique API keys will be automatically included in the code examples.

If you are connecting through AWS, check your Twinword API My Account page for your unique API key and how to include it in your requests. This one API key will authenticate you for all APIs that you subscribed to and consume through AWS.

Check out our full API list and get started using the power of NLP right out of the box. If you have any questions, feel free to contact us or leave a comment below.


Troubleshooting: Twinword API Account Setup via AWS

If you can’t find your Twinword API subscription on your “Subscribed APIs” list, your browser’s pop-up blocker might be the issue. Enable pop-ups in your browser by clicking “always allow pop-ups and redirects from”. Afterwards, click again on “Click here to setup your account” for the pop-up to open automatically.

Check out the video below where we show you how to do it correctly.




Joseph Shih
Keyword Researcher / Product Developer / Web and Mobile Application Developer at Twinword, Inc.


  1. Ragul Krishnan says:

    how to integrate this api in the vscode?

5 Based On 1

Leave a Reply

Your email address will not be published.