Introduction

Adhoc extractions let you instantly extract data from a single webpage. Unlike workflows which run on a schedule, these are one-time extractions that run instantly when requested.

Prerequisites

To get the most out of this guide, you’ll need to:

1. Choose the Result Format

Every Adhoc request includes schemaId in the URL path:
  • Custom Schema ID: Use your own data schema
  • html: Returns the page’s raw HTML
  • body: Returns a cleaned HTML body
  • markdown: Returns the page in Markdown

2. Use A Proxy Location (Optional)

If you need to specify a proxy location, you can retrieve valid locations first:
GET https://api.kadoa.com/v4/locations
View full API reference → Use the returned isoCode values in your Adhoc requests for location.isoCode.

3. Run an Adhoc Extraction

To initiate an adhoc extraction, send a POST request to the /adhoc endpoint with the desired configuration. View full API reference →
// POST /v4/adhoc/markdown
{
  "link": "https://demo.vercel.store/product/acme-drawstring-bag",
  "location": {
    "type": "manual",
    "isoCode": "US"
  }
}