API Reference Overview

Welcome to the Determ API reference. This section documents every available endpoint, including request parameters, body schemas, and response formats.

Base URL

All API requests are made to:

https://api.mediatoolkit.com

Authentication

Every request must include a valid Bearer token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

See the Authentication page for details on obtaining and managing tokens.

Response Format

All responses are returned as JSON. Successful responses return an HTTP 200 status code. Error responses follow the structure described on the Errors & Rate Limits page.

Endpoints

User

• Current User — GET /v2/me — Returns the authenticated user's profile and organization memberships

Reference Data

• Languages — GET /v2/languages — Returns all supported languages
• Locations — GET /v2/locations — Returns all supported locations

Tags

• List Tags — GET /v2/organizations/{organizationId}/tags — Returns tags for an organization

Keywords

• Create Keyword — POST /v2/organizations/{organizationId}/keywords — Creates a new keyword

Mentions — Count

• Count by Keyword — POST .../keywords/{keywordId}/mentions/count — Counts mentions for a specific keyword
• Count by Group — POST .../groups/{groupId}/mentions/count — Counts mentions for a specific group

Mentions — Scroll

• Scroll by Keyword — POST .../keywords/{keywordId}/mentions/scroll — Paginated mentions for a keyword
• Scroll by Group — POST .../groups/{groupId}/mentions/scroll — Paginated mentions for a group