feesz
// API · v2 stable

The FEESZ API.

A fully-typed REST API to integrate content intelligence with your existing stack. Official SDKs in JavaScript, Python and Go cover authentication, retries, pagination and pagination-aware streaming out of the box, while webhooks deliver real-time events the moment FEESZ detects new matches, claims, takedowns or revenue postings. The API surface mirrors the product itself — Discovery, MediaTrack, YouTube Monetization, Content Protection and Royalties — so anything you can do in the FEESZ console you can also do programmatically. Documentation is versioned, with deprecation windows of at least twelve months for breaking changes and a public changelog for everything else. Sandbox credentials are issued on request, and our engineering team is available in a shared channel for production integrations. Build operational dashboards, automate enforcement playbooks, pipe matched UGC into your CMS, or stream royalty events into your finance system — the API is designed to be the connective tissue of a modern rights operation.

Introduction

The FEESZ API is organized around REST principles, with predictable resource-oriented URLs, JSON request and response bodies, and standard HTTP response codes. The current stable version is v2 and lives at https://api.feesz.com.

curl https://api.feesz.com/v2/assets \
  -H "Authorization: Bearer $FEESZ_API_KEY" \
  -H "Accept: application/json"

Authentication

FEESZ authenticates API requests using API keys. Each workspace can hold up to 25 active keys with scoped permissions. All requests must be made over HTTPS and include your key in the Authorization header.

  • Test keys begin with fk_test_…
  • Live keys begin with fk_live_…
  • Per-key rate limits range from 60 rpm (Starter) to 6 000 rpm (Enterprise)

Assets API

The Assets resource represents content that you want FEESZ to monitor and protect — videos, live broadcasts, audio works, photo collections or branded clips.

curl https://api.feesz.com/v2/assets \
  -H "Authorization: Bearer $FEESZ_API_KEY" \
  -H "Accept: application/json"

Matches API

A Match represents a piece of content found in the wild that fingerprints against one of your assets. Matches carry a confidence score, the source platform, the URL and a full evidence package suitable for legal action.

curl https://api.feesz.com/v2/matches/mat_8s2nq1Lp \
  -H "Authorization: Bearer $FEESZ_API_KEY"

Claims API

Claims attach a policy to a match: monetize (collect royalties), block (take it down), or track (measure only).

curl -X POST https://api.feesz.com/v2/claims \
  -H "Authorization: Bearer $FEESZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "match_id": "mat_8s2nq1Lp", "policy": "monetize" }'

Webhooks

Subscribe to real-time events such as match.detected, claim.applied and takedown.fulfilled. Each delivery is signed with HMAC-SHA-256 so you can verify authenticity.

Endpoint reference

  • GET/v2/assets
  • POST/v2/assets
  • GET/v2/assets/{id}
  • GET/v2/matches
  • GET/v2/matches/{id}
  • POST/v2/claims
  • POST/v2/takedowns
  • GET/v2/reports/social