Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Chikoh Com Entertainment Predictions API
version: 1.4.0
contact:
email: support@chikoh.com
url: https://chikoh.com
description: 'Operations tagged Entertainment Predictions across 2 of this provider''s published API definitions: chikoh-com-openapi.json, chikoh-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://chikoh.com
description: Production
security:
- {}
- oauth2:
- read
- bearerAuth: []
tags:
- name: Entertainment Predictions
description: TV show predictions, award show predictions (Oscars, Emmys, Grammys), competition show analysis, celebrity intelligence, and content recommendations
paths:
/api/v1/tools/get_show_predictions:
post:
operationId: getShowPredictions
summary: Reality TV show predictions — eliminations, winners, key events
description: AI predictions for reality TV shows cross-referenced with Kalshi prediction market odds. Covers Survivor, Bachelor, Big Brother, Love Island, The Challenge, RuPaul's Drag Race, and more. Returns next elimination, season winner probabilities, and episode-level predictions.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- show
properties:
show:
type: string
description: Show name (e.g., "Survivor", "The Bachelor", "Big Brother", "Love Island")
season:
type: integer
description: Season number (defaults to current)
episode:
type: integer
description: Episode number for episode-level predictions
responses:
'200':
description: Show predictions with AI analysis and market odds
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
/api/v1/tools/get_awards_predictions:
post:
operationId: getAwardsPredictions
summary: Award show predictions — Oscars, Emmys, Grammys, Golden Globes, BAFTAs, Tonys
description: AI-powered award show predictions cross-referenced with Kalshi prediction market data. Analyzes 14 factors including critic consensus, industry buzz, campaign strength, and historical voting patterns. Identifies upsets and dark horses.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- show
properties:
show:
type: string
description: Award show name (e.g., "Oscars", "Emmys", "Grammys", "Golden Globes", "BAFTAs", "Tonys", "SAG Awards")
year:
type: integer
description: Year (defaults to current)
categories:
type: array
items:
type: string
description: Specific categories (e.g., ["Best Picture", "Best Director"]). Omit for all categories.
responses:
'200':
description: Award predictions with confidence, market comparison, and upset potential
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
/api/v1/tools/get_competition_analysis:
post:
operationId: getCompetitionAnalysis
summary: Competition show analysis — The Voice, American Idol, Eurovision, Dancing with…
description: Contestant rankings, voting predictions, and trend analysis for competition shows. Includes Eurovision-specific analysis with neighbor voting and diaspora patterns.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- show_id
properties:
show_id:
type: string
description: Show identifier (e.g., "the-voice", "american-idol", "eurovision", "dancing-with-the-stars", "the-masked-singer")
responses:
'200':
description: Competition analysis with contestant rankings and voting predictions
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
/api/v1/tools/get_celebrity_intel:
post:
operationId: getCelebrityIntel
summary: Celebrity intelligence — profiles, trending, news, projects
description: Comprehensive intelligence on celebrities and entertainment figures. Includes current projects (movies, TV, albums, tours), social media presence, public sentiment, trending score, controversy tracking, and breaking news.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- celebrity_name
properties:
celebrity_name:
type: string
description: Celebrity name (e.g., "Beyoncé", "Timothée Chalamet", "Taylor Swift")
responses:
'200':
description: Celebrity intelligence report
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
/api/v1/tools/get_what_to_watch:
post:
operationId: getWhatToWatch
summary: Personalized "What to Watch" recommendations across streaming platforms
description: AI-powered content recommendations across Netflix, Amazon, Hulu, Disney+, HBO Max, Apple TV+, and more. Factors in mood, available time, preferred genres, and platform subscriptions.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
mood:
type: string
description: Current mood (e.g., "uplifting", "thrilling", "relaxing", "mind-bending")
genre:
type: string
description: Preferred genre (e.g., "drama", "comedy", "sci-fi", "documentary", "reality")
time_available:
type: integer
description: Minutes available to watch (e.g., 30, 60, 120)
platforms:
type: array
items:
type: string
description: Subscribed platforms (e.g., ["netflix", "hulu", "disney+"])
responses:
'200':
description: Personalized recommendations
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
/api/v1/tools/get_kalshi_tv_market:
post:
operationId: getKalshiTVMarket
summary: Live Kalshi prediction market for TV, awards, and events
description: Returns live Kalshi prediction market odds for TV shows (e.g., Survivor Winner), award categories (e.g., Oscars Best Picture), and events. Cross-reference with Chikoh AI predictions.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- market_name
properties:
market_name:
type: string
description: Market name or ticker (e.g., "Survivor Winner", "Oscars Best Picture", "Emmys Best Drama")
responses:
'200':
description: Kalshi market odds and Chikoh comparison
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResponse'
tags:
- Entertainment Predictions
servers:
- url: https://chikoh.com
description: Production
components:
schemas:
ToolResponse:
type: object
properties:
answer:
type: string
description: Markdown-formatted expert analysis
confidence:
type: string
enum:
- high
- medium
- low
data:
type: object
additionalProperties: true
follow_up_questions:
type: array
items:
type: string
context_upgrades:
type: object
additionalProperties:
type: string
source:
type: string
securitySchemes:
oauth2:
type: oauth2
description: Sign in with your Chikoh account. Required for Syndicate tools.
flows:
authorizationCode:
authorizationUrl: https://chikoh.com/api/v1/oauth/authorize
tokenUrl: https://chikoh.com/api/v1/oauth/token
scopes:
read: Access all free and authenticated tools
syndicate: Access Syndicate-exclusive whale tools (requires The Syndicate tier)
bearerAuth:
type: http
scheme: bearer
description: Agent API key (chk_agent_*). Register at /api/v1/agent/register
x-refined-from:
- chikoh-com-openapi.json
- chikoh-com-openapi.yml