Fans - AI Summary

Retrieve the AI profile summary for a fan. Poll this endpoint after triggering a generation to check for completion.

get/api/{account}/fans/{fan_id}/summary

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/{account}/fans/{fan_id}/summary
  • Auth
    HTTP bearer

Response

Success

statusstring
analyzed_message_countinteger
last_analyzed_atstring
last_buy_datestring
error_messagestring nullable

Example response

{
  "status": "completed",
  "summary_data": {
    "name": "Jane Doe",
    "preferred_name": "Jane",
    "family_pets": "Has a golden retriever named Max",
    "travel_plans": "Planning a trip to Bali",
    "kinks": "",
    "hobbies": "Yoga, photography",
    "content_preferences": "Behind the scenes content",
    "content_dislikes": "Not into feet content",
    "themes": "",
    "requests": "",
    "interests": "Fitness, travel",
    "other_notes": "",
    "spend_cadence": "Mostly tips on Fridays; said he can't buy anything this month anymore — June",
    "dos_and_donts": "Never mention his wife"
  },
  "analyzed_message_count": 42,
  "last_analyzed_at": "2026-03-19T12:00:00+00:00",
  "last_buy_date": "2026-03-15T18:30:00+00:00",
  "error_message": null,
  "custom_fields": [
    {
      "key": "custom_gift_preferences",
      "label": "Gift Preferences"
    }
  ]
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      endpoint added