ai_parser_parse_url
Read-onlyIdempotent
Scrape a URL with a pre-created AI parser to extract structured data as JSON. Use when you have a finished parser and need consistent data from similar pages.
Instructions
Parse a URL with an existing AI parser and return structured data.
Scrapes the given URL and applies the parser, returning the extracted data
as structured JSON keyed by the parser's fields. The parser must already be
'FINISHED' (see 'ai_parser_create' / 'ai_parser_get_details'). Costs 1 credit per call.
When to use:
- Extracting structured data from a page using a FINISHED parser
- Applying one parser across many similarly structured pages
When NOT to use:
- The parser isn't ready yet (create it, then poll 'ai_parser_get_details')
- A one-off fetch (use 'scrape') or a supported marketplace/SERP (use the SDE)
Args:
params (AiParseParams): parser_id and url are required; optional version.
Returns:
str: JSON of the form {"parser": ..., "version": ..., "result": {...}}.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |