Studio Api Service

Create a new Studio report

post/v2/reporting/studio/reports

Request

  • Base URL: https://app.metricool.com/api
  • URL: https://app.metricool.com/api/v2/reporting/studio/reports
  • Auth: none declared

Request body

promptstring required

User prompt for the report generation

mode'Guided' | 'Expert'

Generation mode

customLogoUrlstring

Public URL of a custom logo to display in the anonymous viewer header. Must be an HTTPS URL hosted on a Metricool S3/CDN domain. If null, the default Metricool logo is used.

Example request

{
  "prompt": "Quiero un gráfico de barras que compare mis estadísticas de tiktok de todas mis marcas",
  "mode": "Guided",
  "customLogoUrl": "https://metricool-download.s3.eu-west-1.amazonaws.com/studio-logo/12345/202605/abc123def456.png"
}

Response

OK

metadataobject

Example response

{
  "data": {
    "id": "25674c14-a879-4e1f-8fd7-c09243a10726",
    "status": "COMPLETED",
    "errorType": "TIMEOUT",
    "studioId": "25674c14-a879-4e1f-8fd7-c09243a10726",
    "name": "Line chart during may 2025",
    "type": "Calendar",
    "period": "01-Feb-2026 - 28-Feb-2026",
    "networks": [
      "facebook",
      "instagram"
    ],
    "brands": [
      {
        "blogId": 123456,
        "name": "My Brand",
        "logo": "https://example.com/logo.png"
      }
    ],
    "totalVersions": 3,
    "customLogoUrl": "https://metricool-download.s3.eu-west-1.amazonaws.com/studio-logo/12345/202605/abc123def456.png",
    "sharedLink": "https://app.metricool.com/c/abc123",
    "selected": true,
    "hasManualEdits": true,
    "totalAgents": 5,
    "failedAgents": 1,
    "failedAgentDetails": [
      {
        "taskIndex": 2,
        "agentName": "engagement-agent",
        "errorType": "TIMEOUT"
      }
    ],
    "shownVersionState": "LATEST"
  }
}

Changes

No recorded changes to this operation across all 4 revisions of this API.