> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Mentions (/api-reference/release-forms/list-mentions)
Get a paginated list of mentions: posts where other creators have tagged or mentioned the account in a release form. Pagination is infinite-scroll: follow `_pagination.next_page` (which advances both `offset` and the `fromId` cursor) until it is `null`.
## OpenAPI
````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/release-forms/mentions
openapi: 3.0.3
info:
title: OnlyFans API
description: ""
version: 1.0.0
servers:
- url: https://app.onlyfansapi.com
security:
- default: []
tags:
- name: API Keys
description: ""
- name: Account
description: Endpoints for your linked accounts
- name: Analytics - Financial
description: APIs for retrieving financial analytics data
- name: Analytics - Summary
description: APIs for retrieving summary analytics data
- name: Banking
description: Operations related to user banking details, payout methods, legal
and tax information, and account country settings.
- name: Blocked / Restricted Users
description: APIs for listing the users an account has blocked or restricted
- name: Chargebacks
description: ""
- name: Chat Messages
description: ""
- name: Chats
description: ""
- name: Client Sessions
description: ""
- name: Connect OnlyFans Account
description: ""
- name: Data Exports
description: APIs for managing data exports
- name: Engagement / Messages
description: ""
- name: Fans
description: APIs for managing OnlyFans fans (subscribers)
- name: Fans - AI Summary
description: APIs for generating and retrieving AI-powered fan profile summaries
- name: Following
description: APIs for managing OnlyFans followings (people you're subscribed to)
- name: Free Trial Links
description: APIs for managing Free Trial Links
- name: Giphy
description: ""
- name: Link Tags
description: APIs for managing tags on free trial links, tracking links, and Smart Links
- name: Mass Messaging
description: ""
- name: Media
description: ""
- name: Media Vault
description: ""
- name: Media Vault Lists
description: ""
- name: Notifications
description: Endpoints for managingr account notifications
- name: Payouts
description: ""
- name: Post Comments
description: ""
- name: Post Labels
description: APIs for managing your post labels
- name: Posts
description: APIs for managing OnlyFans posts
- name: Promotions
description: ""
- name: Public Profiles
description: ""
- name: Queue
description: ""
- name: Release Forms
description: APIs for managing OnlyFans release forms
- name: Saved For Later (Messages)
description: ""
- name: Saved For Later (Posts)
description: ""
- name: Settings
description: ""
- name: Shared Free Trial Links
description: APIs for Free Trial Links that other OF creators have shared with
this account. Revenue, cost, and spender data are not available for shared
links.
- name: Shared Tracking Links
description: APIs for Tracking Links (campaigns) that other OF creators have
shared with this account. Revenue, cost, and spender data are not
available for shared campaigns.
- name: Smart Link Postbacks
description: APIs for managing Smart Link postback destinations
- name: Smart Links
description: APIs for managing Smart Links (Free Trial Links and Tracking Links
with pooled inventory)
- name: Statistics
description: ""
- name: Stored Free Trial Links
description: Instant APIs for retrieving stored free trial links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stored Shared Free Trial Links
description: Instant APIs for retrieving stored shared Free Trial Links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stored Shared Tracking Links
description: Instant APIs for retrieving stored shared Tracking Links
(campaigns) from the OnlyFansAPI Cache (free, no credits used)
- name: Stored Tracking Links
description: Instant APIs for retrieving stored tracking links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stories
description: APIs for managing OnlyFans stories
- name: Story Highlights
description: APIs for managing OnlyFans story highlights
- name: Subscription Bundles
description: ""
- name: Tracking Links
description: APIs for managing tracking links
- name: Transactions
description: APIs for managing OnlyFans transactions
- name: User List Collections
description: ""
- name: Users
description: APIs for fetching OnlyFans users
- name: Webhooks
description: ""
paths:
/api/{account}/release-forms/mentions:
parameters:
- in: path
name: account
description: The Account ID
example: acct_XXXXXXXXXXXXXXX
required: true
schema:
type: string
get:
summary: List Mentions
operationId: listMentions
description: "Get a paginated list of mentions: posts where other creators have
tagged or mentioned the account in a release form. Pagination is
infinite-scroll: follow `_pagination.next_page` (which advances both
`offset` and the `fromId` cursor) until it is `null`."
parameters:
- in: query
name: limit
description: Number of mentions to return per page (1-50). Must be at least 1.
Must not be greater than 50.
example: 10
required: false
schema:
type: integer
description: Number of mentions to return per page (1-50). Must be at least 1.
Must not be greater than 50.
example: 10
- in: query
name: offset
description: Number of mentions to skip for pagination. Must be at least 0.
example: 0
required: false
schema:
type: integer
description: Number of mentions to skip for pagination. Must be at least 0.
example: 0
- in: query
name: fromId
description: Cursor for infinite-scroll pagination. Use the `lastId` returned by
the previous page. Prefer following `_pagination.next_page`, which
sets this automatically.
example: null
required: false
schema:
type: integer
description: Cursor for infinite-scroll pagination. Use the `lastId` returned by
the previous page. Prefer following `_pagination.next_page`, which
sets this automatically.
example: null
nullable: true
responses:
"200":
description: ""
content:
application/json:
schema:
type: object
example:
data:
list:
- id: 9000000002
replacePairs:
"{BASE_URL}": https://onlyfans.com
"{RECIPIENT_EMAIL}": creator@example.com
"{RECIPIENT_ID}": 100000001
"{RECIPIENT_LOGIN}": examplecreator
"{RECIPIENT_NAME}": Example Creator
"{RECIPIENT_URL}": https://onlyfans.com/examplecreator
"{RELATED_USER_ID}": 200000001
"{RELATED_USER_NAME}": Another Creator
"{RELATED_USER_LOGIN}": anothercreator
"{RELATED_USER_URL}": https://onlyfans.com/anothercreator
"{RELATED_USER_AVATAR}": https://thumbs.onlyfans.com/public/files/thumbs/c144/example/avatar.jpg
"{RELATED_USER_HAS_AVATAR}": true
"{RELATED_USER_SHORT_NAME}": AC
createdAt: 2026-06-26T02:09:55+00:00
type: user
source: text
text: mentioned you in a post
canGoToProfile: true
isRead: true
user:
id: 200000001
- id: 9000000001
replacePairs:
"{BASE_URL}": https://onlyfans.com
"{RECIPIENT_EMAIL}": creator@example.com
"{RECIPIENT_ID}": 100000001
"{RECIPIENT_LOGIN}": examplecreator
"{RECIPIENT_NAME}": Example Creator
"{RECIPIENT_URL}": https://onlyfans.com/examplecreator
"{RELATED_USER_ID}": 200000002
"{RELATED_USER_NAME}": Third Creator
"{RELATED_USER_LOGIN}": thirdcreator
"{RELATED_USER_URL}": https://onlyfans.com/thirdcreator
"{RELATED_USER_AVATAR}": https://thumbs.onlyfans.com/public/files/thumbs/c144/example/avatar.jpg
"{RELATED_USER_HAS_AVATAR}": true
"{RELATED_USER_SHORT_NAME}": TC
createdAt: 2026-06-23T04:28:11+00:00
type: user
source: tag
text: mentioned you in a post
canGoToProfile: true
isRead: true
user:
id: 200000002
hasMore: true
lastId: 9000000000
_pagination:
next_page: https://app.onlyfansapi.com/api/acct_abc123/release-forms/mentions?limit=10&offset=10&fromId=9000000000
_meta:
_credits:
used: 1
balance: 999999839
note: Always
_cache:
is_cached: false
note: Cache disabled for this endpoint
_rate_limits:
limit_minute: 10000000
limit_day: 50000
remaining_minute: 9999999
remaining_day: 49997
properties:
data:
type: object
properties:
list:
type: array
example:
- id: 9000000002
replacePairs:
"{BASE_URL}": https://onlyfans.com
"{RECIPIENT_EMAIL}": creator@example.com
"{RECIPIENT_ID}": 100000001
"{RECIPIENT_LOGIN}": examplecreator
"{RECIPIENT_NAME}": Example Creator
"{RECIPIENT_URL}": https://onlyfans.com/examplecreator
"{RELATED_USER_ID}": 200000001
"{RELATED_USER_NAME}": Another Creator
"{RELATED_USER_LOGIN}": anothercreator
"{RELATED_USER_URL}": https://onlyfans.com/anothercreator
"{RELATED_USER_AVATAR}": https://thumbs.onlyfans.com/public/files/thumbs/c144/example/avatar.jpg
"{RELATED_USER_HAS_AVATAR}": true
"{RELATED_USER_SHORT_NAME}": AC
createdAt: 2026-06-26T02:09:55+00:00
type: user
source: text
text: mentioned you in a post
canGoToProfile: true
isRead: true
user:
id: 200000001
- id: 9000000001
replacePairs:
"{BASE_URL}": https://onlyfans.com
"{RECIPIENT_EMAIL}": creator@example.com
"{RECIPIENT_ID}": 100000001
"{RECIPIENT_LOGIN}": examplecreator
"{RECIPIENT_NAME}": Example Creator
"{RECIPIENT_URL}": https://onlyfans.com/examplecreator
"{RELATED_USER_ID}": 200000002
"{RELATED_USER_NAME}": Third Creator
"{RELATED_USER_LOGIN}": thirdcreator
"{RELATED_USER_URL}": https://onlyfans.com/thirdcreator
"{RELATED_USER_AVATAR}": https://thumbs.onlyfans.com/public/files/thumbs/c144/example/avatar.jpg
"{RELATED_USER_HAS_AVATAR}": true
"{RELATED_USER_SHORT_NAME}": TC
createdAt: 2026-06-23T04:28:11+00:00
type: user
source: tag
text: mentioned you in a post
canGoToProfile: true
isRead: true
user:
id: 200000002
items:
type: object
properties:
id:
type: integer
example: 9000000002
replacePairs:
type: object
properties:
"{BASE_URL}":
type: string
example: https://onlyfans.com
"{RECIPIENT_EMAIL}":
type: string
example: creator@example.com
"{RECIPIENT_ID}":
type: integer
example: 100000001
"{RECIPIENT_LOGIN}":
type: string
example: examplecreator
"{RECIPIENT_NAME}":
type: string
example: Example Creator
"{RECIPIENT_URL}":
type: string
example: https://onlyfans.com/examplecreator
"{RELATED_USER_ID}":
type: integer
example: 200000001
"{RELATED_USER_NAME}":
type: string
example: Another Creator
"{RELATED_USER_LOGIN}":
type: string
example: anothercreator
"{RELATED_USER_URL}":
type: string
example: https://onlyfans.com/anothercreator
"{RELATED_USER_AVATAR}":
type: string
example: https://thumbs.onlyfans.com/public/files/thumbs/c144/example/avatar.jpg
"{RELATED_USER_HAS_AVATAR}":
type: boolean
example: true
"{RELATED_USER_SHORT_NAME}":
type: string
example: AC
createdAt:
type: string
example: 2026-06-26T02:09:55+00:00
type:
type: string
example: user
source:
type: string
example: text
text:
type: string
example: mentioned you in a post
canGoToProfile:
type: boolean
example: true
isRead:
type: boolean
example: true
user:
type: object
properties:
id:
type: integer
example: 200000001
hasMore:
type: boolean
example: true
lastId:
type: integer
example: 9000000000
_pagination:
type: object
properties:
next_page:
type: string
example: https://app.onlyfansapi.com/api/acct_abc123/release-forms/mentions?limit=10&offset=10&fromId=9000000000
_meta:
type: object
properties:
_credits:
type: object
properties:
used:
type: integer
example: 1
balance:
type: integer
example: 999999839
note:
type: string
example: Always
_cache:
type: object
properties:
is_cached:
type: boolean
example: false
note:
type: string
example: Cache disabled for this endpoint
_rate_limits:
type: object
properties:
limit_minute:
type: integer
example: 10000000
limit_day:
type: integer
example: 50000
remaining_minute:
type: integer
example: 9999999
remaining_day:
type: integer
example: 49997
tags:
- Release Forms
components:
securitySchemes:
default:
type: http
scheme: bearer
description: Get your API Key from OnlyFansAPI Console -
https://app.onlyfansapi.com/api-keys
````