Reports

Generate and retrieve AI visibility intelligence reports. Reports include metrics, competitive analysis, wins/losses, and strategic recommendations.

Requires authentication

60 req/min

List Reports

GET/get-reports

Returns paginated reports for a brand, ordered by creation date (newest first). Use report_id to fetch a single report with its full data snapshot.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands (required unless report_id is provided)

report_idstring

Report UUID to retrieve a single report with full data

report_typestring

Filter by type: executive, weekly, full, intelligence

statusstring

Filter by status: pending, generating, completed, failed, expired

limitinteger

Results per page (1-100)

Default: 20

offsetinteger

Pagination offset

Default: 0

Get Report Detail

GET/get-reports?report_id=X

When report_id is provided, returns a single report including the full report_data snapshot with metrics, competitive analysis, and recommendations.

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-reports?report_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890'

The report_data field is only included in single-report responses. List responses omit it to keep payloads small.

Download Report PDF

GET/get-reports/{report_id}/download

Downloads PDF bytes directly. This endpoint checks the API key and current brand access on every request, so command-line and server clients do not need JavaScript or a browser URL fragment.

1curl -L \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -o trakkr-report.pdf \
4  'https://api.trakkr.ai/get-reports/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download'

The file_url and generation responsedownload_url point to this binary endpoint. Send the same API key on the download request. The URL is not a bearer link.

Response Fields

Report Object

idstring

Unique report identifier

brand_idstring

Brand this report belongs to

report_typestring

Type of report: executive, weekly, full, intelligence

report_namestringnullable

Human-readable report name

time_rangestring

Analysis period (7d, 14d, 30d)

statusstring

Generation status: pending, generating, completed, failed, expired

file_urlstringnullable

API-key-protected binary download endpoint for the generated PDF

file_size_bytesintegernullable

File size in bytes

page_countintegernullable

Number of pages in the PDF

error_messagestringnullable

Error details if generation failed

created_atstring

ISO 8601 creation timestamp

expires_atstringnullable

ISO 8601 expiration timestamp (reports expire after 30 days)

report_data Object (single report only)

metricsobject

Visibility, rank, and presence scores with changes and trends

competitiveobject

Competitor leaderboard, position, and threat analysis

wins_lossesarray

Prompt-level ranking changes (improvements and declines)

recommendationsarray

AI-generated strategic recommendations with priority, effort, and impact

platformsobject

Per-platform visibility breakdown (ChatGPT, Claude, Perplexity, etc.)

executiveobject

Executive narrative, headline, key insight, and priority action

Generate Report

POST/get-reports

Generates a new AI intelligence report for the brand. The report is created synchronously and includes visibility metrics, competitive analysis, wins/losses, and AI-generated strategic recommendations.

Request Body

brand_idstringrequired

Brand UUID

report_typestring

Report type: executive, weekly, or full

Default: executive

time_rangestring

Analysis period: 7d, 14d, or 30d

Default: 7d

1curl -X POST 'https://api.trakkr.ai/get-reports' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{"brand_id": "00000000-0000-4000-8000-81f286d10c3c", "report_type": "executive", "time_range": "7d"}'

200500

1{
2  "report_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3  "status": "completed",
4  "download_url": "https://api.trakkr.ai/get-reports/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download"
5}

Report generation is computationally expensive and rate-limited to 5 requests per minute. Reports expire after 30 days.

Report Types

Type	Description
`executive`	Concise executive summary with key metrics and actions
`weekly`	Weekly performance review with trend analysis
`full`	Comprehensive report with all sections and detailed data

Code example

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-reports?brand_id=00000000-0000-4000-8000-81f286d10c3c'

200400

1{
2  "reports": [
3    {
4      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5      "brand_id": "00000000-0000-4000-8000-81f286d10c3c",
6      "report_type": "executive",
7      "report_name": null,
8      "time_range": "7d",
9      "status": "completed",
10      "file_url": "https://api.trakkr.ai/get-reports/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download",
11      "file_size_bytes": 245000,
12      "page_count": 8,
13      "error_message": null,
14      "created_at": "2026-03-07T10:30:00Z",
15      "expires_at": "2026-04-06T10:30:00Z"
16    }
17  ],
18  "pagination": {
19    "total": 5,
20    "limit": 20,
21    "offset": 0,
22    "has_more": false
23  }
24}

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-reports?brand_id=00000000-0000-4000-8000-81f286d10c3c'

200400

1{
2  "reports": [
3    {
4      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5      "brand_id": "00000000-0000-4000-8000-81f286d10c3c",
6      "report_type": "executive",
7      "report_name": null,
8      "time_range": "7d",
9      "status": "completed",
10      "file_url": "https://api.trakkr.ai/get-reports/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download",
11      "file_size_bytes": 245000,
12      "page_count": 8,
13      "error_message": null,
14      "created_at": "2026-03-07T10:30:00Z",
15      "expires_at": "2026-04-06T10:30:00Z"
16    }
17  ],
18  "pagination": {
19    "total": 5,
20    "limit": 20,
21    "offset": 0,
22    "has_more": false
23  }
24}