Skip to main content
GET
/
v1
/
extract
Extract Get
import requests

url = "https://api.example.com/v1/extract"

headers = {"X-Valet-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "id": "1f7015c8-b10c-45a3-ad39-3cd3e296688a",
  "success": true,
  "data": {
    "name": "NVIDIA Corporation",
    "open": 181.13,
    "price": 180.28,
    "change": -0.88,
    "symbol": "NVDA",
    "volume": 161039698,
    "currency": "USD",
    "timestamp": null,
    "avg_volume": 173590218,
    "day_range_low": 176.77,
    "market_status": "closed",
    "day_range_high": 183.44,
    "percent_change": -0.49,
    "previous_close": 181.16,
    "fifty_two_week_low": 86.62,
    "fifty_two_week_high": 195.62
  },
  "error": null,
  "request": {
    "endpoint": "/v1/extract",
    "method": "GET",
    "params": {
      "url": "https://finance.yahoo.com/quote/NVDA/"
    },
    "payload": {},
    "status_code": 200,
    "requested_at": "2025-10-23T09:05:18.802Z",
    "served_at": "2025-10-23T09:05:35.299Z",
    "elapsed_ms": 16497,
    "cache_info": {
      "is_cached": false,
      "cached_at": null,
      "expires_at": null
    }
  },
  "uapi_version": "1.2.5",
  "schema_version": "v1",
  "deprecation_warnings": []
}
Returns normalized, schema-aligned JSON for the target URL. Use this endpoint whenever you want structured data from a public page without writing your own scraper.
​
X-API-Key
string
required
API key used for authentication. Required for all requests.
​
x-cache-ttl
integer
Optional cache lifetime hint in seconds for successful GETs. Valid range is 0–3600. 0 disables caching for this request.
​
url
string
required
Publicly reachable URL to extract. Always URL-encode the value.
import os
from uapi import uAPI

client = uAPI(api_key=os.environ.get("UAPI_API_KEY"))

response = client.extract(
    url="https://finance.yahoo.com/quote/NVDA/",
)

print(response.to_dict())

​
Example response

{
  "id": "1f7015c8-b10c-45a3-ad39-3cd3e296688a",
  "success": true,
  "data": {
    "name": "NVIDIA Corporation",
    "open": 181.13,
    "price": 180.28,
    "change": -0.88,
    "symbol": "NVDA",
    "volume": 161039698,
    "currency": "USD",
    "timestamp": null,
    "avg_volume": 173590218,
    "day_range_low": 176.77,
    "market_status": "closed",
    "day_range_high": 183.44,
    "percent_change": -0.49,
    "previous_close": 181.16,
    "fifty_two_week_low": 86.62,
    "fifty_two_week_high": 195.62
  },
  "error": null,
  "request": {
    "endpoint": "/v1/extract",
    "method": "GET",
    "params": {
      "url": "https://finance.yahoo.com/quote/NVDA/"
    },
    "payload": {},
    "status_code": 200,
    "requested_at": "2025-10-23T09:05:18.802Z",
    "served_at": "2025-10-23T09:05:35.299Z",
    "elapsed_ms": 16497,
    "cache_info": {
      "is_cached": false,
      "cached_at": null,
      "expires_at": null
    }
  },
  "uapi_version": "1.2.5",
  "schema_version": "v1",
  "deprecation_warnings": []
}

Authorizations

​
X-Valet-Key
string
header
required

Query Parameters

​
url
string
required

Response

Successful Response