AgentQL paginate waits for full network idle by default

TL;DR

Set it to False so it only waits for the load event. Set waitfornetwork_idle=False so it only waits for the page load event.

Steps

1. paginate hangs on pages that never go fully idle because waitfornetwork_idle defaults to True. Set it to False so it only waits for the load event. And switch mode to standard when fast mode keeps missing the pagination element.

When to use

You are seeing this: Also worth knowing: mode defaults to fast, which trades accuracy for speed. Use this skill when you run into "AgentQL paginate waits for full network idle by default".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Edge cases

• Also worth knowing: mode defaults to fast, which trades accuracy for speed.

Source: Official docs (AgentQL Tools API reference): the paginate function waits for the network to reach full idle state before querying each page for the pagination element. If the page never goes fully idle (analytics beacons, long polling, infinite scroll), the query hangs instead of failing fast. Set waitfornetwork_idle=False so it only waits for the page load event. Also worth knowing: mode defaults to fast, which trades accuracy for speed. Use standard when the pagination element is hard to find.

Verified resolution: paginate hangs on pages that never go fully idle because waitfornetwork_idle defaults to True. Set it to False so it only waits for the load event. And switch mode to standard when fast mode keeps missing the pagination element.

Source URL: https://docs.agentql.com/python-sdk/api-references/agentql-tools