> ## 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.

# Get Profile Details (/api-reference/public-profiles/get-profile-details)

Get profile details by username.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/profiles/{username}
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: 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 and tracking 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/profiles/{username}:
    parameters:
      - in: path
        name: username
        description: The username of the profile to get
        example: madison420ivy
        required: true
        schema:
          type: string
    get:
      summary: Get Profile Details
      operationId: getProfileDetails
      description: Get profile details by username.
      parameters:
        - in: query
          name: fresh
          description: If `true` then OnlyFansAPI will always return the real time
            information about profile (eg. when was the profile last online).
          example: true
          required: false
          schema:
            type: boolean
            description: If `true` then OnlyFansAPI will always return the real time
              information about profile (eg. when was the profile last online).
            example: true
            nullable: true
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    ofapi_gender: female
                    ofapi_gender_confidence: 0.99
                    view: f
                    avatar: https://public.onlyfans.com/files/w/w6/w6g/.../123/avatar.jpg
                    avatarThumbs:
                      c50: https://thumbs.onlyfans.com/public/files/thumbs/c50/w/w6/w6g/.../123/avatar.jpg
                      c144: https://thumbs.onlyfans.com/public/files/thumbs/c144/w/w6/w6g/.../123/avatar.jpg
                    header: https://public.onlyfans.com/files/k/kk/kk6/.../123/header_image.jpg
                    headerSize:
                      width: 760
                      height: 570
                    headerThumbs:
                      w480: https://thumbs.onlyfans.com/public/files/thumbs/w480/k/kk/kk6/.../123/header_image.jpg
                      w760: https://thumbs.onlyfans.com/public/files/thumbs/w760/k/kk/kk6/.../123/header_image.jpg
                    id: 123
                    name: name
                    username: username
                    canLookStory: false
                    canCommentStory: false
                    hasNotViewedStory: false
                    isVerified: true
                    canPayInternal: false
                    hasScheduledStream: false
                    hasStream: false
                    hasStories: false
                    tipsEnabled: false
                    tipsTextEnabled: true
                    tipsMin: 5
                    tipsMinInternal: 1
                    tipsMax: 200
                    canEarn: true
                    canAddSubscriber: true
                    subscribePrice: 0
                    isRestricted: false
                    canRestrict: true
                    subscribedBy: false
                    subscribedByExpire: null
                    subscribedByExpireDate: null
                    subscribedByAutoprolong: null
                    subscribedIsExpiredNow: null
                    currentSubscribePrice: null
                    subscribedOn: false
                    subscribedOnExpiredNow: null
                    subscribedOnDuration: null
                    joinDate: 2025-01-01T01:01:01+00:00
                    isReferrerAllowed: true
                    about: ""
                    isMarkdownDisabledForAbout: true
                    website: https://onlyfans.com
                    wishlist: null
                    location: null
                    postsCount: 2
                    archivedPostsCount: 0
                    privateArchivedPostsCount: 0
                    photosCount: 0
                    videosCount: 0
                    audiosCount: 0
                    mediasCount: 0
                    lastSeen: 2025-01-01T01:01:01+00:00
                    favoritesCount: 0
                    favoritedCount: 0
                    showPostsInFeed: false
                    canReceiveChatMessage: false
                    isPerformer: true
                    isRealPerformer: false
                    isSpotifyConnected: false
                    subscribersCount: null
                    hasPinnedPosts: true
                    hasLabels: true
                    canChat: true
                    avatarHeaderConverterUpload: true
                    isPrivateRestriction: false
                    showSubscribersCount: false
                    showMediaCount: true
                    subscribedByData: null
                    subscribedOnData: null
                    canCreatePromotion: false
                    canCreateTrial: false
                    isAdultContent: false
                    canTrialSend: false
                    hasLinks: false
                    referalBonusSummForReferer: 0
                    firstPublishedPostDate: 2025-01-01T01:01:01+00:00
                    isSpringConnected: false
                    isFriend: false
                    isBlocked: false
                    canReport: false
                  _meta:
                    _credits:
                      used: 1
                      balance: 999999835
                      note: Cache MISS. We had to make a new request to OnlyFans.com because the cache
                        expired
                    _cache:
                      is_cached: false
                      note: Cache MISS. We had to make a new request to OnlyFans.com
                    _rate_limits:
                      limit_minute: 10000000
                      limit_day: 50000
                      remaining_minute: 9999999
                      remaining_day: 49993
                properties:
                  data:
                    type: object
                    properties:
                      ofapi_gender:
                        type: string
                        example: female
                      ofapi_gender_confidence:
                        type: number
                        example: 0.99
                      view:
                        type: string
                        example: f
                      avatar:
                        type: string
                        example: https://public.onlyfans.com/files/w/w6/w6g/.../123/avatar.jpg
                      avatarThumbs:
                        type: object
                        properties:
                          c50:
                            type: string
                            example: https://thumbs.onlyfans.com/public/files/thumbs/c50/w/w6/w6g/.../123/avatar.jpg
                          c144:
                            type: string
                            example: https://thumbs.onlyfans.com/public/files/thumbs/c144/w/w6/w6g/.../123/avatar.jpg
                      header:
                        type: string
                        example: https://public.onlyfans.com/files/k/kk/kk6/.../123/header_image.jpg
                      headerSize:
                        type: object
                        properties:
                          width:
                            type: integer
                            example: 760
                          height:
                            type: integer
                            example: 570
                      headerThumbs:
                        type: object
                        properties:
                          w480:
                            type: string
                            example: https://thumbs.onlyfans.com/public/files/thumbs/w480/k/kk/kk6/.../123/header_image.jpg
                          w760:
                            type: string
                            example: https://thumbs.onlyfans.com/public/files/thumbs/w760/k/kk/kk6/.../123/header_image.jpg
                      id:
                        type: integer
                        example: 123
                      name:
                        type: string
                        example: name
                      username:
                        type: string
                        example: username
                      canLookStory:
                        type: boolean
                        example: false
                      canCommentStory:
                        type: boolean
                        example: false
                      hasNotViewedStory:
                        type: boolean
                        example: false
                      isVerified:
                        type: boolean
                        example: true
                      canPayInternal:
                        type: boolean
                        example: false
                      hasScheduledStream:
                        type: boolean
                        example: false
                      hasStream:
                        type: boolean
                        example: false
                      hasStories:
                        type: boolean
                        example: false
                      tipsEnabled:
                        type: boolean
                        example: false
                      tipsTextEnabled:
                        type: boolean
                        example: true
                      tipsMin:
                        type: integer
                        example: 5
                      tipsMinInternal:
                        type: integer
                        example: 1
                      tipsMax:
                        type: integer
                        example: 200
                      canEarn:
                        type: boolean
                        example: true
                      canAddSubscriber:
                        type: boolean
                        example: true
                      subscribePrice:
                        type: integer
                        example: 0
                      isRestricted:
                        type: boolean
                        example: false
                      canRestrict:
                        type: boolean
                        example: true
                      subscribedBy:
                        type: boolean
                        example: false
                      subscribedByExpire:
                        type: string
                        example: null
                        nullable: true
                      subscribedByExpireDate:
                        type: string
                        example: null
                        nullable: true
                      subscribedByAutoprolong:
                        type: string
                        example: null
                        nullable: true
                      subscribedIsExpiredNow:
                        type: string
                        example: null
                        nullable: true
                      currentSubscribePrice:
                        type: string
                        example: null
                        nullable: true
                      subscribedOn:
                        type: boolean
                        example: false
                      subscribedOnExpiredNow:
                        type: string
                        example: null
                        nullable: true
                      subscribedOnDuration:
                        type: string
                        example: null
                        nullable: true
                      joinDate:
                        type: string
                        example: 2025-01-01T01:01:01+00:00
                      isReferrerAllowed:
                        type: boolean
                        example: true
                      about:
                        type: string
                        example: ""
                      isMarkdownDisabledForAbout:
                        type: boolean
                        example: true
                      website:
                        type: string
                        example: https://onlyfans.com
                      wishlist:
                        type: string
                        example: null
                        nullable: true
                      location:
                        type: string
                        example: null
                        nullable: true
                      postsCount:
                        type: integer
                        example: 2
                      archivedPostsCount:
                        type: integer
                        example: 0
                      privateArchivedPostsCount:
                        type: integer
                        example: 0
                      photosCount:
                        type: integer
                        example: 0
                      videosCount:
                        type: integer
                        example: 0
                      audiosCount:
                        type: integer
                        example: 0
                      mediasCount:
                        type: integer
                        example: 0
                      lastSeen:
                        type: string
                        example: 2025-01-01T01:01:01+00:00
                      favoritesCount:
                        type: integer
                        example: 0
                      favoritedCount:
                        type: integer
                        example: 0
                      showPostsInFeed:
                        type: boolean
                        example: false
                      canReceiveChatMessage:
                        type: boolean
                        example: false
                      isPerformer:
                        type: boolean
                        example: true
                      isRealPerformer:
                        type: boolean
                        example: false
                      isSpotifyConnected:
                        type: boolean
                        example: false
                      subscribersCount:
                        type: string
                        example: null
                        nullable: true
                      hasPinnedPosts:
                        type: boolean
                        example: true
                      hasLabels:
                        type: boolean
                        example: true
                      canChat:
                        type: boolean
                        example: true
                      avatarHeaderConverterUpload:
                        type: boolean
                        example: true
                      isPrivateRestriction:
                        type: boolean
                        example: false
                      showSubscribersCount:
                        type: boolean
                        example: false
                      showMediaCount:
                        type: boolean
                        example: true
                      subscribedByData:
                        type: string
                        example: null
                        nullable: true
                      subscribedOnData:
                        type: string
                        example: null
                        nullable: true
                      canCreatePromotion:
                        type: boolean
                        example: false
                      canCreateTrial:
                        type: boolean
                        example: false
                      isAdultContent:
                        type: boolean
                        example: false
                      canTrialSend:
                        type: boolean
                        example: false
                      hasLinks:
                        type: boolean
                        example: false
                      referalBonusSummForReferer:
                        type: integer
                        example: 0
                      firstPublishedPostDate:
                        type: string
                        example: 2025-01-01T01:01:01+00:00
                      isSpringConnected:
                        type: boolean
                        example: false
                      isFriend:
                        type: boolean
                        example: false
                      isBlocked:
                        type: boolean
                        example: false
                      canReport:
                        type: boolean
                        example: false
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 999999835
                          note:
                            type: string
                            example: Cache MISS. We had to make a new request to OnlyFans.com because the
                              cache expired
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache MISS. We had to make a new request to OnlyFans.com
                      _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: 49993
      tags:
        - Public Profiles
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````