Export click id report

The request

Reference for Export click id report, HeadHoncho API v1. It is a read, sent to the base address https://api.headhoncho.app.

GET /api/v1/reports/google-click-ids/export

The key or app needs the Click IDs and conversions area at read. It counts as a export call: 10 a minute for each key or connected app. See rate limits.

Send your key as Authorization: Bearer hh_live_.... See API keys.

Parameters

Name	Kind	Required	Description	Example
`from`	date, in the query	Yes	The first day.	`2026-10-01`
`to`	date, in the query	Yes	The last day, inclusive.	`2026-10-31`
`company_id`	id, in the query	No	For google_ads, the one account the file is for. Default: the first company.	`cmp_14f5`
`output`	text, in the query	No	csv (the agency's fifteen columns, default) or google_ads (the upload file, one company at a time). One of `csv`, `google_ads`.	`csv`

What comes back

Over the API: the file (text/csv). Over MCP: a download link that works once for five minutes.

It never changes a record. It only reads the companies the key reaches. Why this report is in the API: Owner, 2026-10-14: same decision as the report.

Errors that apply

Code	Status	What it means
`missing_key`	401	Send your key as Authorization: Bearer hh_live_...
`unknown_key`	401	That key is not one we issued, or it was revoked.
`expired_token`	401	That token has expired. Refresh it, or connect the app again.
`no_access`	403	This credential does not reach that. Ask the person who made it for access.
`not_found`	404	No such record in the companies this credential reaches.
`out_of_scope`	404	No such company in the companies this credential reaches.
`invalid`	422	Some fields were refused. See fields.
`rate_limited`	429	Too many calls this minute. Wait and try again.

Get job conversion: What this job told the ad platform it was worth: the click it came from, each conversion sent, its value and its basis, and what Google did with it.
Get click id report: The Google Click ID report: one row per job that opened or closed in the range, with its click id, its tracked call, its total and its profit.
The same records in the app: offline conversion tracking.
How the API fits together: the model, API keys, errors and the MCP server.

Answer cURL Python JavaScript Your AI

This is the answer over MCP. Over the API the answer is the file itself, as text/csv.

{
  "download": {
    "url": "https://api.headhoncho.app/api/v1/reports/google-click-ids/export?from=2026-10-01&to=2026-10-31&output=google_ads&company_id=cmp_14f5&once=p2Xw...",
    "expires_in": 300,
    "filename": "google-ads-conversions-20261014-0915.csv"
  }
}

curl "https://api.headhoncho.app/api/v1/reports/google-click-ids/export?from=2026-10-01&to=2026-10-31&company_id=cmp_14f5&output=csv" \
  -H "Authorization: Bearer hh_live_..." -o file.csv

import requests

response = requests.get(
    "https://api.headhoncho.app/api/v1/reports/google-click-ids/export",
    headers={"Authorization": "Bearer hh_live_..."},
    params={
        "from": "2026-10-01",
        "to": "2026-10-31",
        "company_id": "cmp_14f5",
        "output": "csv",
    },
)
response.raise_for_status()
open("file.csv", "wb").write(response.content)

const response = await fetch("https://api.headhoncho.app/api/v1/reports/google-click-ids/export?from=2026-10-01&to=2026-10-31&company_id=cmp_14f5&output=csv", {
  headers: { Authorization: "Bearer hh_live_..." },
});
const data = await response.text();
console.log(data);

Tool: export_click_id_report
Arguments: from (date, required), to (date, required), company_id (id, optional), output (text, optional)
Access: read on Click IDs and conversions
Hints: readOnly=true, destructive=false, idempotent=true, openWorld=false
Try asking: "Using HeadHoncho, export click id report with from 2026-10-01 and to 2026-10-31 and company_id cmp_14f5."

The request

Parameters

What comes back

Errors that apply

Related