ONonlymonster
statistics

Retrieve user metrics for OnlyFans platform

Changed on

Rate limit: 15 requests per second

Required permission: team_metrics.view

get/api/v0/users/metrics

Request

  • Base URL
    https://omapi.onlymonster.ai
  • Auth
    API key in header x-om-auth-token

Query parameters

fromstring date-time required
Example:2025-10-01T00:00:00.000Z

Start of the metrics timestamp range (ISO 8601 Zulu).

tostring date-time required
Example:2025-10-31T23:59:59.999Z

End of the metrics timestamp range (ISO 8601 Zulu).

creator_idsinteger[]

Array of creator IDs to filter metrics by.

user_idsinteger[]

Array of user IDs to filter metrics by.

account_group_idinteger

Account group ID to filter metrics by.

role_idinteger

Role ID to filter metrics by.

offsetinteger required

Offset for pagination.

limitinteger required

Limit for pagination (max 100).

Response

User metrics successfully retrieved.

Example response

{
  "items": [
    {
      "user_id": 123,
      "creator_ids": [
        456,
        789
      ],
      "fans_count": 150,
      "messages_count": 320,
      "template_messages_count": 50,
      "ai_generated_messages_count": 30,
      "copied_messages_count": 10,
      "media_messages_count": 100,
      "paid_messages_count": 25,
      "free_media_messages_count": 80,
      "paid_messages_price_sum": 500.5,
      "words_count_sum": 5000,
      "typed_messages_count": 200,
      "unsent_messages_count": 5,
      "purchase_interval_avg": 3600,
      "reply_time_avg": 120,
      "posts_count": 45,
      "deleted_posts_count": 2,
      "work_time": 28800,
      "break_time": 3600,
      "sold_messages_count": 20,
      "sold_messages_price_sum": 400,
      "total_sold_messages_count": 50,
      "total_sold_messages_price_sum": 1000,
      "purchase_interval_min": 300,
      "purchase_interval_max": 7200,
      "sold_posts_count": 10,
      "sold_posts_price_sum": 200,
      "total_sold_posts_count": 25,
      "tips_amount_sum": 150,
      "total_tips_amount_sum": 300,
      "chargedback_tips_amount_sum": 10,
      "chargedback_posts_price_sum": 20,
      "chargedback_posts_count": 1,
      "chargedback_messages_price_sum": 15,
      "chargedback_messages_count": 1,
      "total_chargedback_tips_amount_sum": 25,
      "total_chargedback_posts_price_sum": 40,
      "total_chargedback_posts_count": 2,
      "total_chargedback_messages_price_sum": 30,
      "total_chargedback_messages_count": 2,
      "internal_templates_count": 15
    }
  ]
}

Changes