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.

OpenAPI Spec

The whole reference is also published as an OpenAPI 3.1 document:

https://developers.determ.com/openapi.json

Import it into Postman or Insomnia, generate a typed client, or hand it to an AI assistant. See the OpenAPI Spec page for details.

Endpoints

User

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

Organizations

• Get Organization — GET /v2/organizations/{id} — Returns a single organization with its groups, keywords, and tags

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
• Delete Keyword — DELETE /v2/organizations/{organizationId}/keywords/{keywordId} — Permanently deletes a keyword and its mentions

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