User API Endpoint Guide v2025-05-22

← Back to OAuth 2.0 Authorization Guide

Rate Limit: You can perform up to 10 requests per minute on this endpoint.
Exceeding the limit will result in HTTP 429 (Too Many Requests).

Important: API requests must include a meaningful User-Agent header. Requests with missing or generic user agents may be blocked with HTTP 403 due to automated abuse protection, and may temporarily result in your IP address being denied further access. Please identify your application clearly by using a custom user agent string, such as: MyApp/1.0 (contact@example.com).

Authentication

This endpoint requires a valid Access Token with the user.profile scope.

Request Example

GET https://api.anisearch.com/v1/my/profile
Authorization: Bearer YOUR_ACCESS_TOKEN

Successful Response

On success, the API returns a JSON object with the authenticated user’s profile data.

Response Fields

Field	Description
`id`	`integer` — User ID.
`name`	`string` — Username.
`joined_at`	`string (ISO8601)` — Registration date in UTC (e.g., `2015-06-01T12:00:00Z`).
`statistics.anime.watching`	`integer` — Number of anime currently being watched.
`statistics.anime.completed`	`integer` — Number of anime completed.
`statistics.anime.on_hold`	`integer` — Number of anime on hold.
`statistics.anime.dropped`	`integer` — Number of anime dropped.
`statistics.anime.bookmark`	`integer` — Number of anime planned to watch.
`statistics.anime.average`	`integer` — Average rating over all anime ratings (range 0–100).
`statistics.anime.episodes`	`integer` — Total episodes watched.
`statistics.anime.rewatched`	`integer` — Number of times anime were rewatched.
`statistics.anime.media_minutes`	`integer` — Total minutes spent watching anime.
`statistics.manga.reading`	`integer` — Number of manga currently being read.
`statistics.manga.completed`	`integer` — Number of manga completed.
`statistics.manga.on_hold`	`integer` — Number of manga on hold.
`statistics.manga.dropped`	`integer` — Number of manga dropped.
`statistics.manga.bookmark`	`integer` — Number of manga planned to read.
`statistics.manga.average`	`integer` — Average rating over all manga ratings (range 0–100).
`statistics.manga.chapters`	`integer` — Total chapters read.
`statistics.manga.volumes`	`integer` — Total volumes read.
`statistics.manga.reread`	`integer` — Number of times manga were reread.
`statistics.manga.media_minutes`	`integer` — Estimated total minutes spent reading manga (8 min/chapter, 72 min/volume).

Example Response

{
  "id": 12345,
  "name": "ExampleUser",
  "joined_at": "2015-06-01T12:00:00Z",
  "statistics": {
    "anime": {
      "watching": 10,
      "completed": 250,
      "on_hold": 5,
      "dropped": 3,
      "bookmark": 20,
      "average": 75,
      "episodes": 3400,
      "rewatched": 50,
      "media_minutes": 102300
    },
    "manga": {
      "reading": 4,
      "completed": 180,
      "on_hold": 2,
      "dropped": 1,
      "bookmark": 15,
      "average": 80,
      "chapters": 4000,
      "volumes": 600,
      "reread": 10,
      "media_minutes": 20300
    }
  }
}