AgentQL REST API reference
AgentQL's REST API allows you to query web pages and documents like PDFs and image files to retrieve the results through HTTP requests from any language.
Query data
Extract data from a webpage by sending a URL and an AgentQL query.
curl -X POST https://api.agentql.com/v1/query-data \
-H "X-API-Key: $AGENTQL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "{ products[] { product_name product_price(integer) } }",
"url": "https://scrapeme.live/?s=fish&post_type=product",
"params": {
"wait_for": 0,
"is_scroll_to_bottom_enabled": false,
"mode": "fast",
"is_screenshot_enabled": false
}
}'
Make sure to replace $AGENTQL_API_KEY
with your actual API key.
{
"data": {
"products": [
{
"product_name": "Qwilfish",
"price": 77
},
{
"product_name": "Huntail",
"price": 52
},
...
]
},
"metadata": {
"request_id": "ecab9d2c-0212-4b70-a5bc-0c821fb30ae3"
}
}
Authentication
All requests to the AgentQL API must include an X-API-Key
header with your API key.
You can generate an API key through Dev Portal.
Request body for web queries
-
query
stringThe AgentQL query to execute
-
url
stringThe URL of the webpage to query
-
params
object (optional)-
wait_for
numberWait time in seconds for page load (max 10 seconds). Defaults to
0
. -
is_scroll_to_bottom_enabled
booleanEnable/disable scrolling to bottom before snapshot. Defaults to
false
. -
mode
strSpecifies the extraction mode:
standard
for complex or high-volume data, orfast
for typical use cases. Defaults tofast
. You can read more about the mode options in Guide. -
is_screenshot_enabled
booleanEnable/disable screenshot capture. Defaults to
false
.
-
Response for web queries
-
data
objectData that matches the query
-
metadata
object-
request_id
stringA UUID for the request
-
screenshot
string | nullBase64 encoded screenshot if enabled, null otherwise. You can convert the Base64 string returned in the
screenshot
field to an image and view it using free online tools like Base64.guru.
-
Query document
Extract data from a webpage by sending a PDF or image file and an AgentQL query.
curl -X POST https://api.agentql.com/v1/query-document \
-H "X-API-Key: $AGENTQL_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "file=@/path/to/file.pdf" \
-F "query={ products[] { product_name product_price(integer) } }"
-d " { "params": { "mode": "fast" } }"
Make sure to replace $AGENTQL_API_KEY
with your actual API key.
{
"data": {
"products": [
{
"product_name": "Qwilfish",
"price": 77
},
{
"product_name": "Huntail",
"price": 52
},
...
]
},
"metadata": {
"request_id": "ecab9d2c-0212-4b70-a5bc-0c821fb30ae3"
}
}
Authentication
All requests to the AgentQL API must include an X-API-Key
header with your API key.
You can generate an API key through Dev Portal.
Request body for document queries
-
query
stringThe AgentQL query to execute
-
file
Buffered Object representation of the file to extract data fromThe file to extract data from
-
params
object (optional)-
mode
strSpecifies the extraction mode:
standard
for complex or high-volume data, orfast
for typical use cases. Defaults tofast
. You can read more about the mode options in Guide. Only configurable in curl requests.
-
Response for document queries
-
data
objectData that matches the query
-
metadata
object-
request_id
stringA Universally Unique Identifier (UUID) for the request
-