Get Daily Notes

Get daily community note creation trends.

Returns aggregated daily counts of community notes grouped by publication status for the specified date range (maximum 90 days).

Publication Status Categories:

  • published: Notes with status CURRENTLY_RATED_HELPFUL
  • temporarilyPublished: Notes that were previously helpful but now need more ratings or are not helpful
  • evaluating: Notes currently being evaluated (NEEDS_MORE_RATINGS, never been helpful)
  • unpublished: All other 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" for all statuses (default: "all")

Returns: GraphListResponse containing: - data: List of daily aggregated note counts - updatedAt: Last data update timestamp (YYYY-MM-DD format)

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

get/api/v1/graphs/daily-notes

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/daily-notes
  • 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

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": [
    {
      "date": "2025-01-15"
    }
  ],
  "updatedAt": "2025-01-15"
}

Changes

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