Skip to main content
GET
/
searchNFLStrikeWord
Search NFL Strike Word
curl --request GET \
  --url https://us-central1-mentionmarket-dddf0.cloudfunctions.net/searchNFLStrikeWord
{
  "total_games_checked": 123,
  "games_with_phrase": 123,
  "probability": 123,
  "context": [
    {}
  ]
}
This endpoint requires an API key. See Quickstart for details.

​
Query Parameters

​
apiKey
string
required
Your API key for authentication
​
target_phrase
string
required
Phrase(s) of interest. Multiple phrases can be provided as a comma-separated list (e.g., “tie, ties, tied”). Maximum 3 phrases.
​
target_home_team
string
Filter by home team(s). Supports comma-separated multiple teams (e.g., “DEN,KC”). Maximum 8 teams.
​
target_away_team
string
Filter by away team(s). Supports comma-separated multiple teams (e.g., “LAC,LV”). Maximum 8 teams.
​
target_week
number
Filter by NFL week number. Week numbers greater than 17 either come from the last week of the season since 2021 or the playoffs.
​
team_match_mode
boolean
If true, filters for matchups of home teams AND away teams passed in. If false (default), filters for any game with the home teams OR away teams parameterized.
​
start_date
string
Filter games from this date onwards (format: YYYY-MM-DD).
​
end_date
string
Filter games until this date (format: YYYY-MM-DD).
​
target_game_type
string
Filter by game type. Valid values: REG (Regular Season), WC (Wild Card), DIV (Divisional), CON (Conference Championship), SB (Super Bowl)
​
target_weekday
string
Filter by day of week. Valid values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
​
with_context
boolean
If true, returns context snippets around matched phrases. Default: false. Returns the first num_transcripts amount from the sample.
​
num_transcripts
number
Number of transcripts to return context from when with_context=true. Default: 5. Maximum: 10.
​
context_words
number
Number of words before and after the matched phrase to include in context snippets. Default: 5. Maximum: 20.

​
Response

​
total_games_checked
number
Total number of games checked for the phrase.
​
games_with_phrase
number
Number of games containing at least one of the phrases.
​
probability
number
Probability of the phrase occurring (0-1). Calculated as games_with_phrase / total_games_checked.
​
context
array
Array of context snippets when with_context=true. Each item contains:
  • game_id: Game identifier
  • home_team: Home team abbreviation
  • away_team: Away team abbreviation
  • game_day: Date of the game (YYYY-MM-DD)
  • game_type: Type of game (REG, WC, DIV, CON, SB)
  • week: NFL week number
  • matched_phrase: The phrase that was matched
  • text: Words surrounding the matched phrase

​
Tips

Use team_match_mode=true to filter for specific matchups, or false (default) to search any games involving the specified teams.
Maximum limits: 3 phrases, 8 home teams, 8 away teams per request.