Messages
Search Chat Messages
Searches messages within a chat by text content. Returns an array of matching message IDs — use with List Chat Messages (first_id or id) to fetch full message content. Requires permission api_messages_search.
https://public-api.fansmetric.comGET/v1/{account_id}/chats/{user_id}/messages/search
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.
user_id*integerFan/user ID of the conversation.
Query Parameters
query*stringSearch text.
Response Fields
dataarrayArray of message IDs matching the search.
_meta._credits.usedintegerCredits consumed by this request (currently always
1)._meta._rate_limits.limit_minuteintegerMaximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteintegerRemaining requests in the current minute window.
_meta._rate_limits.limit_dayintegerMaximum requests per day for the organization.
_meta._rate_limits.remaining_dayintegerRemaining requests in the current day window.
| Field | Type | Description |
|---|---|---|
| data | array | Array of message IDs matching the search. |
| _meta._credits.used | integer | Credits consumed by this request (currently always 1). |
| _meta._rate_limits.limit_minute | integer | Maximum requests per minute for the organization. |
| _meta._rate_limits.remaining_minute | integer | Remaining requests in the current minute window. |
| _meta._rate_limits.limit_day | integer | Maximum requests per day for the organization. |
| _meta._rate_limits.remaining_day | integer | Remaining requests in the current day window. |
curl --request GET "https://public-api.fansmetric.com/v1/100000001/chats/sample_user_id/messages/search?query=creator" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":[
0:1000000000001
1:1000000000004
2:1000000000005
]
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}