Getting Started with MOLOCO Cloud API

This page will help you get started with MOLOCO Cloud API.

Prerequisite

To call the MOLOCO Cloud API, you need to sign in as a MOLOCO Cloud user. If you don't have an account, please contact our customer service to issue the account:

https://www.molocoads.com/contact

We will create your account and register it to a workplace. Workplace is where you manage your advertisement campaigns.

Once your account is created, you will receive a password reset email. Please update your password using the link enclosed in the email before actually starting to use the account.

Once you have your account ready, you can issue a MOLOCO Cloud API Access Token programmatically. With the token, you can call the MOLOCO Cloud APIs. Please see the following example. In the example, $EMAIL and $PASSWORD are your email address and password. $WORKPLACE_ID is the ID of the workplace that we registered your account to.

$ curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"workplace_id":"$WORKPLACE_ID","email":"$EMAIL","password":"$PASSWORD"}' \
https://morse-us-prod.adsmoloco.com/v1/tokens

{
 "token":"$TOKEN",
 "user":{
   // your account information
  }
}

In the JSON response body, you can find the access token from the token field ($TOKEN). In the subsequent calls to the MOLOCO Cloud API endpoints, you should put this token to the Authorization header in the following manner:

Authorization: Bearer $TOKEN

If you don't place the right token, your calls will be rejected.
For a detailed description of token creation, see Create a new token.

Please note that the token is valid for 1 hour. Therefore, it is recommended to periodically refresh the token before it expires. See Refresh the existing token.

Glossaries

For the successful integration with the MOLOCO Cloud API, you should familiar yourself with the key concepts such as Workplace, Ad Account, Campaign, etc. In below, you can find the definitions of such concepts. For the more detailed list of the MOLOCO Cloud concepts & terms, please see a separate "Glossaries" document.

Term

Definition

Ad Account

Account assigned to a person or organization that promotes products with advertising 'campaigns'.

Campaign

An act to advertise a product. It as a Goal, a creative group, a product to promote, charging related details, targeting information.

Product

Something that needs to be advertised, such as an App.

Creative

Something that should be rendered in the advertisement slot.

Creative Group

Group of Creatives. The creatives belong to the same group is logically equivalent, but with different representations.

Workplace

A Group of Ad Accounts. Conceptually this maps to an Organization that is doing business on MOLOCO Cloud.