API Marketer v1.0

API Marketer v1.0 Documentation

Welcome to the API Marketer documentation. Our API is designed to allow you to programmatically retrieve your campaign information, statistics, and manage your tracking links with ease.

Base URL:

https://onlysudo.com

Authentication

All requests to our API must be authenticated with a valid API Key. We provide two methods for authentication:

1. Authorization Header (Recommended): Pass your API Key in the Authorization header of your HTTP request.

   Authorization: [Your API Key]

To get your API Key, navigate to the API interface and click the blue "Generate a new key" button.

API Endpoints

All endpoints use the POST method and follow the base path /api/marketer?do=campaigns.

1. Get Active Campaigns

Retrieves a list of all active campaigns associated with your account.

• Endpoint: /api/marketer?do=campaigns
• Method: POST
• Authorization Header:
  • Authorization: [Your API Key] (string, optional): Your API Key.
• Example Request Body:JSON

  {
    "limit": 10,
    "offset": 0
  }

• Example Response:JSON

  {
    "status": "success",
    "data": [
      {
        "id": 123,
        "name": "test",
        "url": "test",
        "type": "free_trial",
        "onlyfans_url": "test",
        "onlyfans_id": 123123,
        "onlyfans_account": {
          "name": "test",
          "username": "test",
          "about": "test",
          "avatar": {
            "original": "https://test.com/avatar_url.jpg",
            "thumbnail": "https://test.com/avatar_url.jpg",
            "thumbnail_640": "https://test.com/avatar_url.jpg"
          },
          "demo_content": [],
          "regular_price": 0,
          "promotions": [],
          "blocked_countries": [],
          "subscribers_count": 0,
          "likes_count": 0,
          "posts_count": 0,
          "photos_count": 0,
          "videos_count": 0,
          "performer_top": 0
        },
        "visits": 400,
        "subscribers": 40000,
        "subscribers_today": 4000,
        "income": 1000000,
        "income_today": 1000,
        "revenue": 4000,
        "date_create": 1672527600,
        "date_update": 1672527600,
        "tags": [
          "test"
        ]
      }
    ]
  }

2. Get Transactions

Retrieves a list of all transactions (conversions, leads, etc.) for your campaigns.

• Endpoint: /api/marketer?do=transactions
• Method: POST
• Authorization Header:
  • Authorization: [Your API Key] (string, optional): Your API Key.
• Example Response:JSON

  {
    "status": "success",
    "data": [
      {
        "id": 0,
        "campaign_id": 0,
        "subscriber_id": 0,
        "onlyfans_id": 0,
        "type": "tip",
        "amount": 0,
        "revenue": 0,
        "is_undo": false,
        "date": 0
      }
    ]
  }

3. Get Subscribers

Retrieves a list of subscribers generated through your campaigns, typically for lead-generation offers.

• Endpoint: /api/marketer?do=subscribers
• Method: POST
• Authorization Header:
  • Authorization: [Your API Key] (string, optional): Your API Key.
• Example Response:JSON

  {
    "status": "success",
    "data": [
      {
        "id": 0,
        "campaign_id": 0,
        "onlyfans_id": 0,
        "name": "test",
        "url": "test",
        "revenue": 0,
        "date_subscribe": 0
      }
    ]
  }

4. Generate Advanced OnlyFans Tracking Link

This endpoint is designed for advanced media buyers with test budgets of $2-5k. It provides a specialized tracking link for OnlyFans campaigns, enabling granular control over your postback tracking.

The functionality allows for:

• Receiving postbacks from OnlyFans to your tracking platform.
• Precise management of click_id for accurate attribution.
• Data-driven optimization of your campaigns.

For detailed implementation guides, macro usage, and best practices, please contact your account manager.