ThrendMobi API Documentation

Welcome to the ThrendMobi API. Our RESTful API allows you to programmatically manage campaigns, access reporting data, and integrate with our advertising platform.

Quick Start

To get started with the ThrendMobi API:

1. Sign up for an API account at developer.threndmobi.com
2. Generate your API credentials from the dashboard
3. Make your first API call using the examples below

Authentication

All API requests require authentication using an API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Obtaining API Keys

API keys can be generated from your ThrendMobi dashboard under Settings → API Access. Keep your API keys secure and never expose them in client-side code.

Rate Limits

To ensure fair usage and platform stability, API requests are rate limited:

Rate limit headers are included in all API responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1706183400

Error Handling

The API uses standard HTTP status codes and returns detailed error messages in JSON format:

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The 'start_date' parameter must be in YYYY-MM-DD format",
    "field": "start_date",
    "request_id": "req_abc123xyz"
  }
}

List Campaigns

Retrieve a list of all campaigns in your account.

Query Parameters

curl -X GET "https://api.threndmobi.com/v2/campaigns?status=active&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "camp_12345",
      "name": "Summer UA Campaign",
      "status": "active",
      "budget": 10000.00,
      "spent": 4523.50,
      "start_date": "2026-01-01",
      "end_date": "2026-01-31",
      "created_at": "2025-12-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 45,
    "limit": 10,
    "offset": 0
  }
}

Create Campaign

Create a new advertising campaign.

Request Body

curl -X POST "https://api.threndmobi.com/v2/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New User Acquisition Campaign",
    "type": "cpi",
    "budget": 50000,
    "daily_budget": 2000,
    "bid": 1.50,
    "targeting": {
      "countries": ["US", "CA", "GB"],
      "platforms": ["ios", "android"],
      "os_versions": {
        "ios": "14.0+",
        "android": "10+"
      }
    },
    "start_date": "2026-02-01",
    "end_date": "2026-02-28"
  }'

Update Campaign

Update an existing campaign's configuration.

Use the same parameters as Create Campaign. Only include fields you want to update.

Delete Campaign

Delete a campaign. This action cannot be undone.

Reports Overview

The Reports API allows you to access detailed performance data for your campaigns.

Available Metrics

• impressions - Total ad impressions
• clicks - Total clicks
• installs - App installs
• spend - Total spend in USD
• ctr - Click-through rate
• cpi - Cost per install
• roas - Return on ad spend

Campaign Reports

Get performance reports for specific campaigns.

curl -X GET "https://api.threndmobi.com/v2/reports/campaigns/camp_12345?start_date=2026-01-01&end_date=2026-01-15&granularity=daily" \
  -H "Authorization: Bearer YOUR_API_KEY"

Revenue Reports

Access monetization and revenue data (for publishers).

Upload Creative

Upload a new creative asset for your campaigns.

Supported Formats

• Images: PNG, JPG, GIF (max 2MB)
• Videos: MP4, MOV (max 50MB)
• HTML5: ZIP archive (max 5MB)

List Creatives

Retrieve all creatives in your account.

SDKs & Libraries

We provide official SDKs for popular programming languages: