Authenticate with your GHL API credentials using the required scope socialplanner/tag.readonly. Use OAuth 2.0 or API keys as supported by the platform.
Rankr authenticates to GHL by exchanging API keys securely and requesting access tokens for the scopes shown. Store credentials securely and rotate regularly.
1) GET /social-media-posting/:locationId/tags fetches tags for a location. 2) POST /social-media-posting/:locationId/tags/details retrieves detailed tag information. 3) socialplanner/statistics.readonly provides read only statistics. 4) POST /social-media-posting/statistics submits statistics updates.
Trigger: on every heartbeat ping from GHL pull current tags for location to update Rankr dashboards
Actions: call GET /social-media-posting/:locationId/tags to retrieve tags and push a summary to Rankr metrics
GET /social-media-posting/:locationId/tags
locationId, tags, timestamp
Trigger: after requesting details for a tag, update Rankr analytics
Actions: call POST /social-media-posting/:locationId/tags/details and feed results into Rankr
POST /social-media-posting/:locationId/tags/details
locationId, tagsDetails, timestamp
Trigger: daily synchronization of statistics
Actions: run socialplanner/statistics.readonly and optionally POST /social-media-posting/statistics to reflect metrics in Rankr
socialplanner/statistics.readonly
statId, locationId, timestamp
Fast setup with a point and click integration between GHL and Rankr
Automatic heartbeat monitoring keeps your social performance on track
Consolidated analytics without writing custom code
A concise glossary of terms used in this guide and how Rankr and GHL work together to connect data
Application Programming Interface: a defined set of rules enabling data exchange between Rankr and GHL
A lightweight check that confirms connectivity and data freshness between systems
A URL that represents a specific operation exposed by an API
The process of proving identity and granting access to resources
Generate weekly trend reports from live tags and publish to Rankr dashboards
Send proactive alerts when tag activity spikes in a channel
Consolidate GHL stats with Rankr metrics for a single source of truth
Obtain your GHL API key and OAuth details, then configure the required scope socialplanner/tag.readonly in Rankr
Complete the OAuth flow or API key setup to grant Rankr access to the endpoints
Test the endpoints GET /social-media-posting/:locationId/tags and POST /social-media-posting/:locationId/tags/details to verify data flow
The Heartbeat connection exposes live data such as tags and statistics from GHL to Rankr. It enables real time monitoring of location activity and helps you keep your campaigns aligned. No code is required and you can enable automated sync via the gated endpoints.
You can set up the integration with API keys or OAuth depending on your GHL configuration. Rankr provides guided steps to authenticate and authorize access. A minimal setup can be completed without writing custom code.
Statistics can be synchronized on a schedule, typically daily, but you can adjust the cadence to fit your workflow. Real time data is available for immediate dashboards.
You will need the socialplanner and tag read permissions within GHL. Ensure the access token includes the correct scopes and rotate credentials regularly.
Yes. You can choose which endpoints to use, such as tags, details, and statistics, depending on your reporting needs. Rankr supports partial activations and staged rollouts.
If a request fails, check your credentials, endpoint paths, and rate limits. Rankr logs errors and provides retry recommendations and test commands.
Yes. Rankr offers a test mode to verify the connection using sample data before you go live. You can also run dry runs of the endpoint calls.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
