Getting Started

This guide walks you through making your first API call to Determ in under five minutes.

Prerequisites

• A Determ account with an active plan that supports API access
• Your API token (see below)

Step 1: Get Your API Token

1. Log in to app.determ.com
2. Navigate to Settings > Account Settings
3. Locate the API token field
4. Copy the token and store it securely

TIP

The API token field is available if your plan includes API access. If you don't see it, contact your account manager or Determ support.

Step 2: Make Your First Request

The simplest endpoint to test is GET /v2/me, which returns your user profile. Use it to verify that your token is working.

GET/v2/me

Returns the authenticated user's profile, including name, email, organization IDs, and account metadata.

curl

curl -X GET "https://api.mediatoolkit.com/v2/me" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Python

import requests

url = "https://api.mediatoolkit.com/v2/me"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

JavaScript

const response = await fetch("https://api.mediatoolkit.com/v2/me", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
  },
});

const data = await response.json();
console.log(data);

PHP

<?php

$ch = curl_init("https://api.mediatoolkit.com/v2/me");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_TOKEN",
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Step 3: Understand the Response

A successful request returns a 200 OK with your user profile:

{
  "id": 12345,
  "email": "you@company.com",
  "name": "Jane Smith",
  "verified": true,
  "languageCode": "en",
  "organizationIds": [100, 200],
  "createdTime": 1672531200000,
  "lastLoginTime": 1713200000000
}

Field	Type	Description
id	integer	Your unique user ID
email	string	Account email address
name	string	Display name
verified	boolean	Whether the email is verified
languageCode	string	Preferred language (ISO 639-1)
organizationIds	integer[]	IDs of organizations you belong to
createdTime	integer	Account creation timestamp (epoch ms)
lastLoginTime	integer	Last login timestamp (epoch ms)

INFO

Timestamps are in Unix epoch milliseconds. Divide by 1000 to convert to seconds for most programming languages.

Step 4: Try the Interactive Builder

Fill in your token below and see the request update in real time across all four languages.

Next Steps

Now that you have verified your token works, here are the recommended next steps:

• Authentication — Security best practices for managing your token
• Errors & Rate Limits — Error responses and retry logic
• Count by Keyword — Count mentions for a keyword with filters
• Scroll by Keyword — Retrieve paginated mention data
• API Reference — See all 9 available endpoints