Nimble creator finder for Omni AI

The agent returns only creators it checked on their own profile

Omni AI sends the agent a campaign brief. The agent then runs web searches to find candidate creators. It then opens each candidate's TikTok, Instagram or YouTube profile and checks the brief's rules on that page.

Each creator passes four checks on its own profile

A candidate who fails a check goes to the excluded list with the reason. Directories and rankings help the agent find candidates. The agent never takes a follower count or a post from them.

The agent returns four sections

The agent looks for candidates in five kinds of sources

Call the agent by name with the brief as input

The agent stores its own instructions and output schema. A call from Omni AI therefore carries the agent's name and the brief. Each run returns a run ID that Omni AI polls until the run completes.

// Tool: nimble_agents_run. Leave skill and output_schema out: the agent stores both.
{
  "agent_name": "omni_creator_finder",
  "input": "Find 5 US TikTok beauty and cosmetics creators with between 500,000 and 1,000,000 followers who posted on or after 2026-09-06."
}
// Then poll nimble_agents_run_status with the returned run id,
// and read the creators with nimble_agents_run_result.

# 1. Start a run
curl -X POST https://sdk.nimbleway.com/v2/agents/runs \
  -H "Authorization: Bearer $NIMBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "omni_creator_finder",
    "input": "Find 5 US TikTok beauty and cosmetics creators with between 500,000 and 1,000,000 followers who posted on or after 2026-09-06."
  }'
# The response holds the run "id" and the "web_search_agent_id".

# 2. Poll until "status" is "completed"
curl https://sdk.nimbleway.com/v2/agents/$AGENT_ID/runs/$RUN_ID \
  -H "Authorization: Bearer $NIMBLE_API_KEY"

# 3. Read the result: output.content holds brief, creators, excluded and sources
curl https://sdk.nimbleway.com/v2/agents/$AGENT_ID/runs/$RUN_ID/result \
  -H "Authorization: Bearer $NIMBLE_API_KEY"

import os, time, requests

BASE = "https://sdk.nimbleway.com/v2"
H = {"Authorization": f"Bearer {os.environ['NIMBLE_API_KEY']}"}

run = requests.post(f"{BASE}/agents/runs", headers=H, json={
    "agent_name": "omni_creator_finder",
    "input": brief,                 # the campaign brief, nothing else
}).json()
agent_id, run_id = run["web_search_agent_id"], run["id"]

while requests.get(f"{BASE}/agents/{agent_id}/runs/{run_id}", headers=H).json()["status"] not in ("completed", "failed"):
    time.sleep(30)

out = requests.get(f"{BASE}/agents/{agent_id}/runs/{run_id}/result", headers=H).json()
creators = out["output"]["content"]["creators"]

Agent configuration

The instructions and the output schema below are stored on the agent. They are here for reference.

Give every brief a niche, platforms, market, follower range and date

The agent checks each creator against the values in the brief. A brief without a follower range lets very large accounts through. A brief without a date lets inactive accounts through.

Template
Find {count} {market} {platforms} creators focused on {niche} with between {floor} and {cap} followers who posted on or after {YYYY-MM-DD}.

Example
Find 5 US TikTok or Instagram creators focused on sneaker culture (reviews, styling, drops) with between 50,000 and 500,000 followers who posted on or after 2026-09-06.

Practices for running the agent

What the agent does not return yet

27 creators passed every check across 6 briefs

We ran six test briefs through the agent. We then read each returned follower count again with a separate Nimble call. Every second read matched the agent's count within 10%.