Get Post Influence
Get individual post influence metrics.
Returns top posts by impression count with engagement metrics (reposts, likes), ordered descending by impression count for analyzing viral content (maximum 90 days range).
Metrics:
- repostCount: Number of times post was reposted
- likeCount: Number of likes on the post
- impressionCount: Number of times post was displayed
Ordering: Results ordered by impressionCount DESC
Status Filter:
- all: All posts regardless of note status (default)
- published: Posts with published notes
- temporarilyPublished: Posts with temporarily published notes
- evaluating: Posts with notes being evaluated
- unpublished: Posts with no notes or 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 note status or "all" (default: "all") limit: Maximum number of results (default: 200, max: 5000)
Returns: GraphListResponse containing: - data: List of individual post influence metrics - 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/post-influence
- Auth: none declared
Query parameters
Start timestamp in milliseconds (Unix epoch, UTC)
End timestamp in milliseconds (Unix epoch, UTC)
Filter by note publication status
Maximum number of results (max 5000)
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
{
"data": [
{
"postId": "1234567890123456789"
}
],
"updatedAt": "2025-01-15"
}Changes
No recorded changes to this operation across all 1 revision of this API.