Skip to main content

​
1) Set Your Base URL

Set your base URL to your deployment origin: 
export MOSAIC_ADS_BASE_URL="https://api.mosaic.dev"

​
2) Set Your API Key

export MOSAIC_ADS_API_KEY="sk_..."

​
3) Validate Your Key

curl -s \
  -H "X-API-Key: $MOSAIC_ADS_API_KEY" \
  "$MOSAIC_ADS_BASE_URL/v1/ads/me" | jq

​
4) List Ads (Fast Summary Payload)

curl -s \
  -H "X-API-Key: $MOSAIC_ADS_API_KEY" \
  "$MOSAIC_ADS_BASE_URL/v1/ads?limit=25" | jq

​
5) Follow Pagination

Responses include pagination.cursor and next_page_url when there is another page. 
next=$(curl -s \
  -H "X-API-Key: $MOSAIC_ADS_API_KEY" \
  "$MOSAIC_ADS_BASE_URL/v1/ads?limit=50" | jq -r .next_page_url)

curl -s -H "X-API-Key: $MOSAIC_ADS_API_KEY" "$next" | jq

​
6) Fetch One Ad (Full Object)

curl -s \
  -H "X-API-Key: $MOSAIC_ADS_API_KEY" \
  "$MOSAIC_ADS_BASE_URL/v1/ads/123456789" | jq