Skip to content

Ready job

Businesses on social media, and how they are doing

The accounts of one kind of business in one place on TikTok, Instagram, Threads or the business network, with when each started and how many followers it has.

7 single lookups

The lookups it runs

  1. Search TikTok accountstiktok.search.users
  2. Search Instagram accountsinstagram.search.users
  3. Search Threads accountsthreads.search.profiles
  4. Search company pages on the business networklinkedin.search.companies
  5. Read each Instagram profileinstagram.user.profile
  6. Read each Threads profilethreads.user.profile
  7. Read their websites for emails and check themcompanies.emails.from_website

What it gives.One table, one run.

You get one table: platform, account name, profile link, when it started (TikTok only), followers, posts, and the website where the account links one; emails from that website if you ask.

Use Ahel to find <kind of business, in the local language> in <town> on TikTok and Instagram that started in <year> and have fewer than <500> followers.

Paste this into ChatGPT or Claude connected to Ahel.

What you give

what
the kind of business, in the words the businesses use
where
a town or a region
platformsoptional
tiktok, instagram, threads, linkedin or all; tiktok unless given
sinceoptional
started on or after this year or day, YYYY or YYYY-MM-DD; TikTok only
underoptional
keep those with fewer followers than this
countoptional
how many to look through on each platform, 1 to 100
emailsoptional
yes to read each linked website for emails, no unless given

The lookups.Run in this order.

  1. Step 1Search TikTok accountstiktok.search.users
  2. Step 2Search Instagram accountsinstagram.search.users
  3. Step 3Search Threads accountsthreads.search.profiles
  4. Step 4Search company pages on the business networklinkedin.search.companies
  5. Step 5Read each Instagram profileinstagram.user.profile
  6. Step 6Read each Threads profilethreads.user.profile
  7. Step 7Read their websites for emails and check themcompanies.emails.from_website

In TikTok, Meta and LinkedIn.

For developers
Recipe id
social-accounts
Inputs
  • what: the kind of business, in the words the businesses use
  • where: a town or a region
  • platforms (optional): tiktok, instagram, threads, linkedin or all; tiktok unless given
  • since (optional): started on or after this year or day, YYYY or YYYY-MM-DD; TikTok only
  • under (optional): keep those with fewer followers than this
  • count (optional): how many to look through on each platform, 1 to 100
  • emails (optional): yes to read each linked website for emails, no unless given
HTTP call
curl -s https://ahel.ai/api/platform/v2/recipes/social-accounts/runs \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"what":"<what>","where":"<where>"},"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/social-accounts/schedules \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"what":"<what>","where":"<where>"},"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