Skip to content

Ready job

Creators on a topic, and who is breaking out

The creators posting about one topic now on YouTube, TikTok and Instagram, each with its video against the channel's usual views, a check of the video, a business contact when the channel shows one and a first message to send.

10 single lookups

The lookups it runs

  1. Search this topic's YouTube videosyoutube.search.videos
  2. Search this topic's TikTok videostiktok.search.videos
  3. Search this topic's Instagram reelsinstagram.search.reels
  4. Read each YouTube channelyoutube.channel.profile
  5. Read each TikTok profiletiktok.user.profile
  6. Read each Instagram profileinstagram.user.profile
  7. Compare with its recent YouTube uploadsyoutube.channel.videos
  8. Compare with its recent TikTok videostiktok.user.videos
  9. Compare with its recent Instagram reelsinstagram.user.reels
  10. Check each YouTube video itselfyoutube.video.detail

What it gives.One table, one run.

You get a table: platform, creator, subscribers or followers, the video and its views, the channel's usual views, how the video stands against them, how many recent uploads did the same, likes per 100 views, any paid mention in the description, a contact where the channel shows one, and a first message.

Use Ahel to find <count> creators on each of <platforms> posting about <topic>. Compare each one's video with the channel's usual views, check the video for paid mentions, give me a business contact where the channel shows one, and write a first message with my offer: <pitch>.

Paste this into ChatGPT or Claude connected to Ahel.

What you give

topic
what the videos are about
platformsoptional
youtube, tiktok, instagram, or all; all unless given
countoptional
how many creators on each platform, 1 to 25
pitchoptional
your offer in one line, for the first message

The lookups.Run in this order.

  1. Step 1Search this topic's YouTube videosyoutube.search.videos
  2. Step 2Search this topic's TikTok videostiktok.search.videos
  3. Step 3Search this topic's Instagram reelsinstagram.search.reels
  4. Step 4Read each YouTube channelyoutube.channel.profile
  5. Step 5Read each TikTok profiletiktok.user.profile
  6. Step 6Read each Instagram profileinstagram.user.profile
  7. Step 7Compare with its recent YouTube uploadsyoutube.channel.videos
  8. Step 8Compare with its recent TikTok videostiktok.user.videos
  9. Step 9Compare with its recent Instagram reelsinstagram.user.reels
  10. Step 10Check each YouTube video itselfyoutube.video.detail

In YouTube, TikTok and Meta.

For developers
Recipe id
find-creators
Inputs
  • topic: what the videos are about
  • platforms (optional): youtube, tiktok, instagram, or all; all unless given
  • count (optional): how many creators on each platform, 1 to 25
  • pitch (optional): your offer in one line, for the first message
HTTP call
curl -s https://ahel.ai/api/platform/v2/recipes/find-creators/runs \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"topic":"<topic>"},"max_cost_usd":"<your cap>"}'

Send it without max_cost_usd first. Nothing runs without it.

On a schedule
curl -s https://ahel.ai/api/platform/v2/recipes/find-creators/schedules \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"topic":"<topic>"},"max_cost_usd":"<cap per run>","every":"day","webhook_url":"https://<your server>/ahel","run_now":true}'

Each finished run is posted to webhook_url as JSON. To check it is from Ahel, read X-Ahel-Signature: t=<unix seconds>,v1=<hex>. v1 must equal the hex HMAC-SHA256 of "<t>.<raw body>", keyed with the signing_secret the call answered, whsec_ included. Refuse a t more than 5 minutes off. Answer 2xx within 10 seconds.

API reference