# Browse tracked accounts
Source: https://docs.launchpointhq.com/api-reference/v1/analytics/browse-tracked-accounts

/api-reference/openapi.json get /analytics/accounts
Get tracked social media accounts with aggregated analytics.

Posts are grouped by social handle and platform, with metrics for each account.

Agency accounts can pass `scope=agency` to combine accounts from the
parent agency and every subaccount.




# Browse tracked videos and analytics
Source: https://docs.launchpointhq.com/api-reference/v1/analytics/browse-tracked-videos-and-analytics

/api-reference/openapi.json get /analytics/videos
Get tracked videos/posts with analytics and filters.

Each video includes engagement metrics, sorting, and detailed statistics.

Agency accounts can pass `scope=agency` to combine tracked videos from the
parent agency and every subaccount.




# View analytics overview
Source: https://docs.launchpointhq.com/api-reference/v1/analytics/view-analytics-overview

/api-reference/openapi.json get /analytics/overview
Get analytics with filtering support.

Like the /overall page in the web app, this endpoint returns:
- Summary metrics
- Top performing posts
- Top performing creators
- Platform breakdown

When `fromDate` and/or `toDate` are provided, `summary` follows the same
activity attribution model as the dashboard Performance Overview chart:
- daily deltas from post `daily` stats
- first-stat totals attributed back to the upload date
- posts without daily stats attributed to their upload date

`snapshotSummary`, `topPosts`, `topCreators`, and `platformBreakdown`
stay as upload-date snapshot views, matching the `/overall` page tables.

Agency accounts can pass `scope=agency` to calculate the overview across
the parent agency and every subaccount.




# View daily recruitment outreach analytics
Source: https://docs.launchpointhq.com/api-reference/v1/analytics/view-daily-recruitment-outreach-analytics

/api-reference/openapi.json get /analytics/recruitment
Get daily totals for sent recruitment invites and candidate responses.

Dates are grouped by UTC day in `YYYY-MM-DD` format.

Agency accounts can pass `scope=agency` to combine recruitment outreach
from the parent agency and every subaccount.




# View key KPIs
Source: https://docs.launchpointhq.com/api-reference/v1/analytics/view-key-kpis

/api-reference/openapi.json get /analytics/kpis
Get key performance indicators grouped by status.

The response includes:
- Programs (by status: active, draft, paused, etc.)
- Contracts (by status: active, pending, completed, etc.)
- Posts (total, views, engagement, paid/unpaid)
- Creators (total, with active contracts)

Agency accounts can pass `scope=agency` to calculate KPIs across the
parent agency and every subaccount.




# Browse contracts
Source: https://docs.launchpointhq.com/api-reference/v1/contracts/browse-contracts

/api-reference/openapi.json get /contracts
Get offer-level creator contract metadata with sensitive payment details hidden.

Contracts describe the relationship between your company and creators, but this endpoint does not include Canvas weekly pay, task-level terms, or every pay term. Use `/pay-structures` for creator and program pay terms.




# Browse creator collections
Source: https://docs.launchpointhq.com/api-reference/v1/creators/browse-creator-collections

/api-reference/openapi.json get /creators/collections
Get the creator collections (saved account groups) for the
authenticated company.




# Browse creators
Source: https://docs.launchpointhq.com/api-reference/v1/creators/browse-creators

/api-reference/openapi.json get /creators
Get creators associated with your company, along with a contract status map for each campaign.
Use this to see which creators are active across your campaigns. Each creator has a
`phone` number, which is `null` when no number is on file or while your creator access is locked.
Creator email addresses are never returned.

The `campaigns` array lists every program a creator is or was contracted under,
along with its contract status. A creator's top-level `status` is `"active"` when they
have at least one active contract; otherwise, it is `"inactive"`.

Ghost-handle contracts are excluded.




# View creator audience demographics
Source: https://docs.launchpointhq.com/api-reference/v1/creators/view-creator-audience-demographics

/api-reference/openapi.json get /creators/{id}/audience
Get saved audience demographics for each linked social account of a visible creator.

Percentages use a `0` to `100` scale, including `usAudiencePercentage`. Audience data can be up to about 30 days old; `lastUpdatedAt` is a Unix timestamp in milliseconds for the newest data in that account block. `countries` comes from the monthly country refresh when available and falls back to the Instagram account's own country split otherwise. `usAudiencePercentage` is populated only from the monthly country refresh, so null does not mean the US share is zero. A saved no-data marker can return `0`; that does not prove the US share is zero. `reason` is set only when the entire audience block has no data. When country data is missing but age, gender, or city data exists, `countriesReason` describes the missing country data instead.

The `instagramAudiences` entries expose separate populations Meta reports: people reached, people who engaged, and followers. These are different sets of people, so do not add them together.

The possible no-data reasons are `unsupported_platform`, `no_data_marker`, and `never_fetched`. A creator the API key cannot see returns `404`.




# Browse creator pay structures
Source: https://docs.launchpointhq.com/api-reference/v1/payouts/browse-creator-pay-structures

/api-reference/openapi.json get /pay-structures
Get the pay terms for each visible creator and program.

This endpoint includes offer-level cash terms and active Canvas payscales. `baseRateCents` contains cash entries only. Manual and Shopify entries are returned separately in `nonCashBaseRateEntries` with their `valueCents`; a product seed is not cash. `platformRatios: null` means there is no platform split. In the Canvas `assigned` block, `assignment: "explicit"` means the creator really resolves to that payscale group. `assignment: "campaign_default"` covers both a creator who was never assigned and a creator whose assigned group no longer exists; `assignedAt` is epoch milliseconds for an explicit assignment and is null for `campaign_default`.




# View payout wallet statistics
Source: https://docs.launchpointhq.com/api-reference/v1/payouts/view-payout-wallet-statistics

/api-reference/openapi.json get /payouts/stats
Read-only summary of your company's payout wallet balances and lifetime activity.

These are the same metrics shown on the payouts dashboard:
- **Available balance** — funds ready to pay creators
- **Pending balance** — incoming top-ups still processing
- **Total owed** — calculated amount owed across active contracts
- **Lifetime deposits** — total confirmed wallet top-ups
- **Lifetime paid out** — total confirmed payouts to creators

All amounts are in USD dollars.




# View pending payouts
Source: https://docs.launchpointhq.com/api-reference/v1/payouts/view-pending-payouts

/api-reference/openapi.json get /payouts/pending
Get money currently held for creators in the payout reserve.

This is money already held for payment, not every unpaid creator amount or a complete list of pay terms. Use `/pay-structures` for creator and program pay terms.




# View wallet activity
Source: https://docs.launchpointhq.com/api-reference/v1/payouts/view-wallet-activity

/api-reference/openapi.json get /payouts
Read-only view of your company's wallet ledger entries.

The ledger lists wallet credits and debits, including:
- Payouts to creators
- Adjustments
- Refunds

**Note:** The API does not support executing payouts for security reasons.




# Browse posts
Source: https://docs.launchpointhq.com/api-reference/v1/posts/browse-posts

/api-reference/openapi.json get /posts
Get social media posts with detailed filters.

Filter posts by program, platform, creator, date range, and more.
Results contain engagement metrics (views, likes, comments, etc.).

Agency accounts can pass `scope=agency` to return posts from the parent
agency and every subaccount in one request.




# Download posts as CSV
Source: https://docs.launchpointhq.com/api-reference/v1/posts/download-posts-as-csv

/api-reference/openapi.json post /posts/export
Create and download a CSV file containing posts.

The response streams all post data, including metrics, as CSV.




# View post details
Source: https://docs.launchpointhq.com/api-reference/v1/posts/view-post-details

/api-reference/openapi.json get /posts/{id}
Get full details for one post/video.

The response includes metrics, engagement data, payment status, and related contract/program information.




# View post insights
Source: https://docs.launchpointhq.com/api-reference/v1/posts/view-post-insights

/api-reference/openapi.json get /posts/{id}/insights
Get the latest stored Instagram performance and Reel watch metrics for one post.

`insights.status` and `insights.reason` are paired: `available` with `reason: null` means a post snapshot exists; `no_data` with `reason: never_fetched` means no post snapshot exists; and `no_data` with `reason: unsupported_platform` means the post is not Instagram.

`creatorAudience` is account-level audience data for the account that published the post. Its handle follows the same PII lock as the creator audience endpoint. It is not the geography of people who watched this video: Meta does not expose per-post country data at any access level. Instagram audience entries describe separate populations reported by Meta and should not be added together. Non-Instagram posts return `no_data` with `reason: unsupported_platform` instead of invented metrics.




# View post metrics history
Source: https://docs.launchpointhq.com/api-reference/v1/posts/view-post-metrics-history

/api-reference/openapi.json get /posts/{id}/metrics-history
Get daily historical metrics for one post/video.

See how views, likes, comments, and other metrics changed over time.




# Browse programs
Source: https://docs.launchpointhq.com/api-reference/v1/programs/browse-programs

/api-reference/openapi.json get /programs
Get your company's programs with pagination and filters.

Programs are campaigns or marketing initiatives that creators take part in.




# Create a program invite link
Source: https://docs.launchpointhq.com/api-reference/v1/programs/create-a-program-invite-link

/api-reference/openapi.json post /programs/{id}/invite
Create a shareable invite link for a program.

Creators can join the program directly through this link.




# Make your first API request
Source: https://docs.launchpointhq.com/index

Generate a Launchpoint API key and pull your first program in a couple of minutes.

<Note>
  **The Launchpoint Public API is in private preview.** Availability is limited to trusted partners we work with directly. There is no self-serve signup; access is reviewed case by case. To ask about access, email [Launchpoint support](mailto:hi@launchpointhq.com).
</Note>

All you need is an enabled Launchpoint account, an API key, and a server that can hold that key privately.

<Steps>
  <Step title="Create an API key">
    Go to [Dashboard → Settings → API](https://dashboard.launchpointhq.com/settings#api) and generate a key.

    Your company needs API access turned on first. While the API stays in private preview, the API section is hidden for most companies and enabled only for trusted partners. If it is not there, email [Launchpoint support](mailto:hi@launchpointhq.com) to ask about access.

    <Warning>
      Copy the key at creation time. Never place it in browser code, mobile apps, logs, or source control.
    </Warning>
  </Step>

  <Step title="Store the key on your server">
    Set the key in your server environment:

    ```bash theme={null}
    export LAUNCHPOINT_API_KEY="lp_pk_..."
    ```
  </Step>

  <Step title="Fetch your programs">
    Pass the key through the `x-api-key` header:

    <CodeGroup>
      ```bash cURL theme={null}
      curl "https://dashboard.launchpointhq.com/api/v1/programs" \
        --header "x-api-key: $LAUNCHPOINT_API_KEY"
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch(
        "https://dashboard.launchpointhq.com/api/v1/programs",
        {
          headers: {
            "x-api-key": process.env.LAUNCHPOINT_API_KEY,
          },
        },
      );

      if (!response.ok) {
        throw new Error(`Launchpoint API returned ${response.status}`);
      }

      const programs = await response.json();
      ```
    </CodeGroup>
  </Step>
</Steps>

## Read the response

A list request that succeeds comes back with `data`, `page`, and `total`:

```json theme={null}
{
  "data": [],
  "page": 1,
  "total": 0
}
```

The `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers are attached to every response.

## Use company or agency scope

Any route that supports `scope` defaults to `scope=company`, which returns data belonging to the API key's company only.

A parent agency may send `scope=agency` to cover its own data plus the data of linked brands. Every other key gets a `403` for that scope.

## Creator privacy

Creator email addresses are never present in API responses.

`GET /creators` does return a creator `phone`. That field is `null` when there is no number on file, and `null` across all creators whenever your creator access is locked, which happens once your wallet balance drops below the minimum.

## Stay within the rate limit

Each API key gets 100 requests per minute by default, and approved partner accounts get 400 per minute. Anything beyond the limit returns `429`.

## Handle each error status

Errors come back in this shape:

```json theme={null}
{ "error": "Invalid request" }
```

A `code` is included on some errors.

| Status | Meaning                                                                |
| ------ | ---------------------------------------------------------------------- |
| `400`  | A required value is missing, or a supplied value is invalid.           |
| `401`  | No API key was sent, or the key is invalid.                            |
| `402`  | API access or the company's payment setup is not in place yet.         |
| `403`  | The key is not allowed to reach the requested company or agency scope. |
| `404`  | No matching record exists.                                             |
| `429`  | The API key hit its per-minute limit.                                  |
| `500`  | Launchpoint was unable to complete the request.                        |

## Work with timestamps and paging

Unless a field states otherwise, timestamps are Unix timestamps in milliseconds.

Most list endpoints take `page` and `limit`, then return `data`, `page`, and `total`. A few add `totalPages`.

## Pick your next endpoint

Browse the endpoint groups in the sidebar for programs, posts, analytics, payouts, pay structures, creators, audience, and contracts.