Back to Browse
GameDataKit Occasion Lookup — Upcoming Gift Occasions by Country
x402
GameDataKit Occasion Lookup — Upcoming Gift Occasions by Country is a paid API for AI agents from api.borisinc.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).
Returns a list of upcoming gift-giving occasions (e.g. Christmas, Valentine's Day) for a given country, including dates, days until, and suggested order-by deadlines.
Price / call$0.003
Success—
StatusUnknown
How this service works
Live Steam best-sellers, deals, per-app detail and IGDB metadata, Twitch hype scores, and agent utilities for verification and extraction. From $0.001 a call, free samples on every endpoint, auth-then-capture. MCP and HTTP.
Output
A JSON object containing a count of upcoming occasions, the country code, and an array of occasion objects each with: name, date, type (e.g. gift_occasion), days_until, and suggested_order_by deadline date.
Example use cases
E-commerce holiday campaign planner
“I'm running an online gift shop targeting US customers — what are the next gift-giving occasions coming up and what are the suggested order deadlines for each one?”
Gift reminder app event seeding
“I need to populate my gift reminder app with upcoming occasions for US users, including the dates and how many days away each one is. Can you pull that list?”
Retail inventory prep scheduling
“I want to know which gift occasions are coming up in the US over the next few months so I can plan my inventory orders — can you get me the list with the order-by dates?”
Technical details
Endpoint
GEThttps://api.borisinc.com/paid/util/occasionWhen to prefer
Choose this endpoint when you need a quick, pay-per-call lookup of upcoming gift-giving occasions with e-commerce-friendly metadata (order deadlines, days until) for a specific country, without needing to maintain an account or API key. Ideal for agents automating retail campaign planning, gift reminders, or inventory scheduling.
Side effects
- Invalid or unsupported country code returns empty occasions array or error
- No upcoming occasions within the lookahead window returns count of 0
- Network or payment failure returns HTTP 402 or 5xx with no data
- Malformed request (wrong HTTP method) returns 400 or 422 error
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"count": 3,
"country": "US",
"occasions": [
{
"date": "2026-12-25",
"name": "Christmas",
"type": "gift_occasion",
"days_until": 40,
"suggested_order_by": "2026-12-11"
}
]
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"