Zelf Playbook
Recipes for the Zelf API.
Before you start
- Base URL
https://api.hellozelf.com, with every endpoint under/api/v1/.- Authentication
- Send your key in the
x-api-keyheader on every request. API access has to be enabled on your Zelf account first. - Responses
- Every response uses the same envelope:
{log_id, timestamp, results, item_count, page, next, previous}. A single object comes back as the only item inresults. - Clients
- Every snippet calls an official Zelf client, one per language:
pip install zelf-sdk,npm install zelf-sdk, and the same package for Go, Rust, Ruby and C#. The install line sits above each snippet, and cURL is there for a reader with no client at all. - Reference
- Each step names its operation, so you can find it in the API reference or in the OpenAPI spec, which is the source of truth for every schema. Agents should start at llms.txt.
01
Your first searchFind posts by keyword and read the response.
4 steps5 min02
Complicated searchesOperators, exact date windows, filters and sorting.
5 steps10 min03
Filtering content by dateThe four date parameters, their precedence, and the limits.
8 steps10 min04
Find brands in one videoSearch one video for your brands, by content id or by link.
6 steps10 min05
Find brands in a creator's videosSync a creator, then search each of their videos for your brands.
7 steps20 min06
Run an AI analysis on a search termSize the set, start the run, poll it, read the result.
5 steps15 min07
Vet a creatorCheck a profile against safety criteria before you work with them.
6 steps15 min08
Monitor a brandOwned, tagged and influencer posts, with the totals behind them.
4 steps10 min