Getting Started with MOLOCO Report Developer Portal

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


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:

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"}'

   // 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.


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.



Ad Account

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


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


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


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.


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