Competitive Insights v2 enables advertisers to access performance and relevancy data that helps them optimize their campaigns by understanding their competitive position within their markets. This feature provides share of voice, CPC, ROAS, and spend metrics compared to other advertisers competing for the same audience segments.
The API uses competitive sets to define market groupings (such as geographic markets, property types, or custom segments) and returns aggregated performance data showing how an advertiser performs relative to their competition. Most reporting endpoints utilize dimensions and metrics objects for the user to define which columns to include in the report. Please work with the Koddi team to identify which dimensions and metrics are configured for your client.
These endpoints require authorization via an authorization header. Please work with the Koddi team to receive credentials that can be used in the Sessions - Token or Sessions - Login endpoint.
| Method | Path | Description |
|---|---|---|
| GET | /console/v1/member_groups/{member_group_id}/competitive_sets | This endpoint retrieves available competitive sets for a given advertiser. Use this to identify valid competitive set names and values before making insights requests. API users can utilize this endpoint. |
| POST | /console/v2/member_groups/{memberGroupId}/competitive_sets | This endpoint retrieves all competitive sets across a client (member group), not tied to a specific advertiser. Supports pagination and keyword search for filtering results. Non-API users can utilize this endpoint. |
| POST | /console/v1/member_groups/{member_group_id}/advertisers/{advertiser_id}/competitive_insights | This endpoint gets competitive insights data for a specific advertiser, including market share of voice, CPC, ROAS, and spend metrics. Results are automatically filtered to the specified advertiser ID. Non-API users can utilize this endpoint. |
| POST | /console/v1/member_groups/{memberGroupId}/competitive_insights | This endpoint gets competitive insights data at the client level, automatically including all advertisers within the member group. Best suited for client-wide competitive analysis. Non-API users can utilize this endpoint. |
| POST | /console/v1/member_groups/{memberGroupId}/markets/competitive_insights | This endpoint gets competitive insights data at the market level, automatically including all advertisers within the member group with no advertiser filtering applied. Best suited for market-wide competitive analysis. Non-API users can utilize this endpoint. |