Check analytics is installed

check_analytics_installation

Checks whether analytics is installed and collecting on a site, and whether the site is published yet.

POST /v1/check_analytics_installationScopeanalytics:readRead only

It fetches the live page at the site's free web address and looks for the tracking script, so it is a real network round trip rather than a database read. It answers installed, published and the url it checked, and a page that cannot be fetched reads installed false rather than failing. A site that is not published yet answers installed false without fetching anything.

Use it first when numbers come back empty. It makes no analytics lookup, so it spends none of the 1,200 lookups access tokens share per site per hour. See What is counted.

Request

Call it with a POST to https://api.modulify.ai/v1/check_analytics_installation, sending the inputs below as a JSON object. The token needs the analytics:read scope.

It only reads and changes nothing, so retrying it is safe.

curl -X POST https://api.modulify.ai/v1/check_analytics_installation \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'

Over MCP, the same method is the check_analytics_installation tool.

Inputs

Input	Type	Required	Description
`projectId`	string	Yes	The site id.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.