SecondMeSecondMe API
SecondMe API

User Info

Get user basic information, interest tags, and Key Memory

User information endpoints.

Base URL: https://api.mindverse.com/gate/lab


Get User Info

Get authorized user's basic information.

GET /api/secondme/user/info

Authentication

Requires OAuth2 Token.

Required Permissions

userinfo

Request Example

curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/user/info" \
  -H "Authorization: Bearer lba_at_your_access_token"

Response

Success (200)

{
  "code": 0,
  "data": {
    "userId": "12345678",
    "name": "Username",
    "email": "user@example.com",
    "avatar": "https://cdn.example.com/avatar.jpg",
    "bio": "Personal bio",
    "selfIntroduction": "Self introduction content",
    "profileCompleteness": 85,
    "route": "username"
  }
}
FieldTypeDescription
userIdstringUser ID
namestringUser's name
emailstringUser's email
avatarstringAvatar URL
biostringPersonal bio
selfIntroductionstringSelf introduction
profileCompletenessnumberProfile completeness (0-100)
routestringUser's profile route

Error Codes

Error CodeDescription
apikey.permission.deniedMissing userinfo permission

Get User Shades

Get user's interest tags (only returns tags with public content).

GET /api/secondme/user/shades

Authentication

Requires OAuth2 Token.

Required Permissions

userinfo

Request Example

curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/user/shades" \
  -H "Authorization: Bearer lba_at_your_access_token"

Response

Success (200)

{
  "code": 0,
  "data": {
    "shades": [
      {
        "id": 123,
        "shadeName": "Tech Enthusiast",
        "shadeIcon": "https://cdn.example.com/icon.png",
        "confidenceLevel": "HIGH",
        "shadeDescription": "Passionate about technology",
        "shadeDescriptionThirdView": "They are passionate about technology",
        "shadeContent": "Loves coding and gadgets",
        "shadeContentThirdView": "They love coding and gadgets",
        "sourceTopics": ["programming", "AI"],
        "shadeNamePublic": "Tech Lover",
        "shadeIconPublic": "https://cdn.example.com/public-icon.png",
        "confidenceLevelPublic": "HIGH",
        "shadeDescriptionPublic": "Tech enthusiast",
        "shadeDescriptionThirdViewPublic": "A tech enthusiast",
        "shadeContentPublic": "Enjoys technology",
        "shadeContentThirdViewPublic": "They enjoy technology",
        "sourceTopicsPublic": ["tech"],
        "hasPublicContent": true
      }
    ]
  }
}
FieldTypeDescription
shadesarrayList of interest tags
shades[].idnumberTag ID
shades[].shadeNamestringTag name
shades[].shadeIconstringTag icon URL
shades[].confidenceLevelstringConfidence level: VERY_HIGH, HIGH, MEDIUM, LOW, VERY_LOW
shades[].shadeDescriptionstringTag description
shades[].shadeDescriptionThirdViewstringThird-person description
shades[].shadeContentstringTag content
shades[].shadeContentThirdViewstringThird-person content
shades[].sourceTopicsarraySource topics
shades[].shadeNamePublicstringPublic tag name
shades[].shadeIconPublicstringPublic icon URL
shades[].confidenceLevelPublicstringPublic confidence level
shades[].shadeDescriptionPublicstringPublic description
shades[].shadeDescriptionThirdViewPublicstringPublic third-person description
shades[].shadeContentPublicstringPublic content
shades[].shadeContentThirdViewPublicstringPublic third-person content
shades[].sourceTopicsPublicarrayPublic source topics
shades[].hasPublicContentbooleanWhether has public content

Error Codes

Error CodeDescription
apikey.permission.deniedMissing userinfo permission

Search Key Memory

Search Key Memory by keyword with pagination support.

GET /api/secondme/memory/key/search?keyword=&pageNo=1&pageSize=20

Authentication

Requires OAuth2 Token.

Required Permissions

memory.read

Query Parameters

ParameterTypeRequiredDescription
keywordstringNoSearch keyword
pageNointegerNoPage number (default: 1)
pageSizeintegerNoPage size (default: 20)

Request Example

curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/memory/key/search?keyword=reading&pageNo=1&pageSize=20" \
  -H "Authorization: Bearer lba_at_your_access_token"

Response

Success (200)

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": 12345,
        "factActor": "User",
        "factObject": "Hobbies",
        "factContent": "Enjoys reading science fiction novels on weekends",
        "createTime": 1705315800000,
        "updateTime": 1705315800000,
        "visibility": 1
      }
    ],
    "total": 1
  }
}
FieldTypeDescription
listarrayKey Memory list
list[].idnumberMemory ID
list[].factActorstringFact actor
list[].factObjectstringFact object/category
list[].factContentstringFact content
list[].createTimenumberCreation time (milliseconds timestamp)
list[].updateTimenumberUpdate time (milliseconds timestamp)
list[].visibilitynumberVisibility
totalnumberTotal count

Error Codes

Error CodeDescription
auth.token.invalidToken is invalid or expired