ClickMeter API
Browse all Clickmeter APIsAgent-ready OpenAPI document · curated by JenticMarketingMarketing AutomationapiKey104 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Manage the full ClickMeter v2 surface - datapoints, conversions, groups, domains, guests, and aggregated reporting - so agents can build, attribute, and analyse marketing link campaigns end to end.
Use for: I need to create a trackable datapoint for a campaign URL, Retrieve aggregated click statistics for the last 30 days, List the most recent 100 tracking events for an account, Find all conversions associated with a specific datapoint
Not supported: Does not handle email or SMS sending, ad spend management, or web session analytics - use for link tracking, conversion logging, and aggregated reporting only.
Jentic publishes the only available OpenAPI specification for ClickMeter API, keeping it validated and agent-ready. This is the full v2 surface of the ClickMeter link tracking platform, exposing 104 endpoints across account management, datapoints (trackable links), groups, conversions, domains, IP blacklists, guest permissions, and aggregated reporting. Endpoints under /aggregated and /clickstream return time-series and event-level data suitable for campaign analysis, while /conversions and /datapoints provide CRUD plus relationship management between conversions and the links that drove them.
Install Jentic One Beta
Connect the ClickMeter API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ClickMeter API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fclickmeter.com%2Fclickmeter-api" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fclickmeter.com%2Fclickmeter-api" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with ClickMeter API.
Create and manage datapoints (trackable links) with grouping, tagging, and custom destination rules
Log conversion events and link them to one or many datapoints via /conversions/{id}/datapoints/patch
Pull aggregated click and conversion statistics over a timeframe via /aggregated and /aggregated/list
Stream the latest 100 tracking events for an account via GET /clickstream
Manage guest users and per-object permissions for shared link reporting
Maintain IP blacklists and domain whitelists to filter and authorise tracked traffic
Use Cases
Patterns agents use ClickMeter API for, with concrete tasks.
★ End-to-End Campaign Attribution
Marketing operations teams use the v2 surface to provision datapoints per channel, register conversions for downstream goals, then pull /aggregated reports that join clicks to conversions. The endpoint surface lets a team move from raw clickstream data through to summary dashboards without exporting CSVs.
Pull aggregated statistics for the timeframe 2026-05-01 to 2026-05-31 grouped by datapoint and return the top five datapoints by conversion count
Real-Time Clickstream Monitoring
GET /clickstream returns the latest 100 tracking events. Operations teams poll this endpoint to spot anomalies - sudden spikes from a single IP, traffic from unexpected geographies, or suspected bot patterns - and react in minutes rather than waiting for nightly reports.
Fetch the latest clickstream events and flag any IP address that appears more than 10 times in the most recent 100 hits
Shared Reporting With Guest Permissions
Agencies and freelancers use guest accounts to give clients scoped visibility into their own campaign data. The API creates a guest via POST /account/guests, then grants per-object permissions through /account/guests/{id}/{type}/permissions/patch. Setup takes minutes per client versus rebuilding standalone reporting portals.
Create a guest user for client@example.com with read permissions on group ID 4421 and confirm the permission was set
Agent-Driven Campaign Optimisation
An AI agent monitors aggregated conversion rates per datapoint, identifies underperforming links, and rewrites destination URLs or pauses spend. Through Jentic, the agent searches for 'pull aggregated click and conversion stats', loads the operation, and executes against credentials held in your Jentic One instance. The full optimisation loop runs without human triage of the dashboard.
Identify any datapoint with a conversion rate below 1 percent over the last 14 days and return the list with current destination URLs
Key Endpoints
104 endpoints — jentic publishes the only available openapi specification for clickmeter api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/aggregated
Retrieve account statistics for a timeframe
GET
/aggregated/list
Retrieve account statistics grouped by time bucket
GET
/clickstream
Retrieve the last 100 tracking events
POST
/conversions
Create a conversion event
GET
/conversions/{conversionId}/datapoints
List datapoints linked to a conversion
POST
/account/guests
Create a guest user
POST
/account/domainwhitelist
Whitelist a redirect domain in DDU mode
GET
/aggregated
Retrieve account statistics for a timeframe
GET
/aggregated/list
Retrieve account statistics grouped by time bucket
GET
/clickstream
Retrieve the last 100 tracking events
POST
/conversions
Create a conversion event
GET
/conversions/{conversionId}/datapoints
List datapoints linked to a conversion
POST
/account/guests
Create a guest user
POST
/account/domainwhitelist
Whitelist a redirect domain in DDU mode
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the ClickMeter v2 API by hand means setting the X-Clickmeter-AuthKey header, choosing the http or https apiv2.clickmeter.com host, and mapping calls across aggregated reports, clickstream, and conversions yourself. Through Jentic you install once, import the ClickMeter API from the API Directory, store the API key once, and your agent calls it.
Permission scoping
ClickMeter drives most writes from the request body, so scope the agent to the operations it needs, such as pulling aggregated stats and logging a conversion. You choose which operations are in the allowed set, so account-level changes like adding guests or whitelisting domains are not callable unless you add them.
Credential isolation
Your ClickMeter API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'pull aggregated click stats' or 'log a conversion against a link', and Jentic returns the matching ClickMeter operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using ClickMeter API through Jentic.
Why is there no official OpenAPI spec for ClickMeter API?
ClickMeter does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call ClickMeter API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the ClickMeter v2 API use?
The ClickMeter v2 API uses API key authentication. The key is passed in the X-Clickmeter-AuthKey header on every request. Jentic stores the key encrypted in its vault and injects it at execution time, so agents never see the raw value.
Can I pull aggregated click statistics with the ClickMeter v2 API?
Yes. GET /aggregated returns account-wide stats for a timeframe and GET /aggregated/list returns the same data grouped by time bucket. /aggregated/summary/datapoints, /aggregated/summary/groups, and /aggregated/summary/conversions provide segmented breakdowns.
What are the rate limits for the ClickMeter v2 API?
Rate limits are not declared in this OpenAPI spec. ClickMeter applies plan-based throttling on its hosted service - confirm your plan limits before issuing high-volume polls of /clickstream or /aggregated. Through Jentic, throttle responses surface as standard error objects an agent can retry against.
How do I link a conversion to multiple datapoints through Jentic?
Run pip install jentic, then search Jentic for 'log a conversion against multiple links' to find PUT /conversions/{conversionId}/datapoints/batch/patch. Load the operation, supply the conversion ID and the array of datapoint IDs, and execute. Jentic injects the X-Clickmeter-AuthKey header from the vault.
Can I share campaign reports with a client using guest permissions?
Yes. POST /account/guests creates a guest user, then POST /account/guests/{guestId}/{type}/permissions/patch grants per-object access to specific datapoints, groups, or conversions. This lets agencies share scoped reporting without exposing the full account.
Can I limit what my agent is allowed to do with the ClickMeter API?
Yes. Because you self-host Jentic One, your own rules decide which ClickMeter operations and credentials the agent may call, so you can grant only the endpoints a task needs, such as GET /aggregated for reporting or POST /conversions for logging a conversion. Account-level operations like creating guest users with POST /account/guests or whitelisting a redirect domain with POST /account/domainwhitelist stay off the allowed set unless you add them. Since most writes are driven from the request body, restricting the operation set is what keeps the agent inside its intended scope.
GET STARTED