GulfLead AI — v0.3.1 Financial Safe Hotfix

GulfLead AI finds and ranks public local-business leads while applying multiple cost controls before and during every run.

Financial safety added in v0.3

Parent run spending limit

Before calling the paid source Actor, GulfLead AI checks how many paid result events still fit inside the user's maximum run charge.

If zero paid results remain, the source Actor is not started.

Child/source Actor monetary cap

Every call to the internal Google Maps source Actor has its own max_total_charge_usd.

The cap is calculated conservatively and is never allowed to exceed $3.00 in one child run.

Child result cap

The internal source Actor receives a strict max_items value.

This prevents an unexpected large result set from increasing cost.

Child timeout

The internal source Actor receives a 240 second timeout.

A stuck source run cannot continue indefinitely.

No automatic restart

restart_on_error=False is set for the internal Actor call, avoiding an automatic retry that could duplicate cost.

Paid social enrichment disabled

Facebook / Instagram / Twitter / TikTok / YouTube paid profile enrichment is explicitly disabled.

If a public social URL already exists in returned data, GulfLead AI can still display it.

Bounded parent memory

The Actor definition uses:

• default memory: 512 MB
• minimum memory: 256 MB
• maximum memory: 512 MB

The parent Actor does not run a browser, so this keeps compute usage bounded.

Re-check before every paid output

Before each result is pushed, GulfLead AI re-checks the PPE spending limit.

If the limit is reached, it stops immediately.

Important

No cloud application can guarantee zero financial risk.

These controls are designed to prevent:

• unbounded source runs,
• unlimited result generation,
• expensive social enrichment,
• automatic restart loops,
• excessive memory allocation,
• continuing work after the customer spending limit is exhausted.

Before public Store publication, test v0.3 with:

1. normal run,
2. deliberately low maximum charge,
3. query with zero/very few results,
4. 100-result run,
5. Contact Enrichment ON and OFF.

Planned pricing

• Actor start: $0.39
• Result: $0.03 per default-dataset item

Deploy to the existing Actor

apify push o4mhP94xKdui9XHV2

After deployment, do not publish publicly until the financial-safety tests pass.

v0.3.1 hotfix

The source Actor timeout argument was updated for apify-client 3.1.x:

• old/incompatible: timeout_secs=240
• current: run_timeout=timedelta(seconds=240)

All existing financial protections remain enabled:

• parent PPE budget preflight
• child max total charge
• child max items
• 240-second child timeout
• no automatic restart
• paid social enrichment disabled
• bounded parent memory
• per-result budget re-check