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.
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.
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.
The good thing is that both platforms have very similar methods of getting started.
You can also visit the getting started guide for more details. It is the same guide for both platforms.
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.
If your Subscription still does not show up on your “Subscribed APIs” list, check out Troubleshooting: Twinword API Account Setup via AWS Marketplace
If you would like to see the capabilities of our APIs, you can simply visit any of their web demo pages.
If you are looking for the API documentation, you can find the “See Documentation” button in the “Documentation” 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 API keys and the API endpoints. To confirm your keys and endpoints are working correctly, you might want to use the below CURL command in a terminal shell to test.
curl --request GET \
--url 'https://twinword-word-associations-v1.p.rapidapi.com/associations/?entry=sound' \
--header 'X-RapidAPI-Key: SIGN-UP-RAPIDAPI-FOR-KEY'
curl --request GET \
--url 'https://api.twinword.com/api/word/associations/latest/?entry=sound' \
--header 'X-Twaip-Key: LOGIN-TO-TWINWORD-API-SITE-FOR-KEY'
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.
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.
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 https://aws.amazon.com”. 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.