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
- Search TikTok accounts
tiktok.search.users - Search Instagram accounts
instagram.search.users - Search Threads accounts
threads.search.profiles - Search company pages on the business network
linkedin.search.companies - Read each Instagram profile
instagram.user.profile - Read each Threads profile
threads.user.profile - Read their websites for emails and check them
companies.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.
- Step 1Search TikTok accounts
tiktok.search.users - Step 2Search Instagram accounts
instagram.search.users - Step 3Search Threads accounts
threads.search.profiles - Step 4Search company pages on the business network
linkedin.search.companies - Step 5Read each Instagram profile
instagram.user.profile - Step 6Read each Threads profile
threads.user.profile - Step 7Read their websites for emails and check them
companies.emails.from_website
For developers
- Recipe id
social-accounts- Inputs
what: the kind of business, in the words the businesses usewhere: a town or a regionplatforms(optional): tiktok, instagram, threads, linkedin or all; tiktok unless givensince(optional): started on or after this year or day, YYYY or YYYY-MM-DD; TikTok onlyunder(optional): keep those with fewer followers than thiscount(optional): how many to look through on each platform, 1 to 100emails(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