Report Content

GET /projects/{project}/reports/{report_number}/content

The primary integration endpoint. Returns the full generated SEO content for a specific report, grouped by keyword.

Path parameters

Parameter	Type	Description
project	integer	Project ID
report_number	integer (1-26)	The report's position in the project's delivery sequence

Returns 400 if report_number is outside 1-26. Returns 404 if no report with that number exists for this project.

Request

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/projects/42/reports/14/content

Response

{
  "data": {
    "report_number": 14,
    "report_id": 1081,
    "report_name": "H3 + Text 3",
    "content_scheme": "h3_text_blocks",
    "content_scheme_fields": ["h3", "text"],

    "links": {
      "project_website": "https://digipartner.se",
      "report_web": "https://admin.trakk.ai/reports/view/abc123",
      "report_pdf": "https://admin.trakk.ai/reports/digipartner-report-14.pdf"
    },

    "project_id": 42,
    "project_domain": "https://digipartner.se",
    "project_status": "active",

    "is_generated": true,
    "generation_status": "completed",
    "approved_status": "approved",
    "approved_by": { "id": 7, "name": "Jane Smith", "role": "Account Manager", "agency": { "id": 12, "name": "Digipartner Agency" } },
    "managed_status": "completed",
    "managed_by": { "id": 7, "name": "Jane Smith", "role": "Account Manager", "agency": { "id": 12, "name": "Digipartner Agency" } },

    "date_to_create_texts": "2026-02-20",
    "date_to_send_to_client": "2026-03-01",

    "summary": {
      "keyword_count": 18,
      "keywords_with_content": 18
    },

    "keywords": [
      {
        "keyword_id": 901,
        "keyword": "seo agency stockholm",
        "keyword_url": "https://digipartner.se/seo-stockholm",
        "has_content": true,
        "content": [
          { "h3": "Leading SEO Agency in Stockholm", "text": "We help businesses in Stockholm grow through…" },
          { "h3": "Expert SEO Services Stockholm", "text": "Our Stockholm-based team delivers…" },
          { "h3": "Stockholm SEO - Results That Last", "text": "Proven SEO strategies tailored for…" }
        ],
        "html": [
          { "h3_and_text": "<h3>Leading SEO Agency in Stockholm</h3>\n<p>We help businesses…</p>" },
          { "h3_and_text": "<h3>Expert SEO Services Stockholm</h3>\n<p>Our Stockholm-based team…</p>" },
          { "h3_and_text": "<h3>Stockholm SEO - Results That Last</h3>\n<p>Proven SEO strategies…</p>" }
        ]
      }
    ]
  },
  "cache_refreshed_at": "2026-03-30T12:00:00.000000Z"
}

Top-level fields

Field	Type	Nullable	Description
report_number	integer	No	Report number (1-26)
report_id	integer	No	Internal report ID
report_name	string	Yes	Human-readable report type label
content_scheme	string	Yes	Scheme identifier (see Content Schemes)
content_scheme_fields	array	Yes	Field names present in each content block
is_generated	boolean	No	true when generation_status is completed
generation_status	string	No	See Enums
approved_status	string	Yes	See Enums
approved_by	user object	Yes	User who approved the report
managed_status	string	Yes	See Enums
managed_by	user object	Yes	User managing the report
date_to_create_texts	date	Yes	Content creation deadline
date_to_send_to_client	date	Yes	Scheduled delivery date
summary.keyword_count	integer	No	Total active keywords for this project
summary.keywords_with_content	integer	No	Keywords that have content for this report
project_domain	string	Yes	Project website URL
project_status	string	No	See Enums

Keyword fields

Field	Type	Nullable	Description
keyword_id	integer	No	Keyword ID
keyword	string	No	The keyword phrase
keyword_url	string	Yes	Target page URL for this keyword
has_content	boolean	No	true if content has been generated for this keyword in this report
content	object or array	Yes	Plain-text content. null when has_content is false. Shape depends on content_scheme
html	object or array	Yes	HTML-formatted content ready to embed. null when has_content is false. Shape depends on content_scheme

Read content_scheme first

Always read content_scheme before accessing keyword content - do not hardcode assumptions about the shape. See Content Schemes for the full reference.