Digitalyser.io for developers

Online reputation audit results

Results of the project's most recent reputation audit: reviews, ratings, their distribution over time, and the sources they were collected from.

Results of the project's most recent reputation audit: reviews, ratings, their distribution over time, and the sources they were collected from.

GET/v1/projects/{projectId}/audits/reputation

Authorization

agent-token
AuthorizationBearer <token>

An agent project token. Obtained by OAuth consent for an AI client, or derived per project from an organisation service key for a machine. A scoped API key authenticates the transport but opens no capability: a capability takes its project from the credential.

In: header

Path Parameters

projectId*string

The project this call is about. A routing hint, not an authorisation. The project comes from the credential; this segment exists so multi-project code stays uniform. If it names a project outside the token, the call is refused with routing_hint_mismatch — it is never used to widen access.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.digitalyser.io/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/audits/reputation" \  -H "Authorization: Bearer <token>"
{  "schemaVersion": "2",  "meta": {    "generatedAt": "2026-09-24T06:14:52.000Z"  },  "project": {    "id": "8f14e45f-ea0e-4b1e-9b7a-2c3d4e5f6071",    "brandName": "Acme Corporation",    "websiteUrl": "https://www.acme.example"  },  "status": "completed",  "createdAt": "2026-09-24T06:02:11.000Z",  "completedAt": "2026-09-24T06:14:52.000Z",  "stats": {    "reviews": {      "total": 214,      "sources": 3,      "averageRating": 4.3,      "ratingDistribution": {        "1": 13,        "2": 9,        "3": 18,        "4": 46,        "5": 128      },      "sentiment": {        "positive": 158,        "neutral": 39,        "negative": 17      },      "lastReviewDate": "2026-09-21T16:48:00.000Z"    },    "mentions": {      "total": 46,      "last7d": 5,      "sources": 9,      "lastMentionDate": "2026-09-18T07:30:00.000Z"    },    "socialProof": {      "socialNetworksTracked": 6,      "activeNetworks": 4,      "inactiveNetworks": 2    }  },  "reviewSources": [    {      "id": "9c2f7a41-3e58-4d0b-8b6a-1f5d2c9e4a37",      "platform": "google",      "name": "Google Business Profile",      "url": "https://maps.example/place/acme-corporation",      "averageRating": 4.4,      "reviewCount": 156,      "sentiment": {        "positive": 118,        "neutral": 26,        "negative": 12,        "improvement": [          "Waiting time at pickup",          "Unclear delivery window"        ],        "negativeComment": [          "Order arrived four days late with no notice"        ],        "positiveComment": [          "Staff went out of their way to adjust the fitting"        ]      },      "lastReviewDate": "2026-09-21T16:48:00.000Z",      "sampleReviews": [        {          "text": "Fitting was adjusted twice at no charge — rare these days.",          "sentiment": "positive"        }      ],      "weight": 0.45,      "priority": "high",      "status": "present"    }  ],  "mentions": [    {      "id": "b71e4d90-6c22-4a18-9f03-5e8a7c1d2b64",      "source": "presse-eco.example",      "url": "https://presse-eco.example/2026/09/acme-ouvre-un-atelier",      "date": "2026-09-18T07:30:00.000Z",      "sentiment": "neutral",      "priority": "medium",      "title": "Acme Corporation opens a second workshop",      "excerpt": "…the workshop, run by Acme Corporation, now employs twelve…"    }  ],  "sentimentEvolution": [    {      "createdAt": "2026-08-27T06:09:40.000Z",      "auditId": "5d3b8e17-2a94-4c61-b0f7-8e1a6d9c3f25",      "positive": 141,      "neutral": 44,      "negative": 22    }  ],  "tasks": {    "todo": [      {        "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",        "title": "Reply to the twelve unanswered reviews on Google",        "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",        "status": "todo",        "priority": "high",        "impactPotential": 6,        "scoreWeight": 0.12,        "category": "reviews",        "estimatedTime": "2h",        "suggestions": [          "Answer the four lowest-rated reviews first",          "Publish a standing reply template for delivery complaints"        ],        "improvements": [          "Reply rate above 80% on the source that weighs most"        ]      }    ],    "done": [      {        "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",        "title": "Reply to the twelve unanswered reviews on Google",        "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",        "status": "todo",        "priority": "high",        "impactPotential": 6,        "scoreWeight": 0.12,        "category": "reviews",        "estimatedTime": "2h",        "suggestions": [          "Answer the four lowest-rated reviews first",          "Publish a standing reply template for delivery complaints"        ],        "improvements": [          "Reply rate above 80% on the source that weighs most"        ]      }    ],    "priority": {      "critical": [        {          "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",          "title": "Reply to the twelve unanswered reviews on Google",          "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",          "status": "todo",          "priority": "high",          "impactPotential": 6,          "scoreWeight": 0.12,          "category": "reviews",          "estimatedTime": "2h"        }      ],      "high": [        {          "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",          "title": "Reply to the twelve unanswered reviews on Google",          "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",          "status": "todo",          "priority": "high",          "impactPotential": 6,          "scoreWeight": 0.12,          "category": "reviews",          "estimatedTime": "2h"        }      ],      "medium": [        {          "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",          "title": "Reply to the twelve unanswered reviews on Google",          "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",          "status": "todo",          "priority": "high",          "impactPotential": 6,          "scoreWeight": 0.12,          "category": "reviews",          "estimatedTime": "2h"        }      ],      "low": [        {          "id": "3f6c8b21-9d47-4e50-a1b8-7c2e5f0a9d13",          "title": "Reply to the twelve unanswered reviews on Google",          "description": "Twelve reviews from the last quarter have no reply, four of them below three stars. Answering them publicly is what a reader checks before calling.",          "status": "todo",          "priority": "high",          "impactPotential": 6,          "scoreWeight": 0.12,          "category": "reviews",          "estimatedTime": "2h"        }      ]    }  },  "score": {    "global": 72,    "breakdown": {      "reviews": 78,      "mentions": 61,      "sentiment": 74,      "socialPresence": 55    }  },  "recommendations": {    "immediate": [      "Reply to the twelve unanswered reviews on Google"    ],    "shortTerm": [      "Claim the two directory listings that show no owner"    ],    "longTerm": [      "Build a steady flow of reviews on the second-weighted source"    ],    "strengths": [      "Rating above the sector average on the source that weighs most"    ]  },  "scoreHistory": [    {      "date": "2026-08-27T06:09:40.000Z",      "globalScore": 68,      "reviewsScore": 74,      "mentionsScore": 57,      "sentimentScore": 71,      "socialPresenceScore": 52    }  ],  "competitors": [    {      "name": "Globex Joinery",      "url": "https://globex.example",      "globalScore": 64,      "reviewRating": 4.1,      "reviewCount": 87,      "sentimentScore": 68    }  ]}

Generated from the capability registry — API version 1, 18 paths, from 4815355 (2026-10-12).

Was this page helpful?