REST API · Structure

Get an ad set template

What a launch copying this ad set would take (targeting, event, bid, budget)

GEThttps://api.apogee.ad/api/v1/adsets/{id}/template

Request

GET /adsets/{id}/template on https://api.apogee.ad/api/v1.

Authorization string header required

Bearer apk_…: an API key with the scope of this route.

200.

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors are application/problem+json with a stable code to switch on (all the codes).

Status	Possible codes
400 Bad request	`idempotency_key_required`, `not_supported`, `request_refused`, `validation_failed`
401 Unauthorized	`invalid_api_key`
403 Forbidden	`account_not_connected`, `forbidden`, `insufficient_scope`, `meta_permission_denied`, `platform_permission_denied`, `upgrade_required`
404 Not found	`not_found`
412 Precondition failed	`drive_not_connected`, `meta_not_connected`, `platform_not_connected`
429 Too many requests	`daily_read_cap`, `meta_rate_limited`, `platform_rate_limited`, `quota_exceeded`, `rate_limited`
500 Internal server error	`internal_error`
502 Bad gateway	`drive_error`, `launch_failed`, `meta_error`, `platform_error`, `upstream_error`

With your key in APOGEE_API_KEY (create one):

Request

curl 'https://api.apogee.ad/api/v1/adsets/120200000000000001/template' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

Response 200 (shape)

{}

Plans	Pro and Scale.
Scope	`read` (scopes).
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits).
Rate limit	Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits).
Meta budget	Reads Meta: spends 1 unit of the account's Meta budget (1,800 per 15 minutes, 900 per ad account).
Daily cap	Counts 1 unit toward the 2,000 units one API key can use in 24 hours.

An AI assistant does the same with this tool of the MCP server:

get_templates: What a copy would take: from an ad set its targeting, event, bid and budget; from an ad its page, Instagram, texts, URL and call to action.