Get Opportunities

Find gaps where your brand should be appearing but isn't. Identify citation opportunities.

Requires authentication

60 req/min

Endpoint

GET/get-opportunities

Analyzes recent AI responses to find gaps where your brand could be appearing. Returns a prioritized list of opportunities.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands

daysinteger

Analysis period (7-365)

Default: 30

limitinteger

Max opportunities to return (1-200)

Default: 50

Opportunity Types

not_mentionedHIGH

Competitors appear in the AI response but your brand doesn't. Biggest gap to close.

uncitedMEDIUM

Your brand is mentioned but no URL is cited. Create linkable content to capture these.

low_positionLOW

You appear but ranked #4 or lower. Room to improve positioning.

Response Fields

Opportunity Object

result_idstring

Reference ID for this result

prompt_textstring

The prompt (truncated to 200 chars)

llmstring

AI model identifier

datestring

Date of the response (YYYY-MM-DD)

competitorsarray

Competitors that appeared (name + position)

opportunity_typestring

Type: not_mentioned, uncited, low_position

prioritystring

Priority: high, medium, low

reasonstring

Human-readable explanation

Use Cases

Identify which prompts to focus content efforts on
Find citation opportunities for SEO
Track competitive gaps over time
Prioritize marketing efforts by impact

Code Example

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-opportunities?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224&days=30'

200 OK

1{
2  "opportunities": [
3    {
4      "result_id": "e5f6a7b8-c9d0-1234-ef56-789012345678",
5      "prompt_text": "What are the best CRM tools for real estate agents?",
6      "llm": "gpt-4o",
7      "date": "2026-01-08",
8      "competitors": [
9        { "name": "Competitor A", "position": 1 },
10        { "name": "Competitor B", "position": 2 }
11      ],
12      "opportunity_type": "not_mentioned",
13      "priority": "high",
14      "reason": "Competitors mentioned (2) but your brand is not"
15    },
16    {
17      "result_id": "f6a7b8c9-d0e1-2345-f678-901234567890",
18      "prompt_text": "Best enterprise CRM with Salesforce integration",
19      "llm": "claude-3-5-sonnet",
20      "date": "2026-01-08",
21      "competitors": [],
22      "opportunity_type": "uncited",
23      "priority": "medium",
24      "reason": "Your brand is mentioned but no citation URL"
25    }
26  ],
27  "summary": {
28    "total_opportunities": 23,
29    "not_mentioned_count": 12,
30    "uncited_count": 7,
31    "low_position_count": 4,
32    "period_days": 30
33  },
34  "brand": {
35    "name": "Notion",
36    "website": "https://notion.so"
37  }
38}

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-opportunities?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224&days=30'

200 OK

1{
2  "opportunities": [
3    {
4      "result_id": "e5f6a7b8-c9d0-1234-ef56-789012345678",
5      "prompt_text": "What are the best CRM tools for real estate agents?",
6      "llm": "gpt-4o",
7      "date": "2026-01-08",
8      "competitors": [
9        { "name": "Competitor A", "position": 1 },
10        { "name": "Competitor B", "position": 2 }
11      ],
12      "opportunity_type": "not_mentioned",
13      "priority": "high",
14      "reason": "Competitors mentioned (2) but your brand is not"
15    },
16    {
17      "result_id": "f6a7b8c9-d0e1-2345-f678-901234567890",
18      "prompt_text": "Best enterprise CRM with Salesforce integration",
19      "llm": "claude-3-5-sonnet",
20      "date": "2026-01-08",
21      "competitors": [],
22      "opportunity_type": "uncited",
23      "priority": "medium",
24      "reason": "Your brand is mentioned but no citation URL"
25    }
26  ],
27  "summary": {
28    "total_opportunities": 23,
29    "not_mentioned_count": 12,
30    "uncited_count": 7,
31    "low_position_count": 4,
32    "period_days": 30
33  },
34  "brand": {
35    "name": "Notion",
36    "website": "https://notion.so"
37  }
38}