Last updated: 23/12/2016
  • Installs:
  • Today: 108
  • This Week: 963
  • This Month: 3333
  • All Time: 47752


This endpoint creates a categorization task. In this task, one of our workers will view the attachment and choose a category for it according to the instruction. You may allow multiple categories to be chosen by setting allow_multiple to true. Example use cases are spam detection, copyright detection, product categorization, etc.


Step 1: Login to your Scale API dashboard
Step 2: Copy and save your TEST API KEY for testing or LIVE API KEY for production.

Test This Block

  • apiKey
    Body parameter
    Scale Application Key.

  • gear
    Required Parameters

    • callbackUrl
      Body parameter
      The full url (including the scheme http:// or https://) of the callback when the task is completed.
    • instruction
      Body parameter
      A markdown-enabled string explaining how to categorize the item. You can use markdown to show example images, give structure to your instructions, and more.
    • attachmentType
      Body parameter
      One of `text`, `image`, `video`, `audio`, `website`, or `pdf`. Describes what type of file the attachment is.
    • attachment
      Body parameter
      cloud upload
      Upload file
      The attachment to be categorized. If `attachmentType` is text, then it should be plaintext. Otherwise, it should be FILE a URL pointing to the attachment.
    • plus
      An array of strings for the categories which you’d like the object to be sorted between.
    • category
      Body parameter
      Single category
    • x icon
    Optional Parameters
    • urgency
      Body parameter
      Default if `day`. A string describing the urgency of the response. One of `immediate`, `day`, or `week`, where immediate is a one-hour response time.
    • categoryIds
      Body parameter
      An optional dictionary where the keys are the optional ids, and the values are the category values provided in categories.
    • allowMultiple
      Body parameter
      Default is `false`. Determines whether you allow multiple categories to be chosen for the attachment
    • metadata
      Body parameter
      A set of key/value pairs that you can attach to a task object. It can be useful for storing additional information about the task in a structured format.
    Show Optional Parameters
    TEST Function
    CODE (NodeJS)

    Nice try, But you still have to Log in.
    Meanwhile, you can enjoy this limerick:

    "A programming genius called HEAP
    Had trouble in getting to sleep
    So he made his lambs troup
    through a huge FOR-NEXT loop
    FOR 1 TO 10000: NEXT sheep."

    Sign in to get the snippet
    Sign In
    $ / m
    We will charge your card every month for the plan amount, as well as any overages incurred in the previous month.

    Oops, we are missing some details

    Looks like there are a few missing details that you haven't filled in yet.
    These details are important and will help us protect you and let you know about anything new.


    Connect your app to AudioTranscription via RapidAPI

    Consume and monitor multiple APIs through the RapidAPI SDK.
    Click start to set up your app and connect to AudioTranscription.


    Give your app a name

    This app will be used in RapidAPI to collect and connect all the APIs you need.


    Connect your project

    Choose your backend language and then install & require the RapidAPI SDK.

    • node
    • php
    • python
    • objc
    • android
    • go
    • ruby
    • csharp

    Install SDK

    Run the following command to install the SDK:

    npm install rapidapi-connect --save

    Require SDK

    In your code, add the following code to require the RapidAPI SDK:


    Hooray! You are connected

    Use the following code to try it out by getting all the APIs that are on RapidAPI.'RapidAPI', 'getAll', {'{}'});
    esccloses this view

    Login to RapidAPI

    Create endpoints based on popular APIs and share with others.
    Follow popular APIs and get updated. Stand out in the community of developers.

    Login with Github
    Login with Facebook
    Login with Google
    Remember Me

  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view

    Why sign up to RapidAPI?

    • integrate
      Integrate APIs into your app
      Ruby, Java, Elixir, Node.js, Phyton, Objective C, Swift, PHP and MORE
    • keys
      Save all API keys in one place
    • notifications
      Get notifications about API changes
    • stats
      Get stats and monitor API connections
    Sign up with Github
    Sign up with Facebook
    Sign up with Google
  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view


    esccloses this view