Skip to main content

Quickstart

This guide will get you all set up and ready to use the MentionMarket API. We will cover how to get started and how to make your first API request to search NFL game transcripts.
Before you can make requests to the MentionMarket API, you will need to generate your API key. You can do this from the Authentication page or your dashboard.

Get your API key

First, you will need to generate an API key. You can do this by visiting the Authentication page or by calling the generateApiKey Firebase function from your dashboard.
1

Visit Dashboard

Log in to your MentionMarket dashboard
2

Generate API Key

Navigate to API settings and click “Generate New Key”
3

Save Your Key

Copy and securely store your API key - you’ll need it for all requests

Making your first API request

After you have your API key, you are ready to make your first call to the MentionMarket API. Below, you can see how to send a GET request to the Search NFL Strike Word endpoint to search for a phrase in NFL game transcripts.
curl "https://us-central1-mentionmarket-dddf0.cloudfunctions.net/searchNFLStrikeWord?target_phrase=%22what%20a%20catch%22&apiKey=YOUR_KEY"
If the request is successful, you’ll receive a JSON response with matching game transcripts and metadata.

Understanding the Response

The API returns a JSON object with statistical information about phrase occurrences:
Example Response
{
  "total_games_checked": 1250,
  "games_with_phrase": 45,
  "probability": 0.036,
  "cached": false
}
The response includes:
  • total_games_checked: Total number of games analyzed
  • games_with_phrase: Number of games containing your phrase
  • probability: Likelihood of the phrase occurring (0-1)
  • cached: Whether results were served from cache (cached for 1 week)

What’s next?

Great! You are now set up with an API key and have made your first request to the API. Here are a few links that might be handy as you venture further into the MentionMarket API: