Zelf API

The Zelf API provides programmatic access to Zelf's creator and content intelligence. Use it to search the content and creators tracked for your brand, run AI analyses over that content, vet individual creators, and subscribe to webhooks that deliver results as they are produced.

Your first call

Install a client, set your key, and search the content tracked for your brand.

pip install zelf-sdk

export ZELF_API_KEY="<your-api-key>"

Python

import os

from zelf import ZelfAPIClient

client = ZelfAPIClient(api_key=os.environ["ZELF_API_KEY"])

result = client.content.list(
    search="running shoes",
    posted_within_days=30,
)
print(result)

Installation covers every client in full, and Authentication covers issuing a key.

Resources

AI Analysis5
Run AI analyses over content and comments. Start an analysis with a topic and a content filter, poll its runs for status, then fetch each run's result payload from ai_analysis.results.
Analytics2
Compare a brand against its competitors: totals per brand and follower history over time. Every endpoint takes the same brand, platform and date window.
Brands8
The brands (workspaces) an API key can access. Most content endpoints accept a brand_id from here to unlock brand-specific signals like ownership, tagging, and NPS. brands.catalog adds the brands Zelf curates for competitive benchmarking, which every key can read content for.
Comment1
Search, list comments of a content including like count, author information and replies.
Content6
Search, list, and aggregate content (posts, videos, images) across the platforms Zelf tracks. Supports rich filtering by metrics, platform, language, date window, and creator, plus optional brand context.
Creator6
Look up creators and their public profile metrics, and run creator vetting analyses that score safety and brand fit.
Creator Sync3
Add a creator's profile and posts to Zelf so their videos can be searched and analyzed. Syncing is asynchronous: create a sync, poll it until it finishes, then list the creator's videos with content.list.
Detection3
Find brands in social videos. Send a video and a list of brands. Zelf reads the whole video and finds each scene where a brand is identifiable: its logo or name is visible, or the brand is named out loud. Every appearance comes back with its timestamp and what was detected. Detection is asynchronous: create a detection, then poll it for the results.
Engage1
What the brand itself published: the comments it posted, by the kind of content they were posted on, with the likes and replies they drew. Takes the same brand, platform and date window as Analytics.
Usage1
What your brand has spent against its limits, per group and per window, for both direct requests and AI clients. Reading it consumes nothing.
Webhook Management15
Manage webhook subscriptions, signing secrets, test sends, and the delivery log for your brand. Create a subscription to start receiving snapshot or event pushes; the outbound payload shapes are documented under Webhook snapshots and Webhook events.

The schema

Everything on these pages is generated from one OpenAPI 3.1 document. Take it to generate a client of your own, or to point an editor or an agent at the API.

Download OpenAPI (YAML)View it in the browser

Zelf APIs · v1.3.0 · 51 operations