Ads

Create or return an ad share URL

Creates or returns the existing Trendtrack public webapp share URL for an ad. This is classified as a workspace-scoped write because it creates share state server-side when needed; delegated OAuth/API-key callers must be workspace writers.

post/v1/ads/{adId}/share

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/ads/{adId}/share
  • Auth: HTTP bearer

Path parameters

adIdstring required
Example:facebook_123456789

Trendtrack ad identifier returned as adId by the Public API.

Response

Public ad share URL response. The response also includes the X-Request-Id header.

requestIdstring required

Request identifier mirrored in the X-Request-Id response header.

Example response

{
  "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
  "data": {
    "adId": "facebook_123456789",
    "id": "3f8aa146-6f96-46e8-9781-64db5166f9a8",
    "slug": "example-brand-9a8b7c",
    "shareUrl": "https://app.trendtrack.io/share/ads/example-brand-9a8b7c",
    "sharePath": "/share/ads/example-brand-9a8b7c",
    "createdAt": "2026-04-18T12:30:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.