← All action domains

Google insights

10 operations. Call each with POST https://app.chirply.io/api/v1/actions/<name> and a bearer token; the response is { "data": { "action", "summary", "result" } }. A read badge means the operation changes nothing; write requires the credential’s write scope.

Load Google properties

google_insights.choicesreadadmin only

List GA4 properties and verified Search Console sites accessible through this account's Google Insights grant. Uses Google API quota, changes nothing and incurs no advertising spend.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this account.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.choices \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_choices at https://app.chirply.io/api/mcp, same bearer token, same input.

Connect Google Insights

google_insights.connectreadadmin only

Return an account-bound Google consent link. An account manager must approve read-only Analytics and Search Console access in Google. Does not install tracking, change Google data or spend money.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.connect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_connect at https://app.chirply.io/api/mcp, same bearer token, same input.

Disconnect Google Insights

google_insights.disconnectwriteconfirmadmin only

Remove the stored Google Insights refresh token from this account and stop its reports until reconnected. Keeps property selection for reconnection. Does not delete Google data or revoke other Google integrations; Google-side app permissions can be removed separately in Google.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this account.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.disconnect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_disconnect at https://app.chirply.io/api/mcp, same bearer token, same input.

Add reporting properties

google_insights.import_propertieswriteadmin only

Verify and add multiple accessible GA4 or Search Console properties to this Chirply account. Schedules daily read-only reporting shared with account members. Uses Google API quota; changes no Google data and spends no money.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this account.
sourcesobject[]requiredProperties to add to this account. Existing properties are reconnected without duplication.
sources[].kind"analytics" | "search"requiredGoogle Analytics 4 or Search Console.
sources[].resourcestringrequiredExact resource returned by Load Google properties.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.import_properties \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "sources": [
      {
        "kind": "analytics",
        "resource": "example"
      }
    ]
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_import_properties at https://app.chirply.io/api/mcp, same bearer token, same input.

View all Google properties

google_insights.portfolioread

Read this account's saved Google reporting properties, cached traffic and search reports, previous-period totals, connection state and refresh errors. No Google API calls or money spent. Property totals are independent and may overlap.

Parameters

FieldTypeRequiredDescription
days7 | 28 | 90optionalNumber of completed days to report; excludes the latest three days to accommodate Google processing delays. Default: 28

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.portfolio \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_portfolio at https://app.chirply.io/api/mcp, same bearer token, same input.

View Google property report

google_insights.property_reportread

Read one saved property's traffic or search performance, previous-period totals, daily trend, top 100 pages, channels or queries, countries and devices. Optionally filter a published page URL. Reads Google when refreshed, uncached or page-filtered and uses API quota, without spending money. Search rows omit anonymized queries; GA4 page filters combine the same hostname and path across query strings and protocols. Completed periods end three days ago.

Parameters

FieldTypeRequiredDescription
idstring (uuid)requiredSaved reporting property ID in this account.
days7 | 28 | 90optionalNumber of completed days to report; excludes the latest three days to accommodate Google processing delays. Default: 28
page_urlstring (uri)optionalOptional exact published page URL. Filters GA4 by hostname and page path, and Search Console by exact URL.
refreshbooleanoptionalRefresh from Google instead of using the saved report. Uses provider quota without spending money. Default: false

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.property_report \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_property_report at https://app.chirply.io/api/mcp, same bearer token, same input.

Refresh Google reports

google_insights.reportread

Read aggregate GA4 users, sessions, page views and key events, plus Search Console web clicks, impressions, CTR and position for this account's saved properties. Includes daily trends and top ten channels, queries and pages. Uses Google API quota. Omits the newest three days, requests final Search Console data, and exposes partial failures rather than zeroing failed reports. Query rows may omit anonymized searches. No Google data is changed and no money is spent.

Parameters

FieldTypeRequiredDescription
days7 | 28 | 90optionalNumber of completed days to report; excludes the latest three days to accommodate Google processing delays. Default: 28

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.report \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_report at https://app.chirply.io/api/mcp, same bearer token, same input.

Save reporting properties

google_insights.savewriteadmin only

Verify property access and save this account's GA4 and/or Search Console dashboard selection. Reports are shared with account members. Does not change Google properties, install tracking or spend money.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this account.
property_idstring (or null)requiredGA4 property resource from the property picker, or null for Search Console only.
site_urlstring (or null)requiredExact Search Console site URL or sc-domain identifier from the site picker, or null for Analytics only.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.save \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "property_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "site_url": "https://example.com"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_save at https://app.chirply.io/api/mcp, same bearer token, same input.

Show or hide Google property

google_insights.set_property_activewriteadmin only

Show or hide a saved reporting property in this account. Hiding pauses automatic refresh and preserves saved reports; re-importing or setting active true restores it. Changes no Google data and spends no money.

Parameters

FieldTypeRequiredDescription
idstring (uuid)requiredSaved reporting property ID in this account.
activebooleanrequiredTrue to show the property and resume reporting; false to hide it and pause background refresh.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.set_property_active \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "active": true
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_set_property_active at https://app.chirply.io/api/mcp, same bearer token, same input.

Google Insights connections

google_insights.statusread

Read this account's Google Insights connection status and selected reporting properties. Excludes credentials; does not change data or spend money.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.status \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_status at https://app.chirply.io/api/mcp, same bearer token, same input.

The machine-readable version of this page is GET https://app.chirply.io/api/v1/actions?domain=google_insights — same operations, with full JSON Schemas. Authentication, errors and rate limits are covered in the API documentation home.