Skip to content

xhs_get_my_notes

Fetch published notes from Creator Center and cache to local database.

Parameters

ParameterTypeRequiredDescription
accountstringNoAccount to use
tabnumberNoFilter: 0=all, 1=public, 2=private (default: 0)
limitnumberNoNumber to fetch (default: 100, max: 500)
timeoutnumberNoTimeout in ms (default: 60000)

Response

json
{
  "account": "account-name",
  "success": true,
  "count": 50,
  "cached": true,
  "notes": [
    {
      "id": "note-id",
      "type": "normal",
      "title": "Note Title",
      "time": "2024-01-01T00:00:00Z",
      "cover": "cover-url",
      "stats": {
        "views": 1000,
        "likes": 100,
        "comments": 20,
        "collects": 50,
        "shares": 10
      },
      "level": 0,
      "permission": "public",
      "sticky": false,
      "xsecToken": "token"
    }
  ]
}

level values

ValueDescription
0Normal
1In traffic
2Pending review
3Not approved
4Self-only visible

Examples

xhs_get_my_notes()
xhs_get_my_notes({ tab: 1, limit: 200 })

Notes

  • Data is automatically cached to local database
  • Use xhs_query_my_notes to query cached data
  • Increase timeout when fetching large amounts

Released under the MIT License.