Get Notes Evaluation Status

Get individual note evaluation metrics ordered by helpful count.

Alternative sorting to notes-evaluation endpoint - orders by helpfulCount instead of impressionCount for moderation review workflows (maximum 90 days range).

Metrics:

  • helpfulCount: Number of helpful ratings
  • notHelpfulCount: Number of not-helpful ratings
  • impressionCount: Number of times note was displayed

Ordering: Results ordered by helpfulCount DESC (different from /notes-evaluation)

Status Filter:

  • all: All notes regardless of status (default)
  • published: Only published notes
  • temporarilyPublished: Only temporarily published notes
  • evaluating: Only notes being evaluated
  • unpublished: Only unpublished notes

Date Range:

  • Timestamps must be in milliseconds (Unix epoch, UTC)
  • Maximum range: 90 days
  • start_date must be <= end_date
  • Timestamps must be >= 2006-07-15 (Twitter founding) and <= current time

Args: start_date: Start timestamp in milliseconds (required) end_date: End timestamp in milliseconds (required) status: Filter by specific status or "all" (default: "all") limit: Maximum number of results (default: 200, max: 5000)

Returns: GraphListResponse containing: - data: List of individual note evaluation metrics - updatedAt: Last data update timestamp (YYYY-MM-DD format)

Raises: HTTPException: 400 if validation fails, 422 if timestamp format invalid

get/api/v1/graphs/notes-evaluation-status

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/notes-evaluation-status
  • Auth: none declared

Query parameters

start_dateinteger required

Start timestamp in milliseconds (Unix epoch, UTC)

end_dateinteger required

End timestamp in milliseconds (Unix epoch, UTC)

status'all' | 'published' | 'evaluating' | 'unpublished' | 'temporarilyPublished'

Filter by note publication status

limitinteger

Maximum number of results (max 5000)

languagestring nullable

Comma-separated language codes to filter by (e.g., ja,en)

keywordsstring nullable

Comma-separated keywords for AND search in note summaries

Response

Successful Response

updatedAtstring required

Last update timestamp in YYYY-MM-DD format (UTC). Derived from MAX(created_at) of source table.

Example response

{
  "data": [
    {
      "noteId": "1234567890123456789"
    }
  ],
  "updatedAt": "2025-01-15"
}

Changes

No recorded changes to this operation across all 1 revision of this API.