Online presence audit results
Results of the project's most recent online-presence audit: social networks, search engines, platforms, and the recommendations derived from them.
Results of the project's most recent online-presence audit: social networks, search engines, platforms, and the recommendations derived from them.
An absent platform and an unreachable platform are not the same thing, and the payload keeps them apart. Treating a fetch failure as an absence would report a problem the project does not have.
/v1/projects/{projectId}/audits/online-presenceAuthorization
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/online-presence" \ -H "Authorization: Bearer <token>"{ "projectId": "550e8400-e29b-41d4-a716-446655440000", "status": "completed", "createdAt": "2026-01-15T10:00:00Z", "completedAt": "2026-01-15T10:03:30Z", "readinessState": "completed", "freshnessState": "current", "scoreAvailabilityState": "available", "scoreSuppressionReason": "Fewer than two platforms could be measured, so the score was withheld.", "globalScore": 65, "stats": { "socialNetworks": { "total": 6, "active": 3, "present": 5, "inactive": 2, "totalFollowers": 8420, "totalPosts": 312, "engagementRate": 3.8, "lastActivity": "2026-09-21" }, "searchEngines": { "total": 3, "indexed": 2, "notIndexed": 1, "coverage": 67 }, "platforms": { "total": 8, "present": 5, "missing": 3, "coverage": 63 }, "globalScore": 65 }, "platforms": [ { "id": "instagram", "name": "Instagram", "category": "social", "status": "present", "priority": "high", "weight": 0.15, "score": 72, "link": "https://social.example/acme", "data": { "followers": 2140, "posts": 186, "engagement": 3.2, "measured": true, "lastPostDate": "2026-09-18", "description": "Menuiserie sur mesure à Lyon depuis 2011.", "title": "Acme Corporation", "brandMatchScore": 88, "matchConfidence": "high", "autoDetected": false, "measurementError": "scrape-blocked-429" } } ], "tasks": [ { "id": "task-instagram-bio", "title": "Add your website link to your Instagram bio", "description": "The bio shows no link, so visitors who find you on Instagram have no way to reach the site.", "status": "todo", "priority": "high", "impactPotential": 6, "scoreWeight": 0.1, "category": "social", "platformId": "instagram", "suggestions": [ "Paste the site URL in the bio", "Use a link the audit can verify" ], "improvements": [ "Visitors from Instagram can reach the site" ] } ], "recommendations": { "immediate": [ "Add your website link to your Instagram bio" ], "shortTerm": [ "Claim the two directory listings that show no owner" ], "longTerm": [ "Build a steady posting rhythm on the two networks that matter most" ] }, "competitors": [ { "id": "5b8d1c4e-0a72-4f33-9e61-7d2c8a95b104", "name": "Globex Joinery", "url": "https://globex.example", "website": "https://www.globex.example", "domain": "globex.example", "eligibility": "accepted-primary", "eligibilityReason": "Same trade, same metropolitan area, measurable on all platforms.", "qualificationState": "accepted", "confidenceLabel": "high-confidence", "freshnessState": "current", "globalScore": 58, "socialPresence": 64, "searchCoverage": 67, "platformCoverage": 50, "stats": {} } ], "scoreHistory": [ { "date": "2026-08-27T06:21:40.000Z", "globalScore": 61 } ]}Generated from the capability registry — API version 1, 18 paths, from 4815355 (2026-10-12).
Local visibility audit results GET
Results of the project's most recent local-visibility audit — the Google Business Profile, its completeness, and local search positioning.
Online reputation audit results GET
Results of the project's most recent reputation audit: reviews, ratings, their distribution over time, and the sources they were collected from.