Credit Efficiency

Credits are debited before a tool runs and aren’t returned afterwards, so a 30-credit employee search that finds nothing useful is 30 credits spent. Here are the patterns that compound.

Qualify before you prospect

Running list_linkedin_company_employees (30 credits) on a company with no buying signal is the most expensive mistake in this stack. Always front-load detect_signal (free dispatch, ~15 credits median) and skip accounts that don’t fire.

Bad:  list_linkedin_company_employees × 100 accounts = 3,000 credits ($30)
Good: detect_signal × 100 + list_linkedin_company_employees × 20 qualified = ~2,100 credits ($21)

The savings grow as your hit rate drops. At a 10% qualification rate, you save 60%+.

Set signal order to short-circuit

If you can act on the first signal that fires, configure set_signals_order to put the highest-precision detectors first. Then break out of the loop in your code as soon as one fires. detect_signal won’t help you here, but the individual detectors will.

1
// Run the ordered list; stop at the first hit
2
const order = (await call("signals", "get_signals_order")).order;
3
for (const sig of order) {
4
  const result = await call("signals", sig, { domain });
5
  if (result.fired) {
6
    return { domain, signal: sig, evidence: result.evidence };
7
  }
8
}
9
return { domain, signal: null };

In a 5-detector run where the first one hits, you spent 5 credits instead of 25.

Use filters, not pagination

list_linkedin_company_employees charges 30 credits regardless of limit or page. The cost is the search itself, not the row count.

• Always pass title_filters. Empty filters return everyone, and you’ll usually scroll past the right person.
• Use boolean syntax (AND, OR, NOT, ()) to narrow precisely.
• Set limit to what you actually want to look at. It doesn’t reduce cost, but it reduces noise.

Avoid the 80-credit tool unless you need it

list_linkedin_company_employees_posts (80 credits) fans out across the whole employee list. Use it only when:

• You’re tracking a small set of accounts and want a full activity feed.
• You’ve exhausted cheaper alternatives.

Cheaper alternatives:

5 known employees costs 25 credits instead of 80 if you already know the profile URLs.

Cache profile lookups

get_linkedin_profile_url (5) and get_linkedin_profile (2) return stable data. Cache the URL → profile mapping per org. The CLI doesn’t do this automatically, but a few minutes of caching in your code saves a lot of credits on repeated runs.

Don’t double-check

Watch your invoices

list_invoices shows top-ups and charges. Audit weekly to spot drift: a misconfigured loop calling list_linkedin_company_employees_posts in a tight retry can burn through $50 fast.

Credit budget cheat sheet

Next steps