​
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"
  }
}