1. Open Amazon.com Account (if you don’t already have one)

If you already have an Amazon.com account, then jump directly to the next step.  Otherwise, go to Amazon.com and create an account (it’s free).  This will involve entering an email address, creating a password, and giving Amazon your credit card information.

2. Subscribe to the Data Ninja Services on Amazon API Gateway

If you are interested in using Smart Data Services, then navigate to https://auth.dataninja.net/cart?service=sd

This will take you to a page showing the different tiers of subscriptions available for this service.  Selected your desired subscription plan.  If it is a paid plan (i.e., something other than the “Basic” tier), then the credit card on file for your Amazon.com account will be charged each month at the start of the month.  Note that if you choose the “Basic” tier, then you will not be charged for any usage upto the daily and monthly limits allowed, but usage beyond those limits will not be permitted.  If you anticipate being a heavy user of the service, we encourage you to subscribe to a paid plan.

If you are interested in using Smart Content Services, then repeat the above step(s) starting from https://auth.dataninja.net/cart?service=sc.

If you are interested in using Smart Sentiment Services, then repeat the above step(s) starting from https://auth.dataninja.net/cart?service=ss.

If you are interested in using Smart Learning Services, then repeat the above step(s) starting from https://auth.dataninja.net/cart?service=sl.

Note that you must choose a subscription level for each of these four services (Smart Data, Smart Content, Smart Sentiment, and Smart Learning).   These subscriptions are independent, and you can subscribe to any one, two, three, or all four of these services.  All four services offer a Basic subscription tier with a certain number of free queries per day, so we encourage you to subscribe to all of these services.

3. Read the documentation

Once you have signed up for a subscription plan for one or more of the Data Ninja services, you can familiarize yourself with their usage by navigating to the http://swagger.dataninja.net/docs page.  Click the tab for the service of interest and note the list of API endpoints for this service listed on the page.  Click on any API endpoint name to open up a pane that lets you try out this service by entering the API key you got in Step 2, together with any input to test the service.  When you have filled in the fields in the form, click the blue “Try it out!” button to see the output of the service in response to your input.   For additional details on usage, you can read the detailed documentation provided by clicking on the red “Browse Documentation” button earlier in the page.

4. Contact Information

Found any issues? Send us an email at support@dataninja.net. In your email, please include the API marketplace (Amazon API Gateway) where you registered.

1. Open Mashape account.

If you do not already have a Mashape account, then please open one (it’s free). Go to the Mashape homepage at https://www.mashape.com/ and click on the "Sign Up" button at the top right of the page. You will need to provide your email address and choose a username and password. You can also sign up with your Github account.

2. Subscribe to the Data Ninja Services on Mashape.

If you are interested in using Smart Data Services, then go to the Smart Data Services page at https://market.mashape.com/dataninja/smart-data You will be on the "Documentation" pane of this web page, as can be seen from the green underline of the word "Documentation" at the upper left of the page. The documentation contains information about the REST API endpoints on the left, and has example code on the right showing you how to query these APIs. However, before you can start querying these APIs, you will need to subscribe to the Smart Data Services.

To do so, click on "Pricing" which is just to the right of "Documentation" at the upper left of the web page. This will take you to a page showing the different tiers of subscriptions available for this service. Click on your desired subscription plan and enter credit card details for billing. Note that you must enter your credit card details even if you opt for the Basic tier of subscription. This is because even though you will not be charged up to the allowed daily maximum number of queries if you are in the Basic tier, any queries beyond the allowed daily maximum number will automatically incur a charge per additional query, and this charge will be billed to your credit card on file.

Mashape does not allow you to disable your subscription after you reach your daily maximum number of queries, so please be warned that if you exceed this daily maximum, you will be charged automatically.

Similarly, if you are interested in using Smart Content Services, then repeat the above step(s) for the Smart Content Services page at https://market.mashape.com/dataninja/smart-content and if you are interested in using Smart Learning Services, then repeat the above step(s) for the Smart Learning Services page at https://market.mashape.com/dataninja/smart-learning

Note that you must choose a subscription level for each of these three services (Smart Data, Smart Content, and Smart Learning), and enter your credit card details separately for each of them. These subscriptions are independent, and you can subscribe to any one, two, or all three of these services. All three services offer a Basic subscription tier with a certain number of free queries per day, so we encourage you to subscribe to all of these services.  

3. Have fun with the services!

After subscribing to any one, two, or all three of the services, visit the "Documentation" pane of the web pages of your subscribed services (you can also do so following the "My APIs" button on the top right of the browser page) to learn more about each service’s endpoints and how to query its APIs. The "Documentation" page also has a way for you to test the API with your chosen inputs: just enter the appropriate input in the field at the left and click the "Test endpoint" button below the input field to see the returned results in the pane on the right.

The right-hand pane also has example query code in various languages like Java, Python, Ruby, etc., and also command-line curl commands. Please experiment by putting this code in your application(s). Note that the example query code also shows you your personal Mashape key, which is used to authenticate you on Mashape. Without this key, you will be unable to access any DataNinja Service.

4. Learn about other use cases.

For examples of use cases involving Data Ninja Services, visit the Use Cases page.

5. Contact Information

Found any issues? Send us an email at support@dataninja.net.  In your email, please include the API marketplace (Mashape Marketplace) where you registered.

Introduction

You need to sign in or create a new account in AWS Marketplace before subscribing to Data Ninja APIs. Once you have an account in AWS Marketplace, you can sign up for the any and all of Data Ninja API services. Your API key is assigned to the individual Data Ninja API service. Every service has its own unique API key, so you will need to sign up separately for each Data Ninja API service. It is possible share the same sign up credentials, but not the same API key. 

1. Subscribe to the Data Ninja Services on Amazon Marketplace

Your credit card on file for your Amazon Marketplace account will be charged each month at the start of the month. You will not be charged for any usage up to the daily and monthly limits allowed for the free tier, but usage beyond those limits will not be permitted. If you anticipate a high volume of requests in monthly period, it is better to subscribe to a paid plan before you reach the limit. 2000 daily requests are at no charge for Smart Content, Smart Sentiment, and Smart Data. 100 daily requests are at no charge for Smart Learning. The four services (Smart Data, Smart Content, Smart Sentiment, and Smart Learning) are independent, and you can subscribe to any one, two, three, or all four of these services. All four services offer a certain number of free queries per day, so we encourage you to subscribe to all of these services. Select your services.

2. Read the documentation

Each service has its own overview documentation. You can get an explanation of the different services and features.

Lists of operations, endpoints, and code examples are documented on the Data Ninja API pages. Click on any API endpoint name to open up a pane that lets you try out this service. Enter your API key, together with any input to test the service. When you have filled in the fields in the form, scroll to the bottom of code window and click the “Try it out!” button to see the output. Choose the Data Ninja API page.

3. Unsubscribe

To unsubscribe, you need to return to AWS marketplace under Your Account Your Software Subscriptions. You will see a list of your software subscriptions and you can use the “CANCEL SUBSCRIPTION” button to remove your Data Ninja API subscription.

4. Contact Information

Found any issues? Send us an email at support@dataninja.net. In your email, please include the API marketplace where you registered plus your username and API key.