API ReferenceExtraction

Extract data from URL

POST
/api/v1/extract

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

Length1 <= length
webhook?

Inline ephemeral webhook configuration

webhook_id?string

ID of a saved webhook to call on completion

webhook_url?string

Simple webhook URL (backward compatible)

Formaturi
[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"
}