{"uid":"cap_EaarlIDb-7pZd1EQs81cR","slug":"gamedatakit-occasion-lookup-upcoming-gift-occasions-by-country-df60d878","name":"GameDataKit Occasion Lookup — Upcoming Gift Occasions by Country","description":"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.","url":"https://api.borisinc.com/paid/util/occasion","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"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"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cMrjZJnjqSIOMcs6DsR4r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What upcoming gift occasions are there for customers in the US, and when do I need to order by to make each one?","exampleUseCases":[{"title":"E-commerce holiday campaign planner","prompt":"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?"},{"title":"Gift reminder app event seeding","prompt":"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?"},{"title":"Retail inventory prep scheduling","prompt":"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?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:20.888Z","isFirstParty":false}