test AsoWorld Open Api
  1. COMMON PARAM
test AsoWorld Open Api
  • REFERENCE
    • Make Your First API Request
    • API Usage Rules
  • COMMON PARAM
    • OpenAPI Authentication Guide
    • Platform And Region
    • Google Play Language Support
    • Order & SubmitType Reference
    • Transaction Types Reference
  • App
    • Add app
      POST
    • Delete app
      POST
    • My Apps
      POST
  • Keyword
    • Add keyword to app
      POST
    • My Keywords
      POST
    • Get keyword ranking information
      POST
    • Get keyword ranking history
      POST
    • Get recommended keywords
      POST
    • Query keyword install
      POST
  • Order
    • Save order
      POST
    • Start a draft order
      POST
    • Batch save Auto-Suggestion draft orders
      POST
    • Batch start Auto-Suggestion draft orders
      POST
    • Pause an order
      POST
    • Resume an order
      POST
    • List your orders
      POST
    • Cancel an order
      POST
    • Delete draft order
      POST
    • Rating Calculator
      POST
  • Money
    • Get USD balance
    • Get transaction history
  • AI
    • Generate reviews
  • Schemas
    • TransactionRequest
    • AddAppRequest
    • SaveOrderRequest
    • AddKeywordRequest
    • Platform
    • UsdBalanceResponse
    • DeleteAppRequest
    • OrderDetails
    • KeywordRankRequest
    • Region
    • TransactionItem
    • ListAppsRequest
    • DayInstallItem
    • KeywordRankHistoryRequest
    • OrderState
    • TransactionResponse
    • AppInfo
    • ReviewerInfo
    • RecommendKeywordRequest
    • InstallType
    • ErrorResponse
    • ListAppsResponse
    • StartOrderRequest
    • ListKeywordsRequest
    • SubmitType
    • SuccessResponse
    • BatchAutoSuggestionRequest
    • KeywordInstallRequest
    • AutoKeywordOrderDetails
    • MultilingualCountry
    • BatchStartRequest
    • KeywordRankInfo
    • AutoKeywordDayItem
    • OrderIdRequest
    • KeywordHistoryItem
    • ListOrdersRequest
    • RecommendedKeyword
    • GenerateReviewsRequest
    • KeywordInfo
    • RatingCalculatorRequest
    • KeywordInstallInfo
    • SaveOrderResponse
    • KeywordRankResponse
    • ListOrdersResponse
    • KeywordRankHistoryResponse
    • OrderInfo
    • RecommendKeywordResponse
    • BatchSaveOrderResponse
    • GenerateReviewsResponse
    • ListKeywordsResponse
    • RatingCalculatorResponse
    • KeywordInstallResponse
  1. COMMON PARAM

Order & SubmitType Reference

This document describes the SubmitType parameter and order structure for the /order/save API endpoint.

SubmitType Enumeration#

Available Order Types#

SubmitTypeAPI ValueDisplay Name
PACKAGE"PACKAGE"Package Installs
KEYWORD"KEYWORD"Keyword Installs
RATE"RATE"Ratings
REVIEW"REVIEW"Reviews
COMPOSITE"COMPOSITE"Advanced Campaign

Order Type Descriptions#

COMPOSITE (Advanced Campaign)#

Composite order type that includes package installs, keywords, ratings, and reviews functionality
Default behavior: If no submitType parameter is provided, the system automatically sets it to COMPOSITE
Recommended: Supports all parameters, providing maximum flexibility

Single Type Orders#

When a specific order type is specified, the system only processes the corresponding exclusive field parameters:
PACKAGE type: Only processes days parameter, ignores rates, contents, and other fields
KEYWORD type: Only processes days parameter, ignores other exclusive fields
RATE type: Only processes rates and rateType parameters
REVIEW type: Only processes rateType, titles, and contents parameters

Parameter Structure Details#

RATE Type Exclusive Parameters#

{
  "rates": [20, 20],           // Daily rating quantity array
  "rateType": 80               // Rating type: 80=5+4 stars, 100=all 5 stars, 60=all 3 stars
}

REVIEW Type Exclusive Parameters#

{
  "rateType": 80,              // Rating type: 80=5+4 stars, 100=all 5 stars, 60=all 3 stars
  "titles": [                  // iOS review titles (iOS only, Google Play ignores this field)
    ["title1", "title2", "title3", "title4", "title5", "title6"],
    ["title7"]
  ],
  "contents": [                // Review content (required field)
    ["content1", "content2", "content3", "content4", "content5", "content6"],
    ["content7"]
  ]
}
Important Notes:
titles field is only required for iOS applications
Google Play applications will ignore the titles field
Both titles and contents cannot be repeated
If there is no review content, please fill in an empty array

PACKAGE Type Exclusive Parameters#

{
  "days": [                    // Days array, outer array represents days, inner array contains keywords and quantities for each day
    [
      {
        "word": "PACKAGE",     // PACKAGE type: only accepts "PACKAGE" keyword (direct installs)
        "count": 40
      },
      {
        "word": "PACKAGE",
        "count": 40
      }
    ],
    [
      {
        "word": "PACKAGE",
        "count": 50
      }
    ]
  ]
}
Important Notes:
PACKAGE type only accepts "PACKAGE" keyword
Represents direct package installations without keyword targeting

KEYWORD Type Exclusive Parameters#

{
  "days": [                    // Days array, outer array represents days, inner array contains keywords and quantities for each day
    [
      {
        "word": "your_keyword_here",  // KEYWORD type: specific keywords (suggestion: do not add keywords that cannot find your app)
        "count": 40
      },
      {
        "word": "another_keyword",
        "count": 30
      }
    ],
    [
      {
        "word": "mobile_game",
        "count": 25
      }
    ]
  ]
}
Important Notes:
KEYWORD type does not accept "PACKAGE" keyword, requires specific keywords
Suggestion: Do not add keywords that cannot find your application
Each keyword should be relevant to your app for better results

Complete Order Structure#

Create New Order#

{
  "order": {
    "submitType": "COMPOSITE",   // Optional, defaults to "COMPOSITE"
    "platform": 2,              // Platform: 2=App Store iPhone
    "appId": "835599320",        // Application ID
    "region": "US",              // Country/region code
    "installType": "24h",        // Install speed type: '24h'=average within 24 hours, 'once'=immediate
    
    // PACKAGE/KEYWORD parameters
    "days": [...],
    
    // RATE parameters
    "rates": [20, 20],
    "rateType": 80,
    
    // REVIEW parameters (titles only required for iOS)
    "titles": [...],
    "contents": [...]
  }
}

Edit Existing Order#

{
  "orderId": "order_id_here",    // Specify order ID to enter edit mode
  "order": {
    // Order parameters same as above
  }
}
Edit Restrictions:
Only orders in draft status from the user list are allowed to be edited
Submitted or in-progress orders cannot be edited

Usage Recommendations#

1.
Recommended COMPOSITE Type: If your marketing strategy includes multiple promotion methods, using COMPOSITE type can achieve a combination of package installs, keyword promotion, ratings, and reviews in one order.
2.
Single Type Use Cases: If you only need specific promotional services (such as ratings only or keyword promotion only), you can specify a specific submitType.
3.
Parameter Optimization: When submitType is not specified, the system defaults to COMPOSITE, which supports all parameters and provides maximum flexibility.

API Request Examples#

Create COMPOSITE Order#

Create Single Type Order (RATE)#

Create REVIEW Order#

Create PACKAGE Order#

Create KEYWORD Order#

InstallType Parameter#

The installType parameter controls how the daily task volume is distributed over time to complete the installation tasks.

Available InstallType Values#

InstallType ValueDescriptionExample
"24h"Evenly distribute installs over 24 hoursIf daily task is 48 installs: 2 installs per hour, completing within 24 hours
"8h"Evenly distribute installs over 8 hoursIf daily task is 48 installs: 6 installs per hour, completing within 8 hours
"once"Execute all installs immediately at maximum speedAll installs are executed as quickly as possible without time distribution

Usage Examples#

24-hour Distribution:
{
  "installType": "24h"
  // Daily task of 48 installs = 2 installs per hour over 24 hours
}
8-hour Distribution:
{
  "installType": "8h"
  // Daily task of 48 installs = 6 installs per hour over 8 hours
}
Immediate Execution:
{
  "installType": "once"
  // All installs executed immediately at maximum speed
}

Required Parameters#

The following parameters are required for all order types:
ParameterTypeDescriptionExample
platformIntegerTarget platform2
appIdStringApplication ID or package name"835599320"
regionStringCountry/region code (ISO 2-letter code)"US"
installTypeStringInstall speed distribution type"24h"

Type-Specific Required Parameters#

PACKAGE Type#

days - Array of daily installation tasks

KEYWORD Type#

days - Array of daily keyword installation tasks

RATE Type#

rates - Array of daily rating quantities
rateType - Rating distribution type

REVIEW Type#

rateType - Rating distribution type
contents - Review content arrays
titles - Review title arrays (iOS only, ignored by Google Play)

COMPOSITE Type#

At least one of the above type-specific parameters must be provided
Modified at 2026-02-03 11:52:15
Previous
Google Play Language Support
Next
Transaction Types Reference
Built with