Check whether Google Ads is connected to your workspace and which Ads account is selected.

GEThttps://api.rankparse.com/v1/google-ads/statusFreeAPI key

Shows whether your workspace has a Google Ads connection and which Ads account keyword calls will run against. It makes no call to Google, does not count against your daily cap and is not rate limited. It takes no parameters.

Response

connectedboolean

true when Google Ads is connected. When false, it is the only field.

google_emailstring

The Google login that was connected.

connected_atinteger

Unix time in milliseconds when it was connected.

selected_customer_idstring | null

The selected Ads account, as a customer ID. null while no account is chosen, in which case keyword calls return 400 google_ads_no_account_selected.

login_customer_idstring | null

Reserved for manager (MCC) account support, which is not available yet. Currently null.

Errors

HTTP	Code	When
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Your role is client.

No MCP tool: this route reports account state, not keyword data.

List accounts

The Ads accounts your Google login can access.

Google Ads overview

Daily caps, roles and shared errors.

curl "https://api.rankparse.com/v1/google-ads/status" \
  -H "X-API-Key: rp_your_key"

Response

{
  "connected": true,
  "google_email": "you@example.com",
  "connected_at": 1756112400000,
  "selected_customer_id": "1234567890",
  "login_customer_id": null
}

Not connected

{
  "connected": false
}

Get connection status

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

List accounts

Google Ads overview

Response

Errors

Related