curl --request GET \
--url https://dashboard.launchpointhq.com/api/v1/payouts/spend \
--header 'x-api-key: <api-key>'import requests
url = "https://dashboard.launchpointhq.com/api/v1/payouts/spend"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://dashboard.launchpointhq.com/api/v1/payouts/spend', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dashboard.launchpointhq.com/api/v1/payouts/spend",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dashboard.launchpointhq.com/api/v1/payouts/spend"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dashboard.launchpointhq.com/api/v1/payouts/spend")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dashboard.launchpointhq.com/api/v1/payouts/spend")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"programId": "<string>",
"programName": "<string>",
"status": "draft",
"kind": "<string>",
"currency": "usd",
"spend": 123,
"spendCents": 123,
"deliverySpend": 123,
"deliverySpendCents": 123,
"adRoyaltySpend": 123,
"adRoyaltySpendCents": 123,
"undatedSpend": 123,
"undatedSpendCents": 123,
"paid": 123,
"paidCents": 123,
"paidOffPlatform": 123,
"paidOffPlatformCents": 123,
"awaiting": 123,
"awaitingCents": 123,
"tracking": 123,
"trackingCents": 123
}
],
"page": 123,
"limit": 123,
"total": 123,
"totalPages": 123,
"fromDate": "<string>",
"toDate": "<string>",
"timeZone": "America/New_York",
"summary": {
"programCount": 123,
"currency": "usd",
"spend": 123,
"spendCents": 123,
"deliverySpend": 123,
"deliverySpendCents": 123,
"adRoyaltySpend": 123,
"adRoyaltySpendCents": 123,
"undatedSpend": 123,
"undatedSpendCents": 123,
"paid": 123,
"paidCents": 123,
"paidOffPlatform": 123,
"paidOffPlatformCents": 123,
"awaiting": 123,
"awaitingCents": 123,
"tracking": 123,
"trackingCents": 123
}
}Report spend per program
What each visible program cost you through Launchpoint: one row for each program, sorted by spend. Pass programId to report one program.
spend is deliverySpend plus adRoyaltySpend:
deliverySpendis the price of the program’s delivery. Under a signed CPM contract it is the delivered views at the contract CPM. Without a CPM contract it is creator cost plus your platform fee (your take rate). For an Ads program it is the cost of sourcing creators plus that fee.adRoyaltySpendis the royalty fee of the ads that run the program’s media. It already contains the creator share thatGET /programs/{programId}/adsreports, so do not add that share again. Money you pay the ad platform is not included.
Views past a contract’s commitment keep the price of the last contract; the commitment does not cap spend. This is the cost of delivery, not a record of cash payments or wallet debits. Use spend or spendCents, not both: each amount is returned in dollars and in cents.
Do not add an Ads program to an organic program. Each row has kind. Organic delivery and Ads sourcing are different purchases. summary covers every program in the report, not only the current page. Its spend amounts are null when the report has an Ads program and a program of another kind; sum the rows of one kind instead.
Creator pay. paid, paidOffPlatform, awaiting, and tracking are what the program’s creators earned. If you pay a platform fee on creator pay, this money is the cost inside deliverySpend. Never add it to spend, and do not add your own direct creator payments either: paidOffPlatform is already inside. These fields are null if you have a CPM, fixed-fee, or itemized contract with Launchpoint, because you pay the contract price, not creator pay.
Date ranges. fromDate and toDate include both days and are New York days (timeZone). Without them the report covers all time.
deliverySpendcovers the views that occurred on those days. Under a CPM contract each view is charged on the day it occurred, at the rate of the contract that took it, so ranges that touch add up to the all-time amount. Without a contract, the program’s charge is spread over its view days in proportion to views.adRoyaltySpendcovers the ad delivery of those days.- For an Ads program, sourcing cost uses the publish day of the post it pays for.
undatedSpendis delivery that has no day. It is in no date range. It is part ofdeliverySpendandspendonly when you set no dates.- The creator pay fields select posts by their publish day.
Changed. Before this version, a date range selected posts by their publish day and counted all their spend. It now counts the delivery of the days in the range.
Before you compute a cost per customer. Spend is counted on the day the views occurred, and a purchase can follow days later. Use a range that ended at least as long ago as your usual time from view to purchase. A contract with a CPM range can change the amount of past days while that contract is still in progress, because its rate follows creator cost. Amounts can also change as views and earnings update.
This is different from GET /payouts, which lists money that left your own wallet.
curl --request GET \
--url https://dashboard.launchpointhq.com/api/v1/payouts/spend \
--header 'x-api-key: <api-key>'import requests
url = "https://dashboard.launchpointhq.com/api/v1/payouts/spend"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://dashboard.launchpointhq.com/api/v1/payouts/spend', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dashboard.launchpointhq.com/api/v1/payouts/spend",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dashboard.launchpointhq.com/api/v1/payouts/spend"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dashboard.launchpointhq.com/api/v1/payouts/spend")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dashboard.launchpointhq.com/api/v1/payouts/spend")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"programId": "<string>",
"programName": "<string>",
"status": "draft",
"kind": "<string>",
"currency": "usd",
"spend": 123,
"spendCents": 123,
"deliverySpend": 123,
"deliverySpendCents": 123,
"adRoyaltySpend": 123,
"adRoyaltySpendCents": 123,
"undatedSpend": 123,
"undatedSpendCents": 123,
"paid": 123,
"paidCents": 123,
"paidOffPlatform": 123,
"paidOffPlatformCents": 123,
"awaiting": 123,
"awaitingCents": 123,
"tracking": 123,
"trackingCents": 123
}
],
"page": 123,
"limit": 123,
"total": 123,
"totalPages": 123,
"fromDate": "<string>",
"toDate": "<string>",
"timeZone": "America/New_York",
"summary": {
"programCount": 123,
"currency": "usd",
"spend": 123,
"spendCents": 123,
"deliverySpend": 123,
"deliverySpendCents": 123,
"adRoyaltySpend": 123,
"adRoyaltySpendCents": 123,
"undatedSpend": 123,
"undatedSpendCents": 123,
"paid": 123,
"paidCents": 123,
"paidOffPlatform": 123,
"paidOffPlatformCents": 123,
"awaiting": 123,
"awaitingCents": 123,
"tracking": 123,
"trackingCents": 123
}
}Query Parameters
Response
Program spend returned successfully