List Pulses
GET/pulse
List non-expired trending pulses. Without filters, returns today's hottest topics across all categories sorted by heat score.
Query Parameters
| category | string | Filter by category name |
| locale | en-US | zh-CN | Filter by locale |
| limit | 1–50 (default 20) | Page size |
| page | ≥1 (default 1) | Page number |
| orderBy | heatScore | heatDelta | createdAt | Sort field, always desc (default heatScore) |
Request
curl "https://atypica-test.bear-agent.com/api/pulse" # With filters curl "https://atypica-test.bear-agent.com/api/pulse?locale=en-US&limit=5&category=AI+Tech"
Response (200 OK)
{
"success": true,
"data": [
{
"id": 193,
"title": "China QKD Network: quantum chip breakthrough",
"content": "Today's buzz highlights...",
"category": "Science",
"locale": "en-US",
"heatScore": 473.97,
"heatDelta": 0.31,
"createdAt": "2026-02-14T02:53:04.647Z"
}
],
"pagination": { "page": 1, "pageSize": 20, "total": 84 }
}Get Pulse Categories
GET/pulse/categories
List all distinct non-expired pulse categories.
Query Parameters
| locale | en-US | zh-CN | Filter categories by locale (optional) |
Request
curl "https://atypica-test.bear-agent.com/api/pulse/categories"
Response (200 OK)
{
"success": true,
"data": ["AI Product", "AI Tech", "Business", "LLM Tech", "Science"]
}Get Pulse
GET/pulse/:id
Get a single non-expired pulse with its source posts and heat history.
Request
curl "https://atypica-test.bear-agent.com/api/pulse/193"
Response (200 OK)
{
"success": true,
"data": {
"id": 193,
"title": "China QKD Network: quantum chip breakthrough",
"content": "Today's buzz highlights...",
"category": "Science",
"locale": "en-US",
"heatScore": 473.97,
"heatDelta": 0.31,
"createdAt": "2026-02-14T02:53:04.647Z",
"history": [
{
"date": "2026-02-12",
"heatScore": 421.18
},
{
"date": "2026-02-13",
"heatScore": 448.62
},
{
"date": "2026-02-14",
"heatScore": 473.97
}
],
"posts": [
{
"postId": "1890123456789",
"author": "quantumresearcher",
"content": "China just deployed...",
"views": 124000,
"likes": 3200,
"retweets": 870,
"replies": 145,
"url": "https://x.com/..."
}
]
}
}Error Responses
404 Not Found
{
"success": false,
"message": "Pulse not found"
}500 Internal Server Error
{
"success": false,
"message": "Internal server error"
}Rate Limits
API requests are currently not rate-limited, but please use responsibly.
Rate limiting may be enforced in the future. We recommend implementing exponential backoff in your client.