Mass Messages
Direct Message Chart
Returns the same shape as [Mass Message Chart](/api-reference/mass-messages/chart) but scoped to 1:1 direct messages: sent counts under direct_messages and $ purchased from DMs under direct_messages_purchases. Requires permission api_direct_messages_read_chart.
https://public-api.fansmetric.comGET/v1/{account_id}/direct-messages/chart
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
start_datestringWindow start. Default 30 days ago, UTC.
YYYY-MM-DD HH:MM:SSor ISO 8601.end_datestringWindow end. Default end of today, UTC. Same format as
start_date.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/direct-messages/chart?start_date=sample_start_date&end_date=sample_end_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"direct_messages":{
"chart":[
0:{
"date":"2026-06-01T00:00:00+00:00"
"count":512
}
1:{
"date":"2026-06-02T00:00:00+00:00"
"count":535
}
]
"total":4224
"delta":-16
}
"direct_messages_purchases":{
"chart":[
0:{
"date":"2026-06-01T00:00:00+00:00"
"count":3980
}
1:{
"date":"2026-06-02T00:00:00+00:00"
"count":3316.8
}
]
"total":27692.8
"delta":-7.2
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}