Get top performing posts
curl --request GET \
--url https://api.yalg.ai/v1/statistics/recent-posts \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.yalg.ai/v1/statistics/recent-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.yalg.ai/v1/statistics/recent-posts"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"content": "Just shipped a new feature that reduces API response time by 40%...",
"status": "published",
"publishedAt": "2h ago",
"engagement": {
"likes": 24,
"comments": 8,
"shares": 3,
"impressions": 1250
},
"anecdotes": [],
"linkedInUrl": "https://linkedin.com/post/123"
}
]{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request",
"code": "validation_failed"
}{
"statusCode": 401,
"message": "Invalid or missing API key",
"error": "Unauthorized",
"code": "unauthorized"
}{
"statusCode": 403,
"message": "Access denied",
"error": "Forbidden",
"code": "forbidden"
}{
"statusCode": 429,
"message": "Rate limit exceeded",
"error": "Too Many Requests",
"code": "rate_limit_exceeded",
"retryAfter": 60
}{
"statusCode": 500,
"message": "Internal server error",
"error": "Internal Server Error",
"code": "internal_server_error"
}statistics
Get top performing posts
Retrieves posts ranked by engagement performance for the dashboard activity feed. Posts are sorted by engagement score (likes + comments×3 + shares×5 + impressions×0.1) with highest engagement first.
GET
/
v1
/
statistics
/
recent-posts
Get top performing posts
curl --request GET \
--url https://api.yalg.ai/v1/statistics/recent-posts \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.yalg.ai/v1/statistics/recent-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.yalg.ai/v1/statistics/recent-posts"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"content": "Just shipped a new feature that reduces API response time by 40%...",
"status": "published",
"publishedAt": "2h ago",
"engagement": {
"likes": 24,
"comments": 8,
"shares": 3,
"impressions": 1250
},
"anecdotes": [],
"linkedInUrl": "https://linkedin.com/post/123"
}
]{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request",
"code": "validation_failed"
}{
"statusCode": 401,
"message": "Invalid or missing API key",
"error": "Unauthorized",
"code": "unauthorized"
}{
"statusCode": 403,
"message": "Access denied",
"error": "Forbidden",
"code": "forbidden"
}{
"statusCode": 429,
"message": "Rate limit exceeded",
"error": "Too Many Requests",
"code": "rate_limit_exceeded",
"retryAfter": 60
}{
"statusCode": 500,
"message": "Internal server error",
"error": "Internal Server Error",
"code": "internal_server_error"
}Authorizations
ApiKeyAuthbearer
YALG Developer API key. Send it in the x-api-key header from a server-side environment only.
Query Parameters
Number of posts to return (default: 5)
Example:
5
Response
Top performing posts retrieved successfully