Get All User Preferences

Retrieve all user preferences with pagination

GET

Retrieve all user preferences with pagination support. Returns a list of user preferences with user information.

Endpoint:

/api/user-preferences

Query Parameters:

  • page (optional) - Page number (default: 1)
  • limit (optional) - Number of items per page (default: 10)

Headers:

Authorization: Bearer YOUR_TOKEN_HERE

Example Request:

curl -X GET \
  "https://api.getcirclo.com/api/user-preferences?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Example Response (200 OK):

{
  "preferences": [
    {
      "id": "uuid",
      "userId": "uuid",
      "version": "prefs_v1",
      "asOf": "2025-11-05T02:20:00Z",
      "freshnessWindowDays": 30,
      "preferredKeywords": ["keyword1", "keyword2"],
      "preferredProfiles": [
        {
          "profile_id": "uuid",
          "profile_name": "John Doe",
          "profile_niche": "Tech Reviewer"
        }
      ],
      "preferredNiches": ["Tech Reviewer"],
      "preferredGenders": ["Male"],
      "visualRepresentationAffinities": ["white_aesthetic"],
      "negativeSignals": {
        "niches": ["Blogger"],
        "keywords": ["#RarePlants"]
      },
      "engagementRatio": 0.8,
      "emailActivity": [
        {
          "click_count": 0,
          "open_count": 0,
          "template_name": "post_campaign"
        }
      ],
      "activeHours": ["12:00 UTC", "18:00 UTC"],
      "user": {
        "id": "uuid",
        "name": "User Name",
        "email": "[email protected]"
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 5,
    "totalItems": 50,
    "itemsPerPage": 10
  }
}

Error Responses:

  • 500: Internal server error