API ReferenceExtraction
Extract data from URL
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Include your API key in the Authorization header as Bearer rf_your_key.
In: header
Request Body
application/json
fetch_mode?string
Fetch mode: auto, static, or dynamic
Default
"auto"Value in
"auto" | "static" | "dynamic"llm_config?
Optional LLM configuration override
schema*unknown
Schema defining the data structure to extract (JSON or YAML format)
url*string
URL to extract data from
Length
1 <= lengthwebhook?
Inline ephemeral webhook configuration
webhook_id?string
ID of a saved webhook to call on completion
webhook_url?string
Simple webhook URL (backward compatible)
Format
uri[key: string]?never
Response Body
application/json
application/problem+json
curl -X POST "http://localhost:8080/api/v1/extract" \ -H "Content-Type: application/json" \ -d '{ "schema": null, "url": "string" }'{
"data": null,
"fetched_at": "string",
"job_id": "string",
"metadata": {
"extract_duration_ms": 0,
"fetch_duration_ms": 0,
"model": "string",
"provider": "string"
},
"url": "string",
"usage": {
"cost_usd": 0.1,
"input_tokens": 0,
"is_byok": true,
"llm_cost_usd": 0.1,
"output_tokens": 0
}
}{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}