Get Top Note Accounts
Get top accounts by note count with period-over-period comparison.
Returns the top 10 accounts ranked by number of notes created in the specified date range (maximum 90 days), together with the change from the equivalent previous period of the same length.
Previous Period Calculation:
- Current period: [start_date, end_date]
- Duration: end_date - start_date (in milliseconds)
- Previous period: [start_date - duration, start_date - 1ms]
- note_count_change = current_count - previous_count (0 if no previous data)
Date Range:
- Timestamps must be in milliseconds (Unix epoch, UTC)
- Maximum range: 90 days
- start_date must be <= end_date
Args: start_date: Start timestamp in milliseconds (required) end_date: End timestamp in milliseconds (required) status: Filter by specific note status or "all" (default: "all")
Returns: GraphListResponse containing: - data: List of top 10 accounts with rank, username, note_count, note_count_change - updatedAt: Last data update timestamp (YYYY-MM-DD format)
Raises: HTTPException: 400 if validation fails, 422 if timestamp format invalid
Request
- Base URL: https://dev.api-birdxplorer.code4japan.org (the document declares no server; this is the origin it was published from)
- URL: https://dev.api-birdxplorer.code4japan.org/api/v1/graphs/top-note-accounts
- Auth: none declared
Query parameters
Start timestamp in milliseconds (Unix epoch, UTC)
End timestamp in milliseconds (Unix epoch, UTC)
Filter by note publication status
Comma-separated language codes to filter by (e.g., ja,en)
Comma-separated keywords for AND search in note summaries
Response
Successful Response
Example response
{
"updatedAt": "2025-01-15"
}Changes
No recorded changes to this operation across all 1 revision of this API.