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.
/v1/projects/{projectId}/audits/reputationAuthorization
agent-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
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.
uuidResponse 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).
Online presence audit results GET
Results of the project's most recent online-presence audit: social networks, search engines, platforms, and the recommendations derived from them.
Apply a proposal — the diff is recomputed and compared before writing POST
Applies a diff produced by a propose capability.