# API Endpoints
Source: https://docs.wetrocloud.com/api-reference/api-endpoints

Explore the available WetroCloud API endpoints for data extraction and AI-powered operations.

### Endpoints

| Endpoint           | Method | Description                                                                                    |
| :----------------- | :----- | :--------------------------------------------------------------------------------------------- |
| **`/v1/extract/`** | POST   | Extract structured data from any website using AI-powered extraction with custom JSON schemas. |

## Data Extraction Endpoint

### POST `/v1/extract/`

Extract specific information from any web page and receive it in a structured JSON format that matches your requirements.

**Request Parameters:**

| Parameter     | Type    | Required | Description                                                                            |
| ------------- | ------- | -------- | -------------------------------------------------------------------------------------- |
| `link`        | String  | Yes      | The URL of the website to extract data from                                            |
| `prompt`      | String  | Yes      | Instructions describing what data to extract                                           |
| `json_schema` | Array   | No       | The structure defining your desired output format. If not provided, returns plain text |
| `delay`       | Integer | No       | Delay in seconds before extraction (useful for dynamic content). Default: 0            |

**Example Request:**

<CodeGroup>
  ```python Python theme={null}
  import requests
  import json

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

  headers = {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
  }

  payload = {
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article",
      "json_schema": [
          {"name": "string"},
          {"networth": "number"}
      ],
      "delay": 2
  }

  response = requests.post(url, headers=headers, data=json.dumps(payload))
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://api.wetrocloud.com/v1/extract/";

  const headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <api_key>"
  };

  const payload = {
    link: "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
    prompt: "Extract the names and networth of Billionares in the article",
    json_schema: [
      { name: "string" },
      { networth: "number" }
    ],
    delay: 2
  };

  fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```bash cURL theme={null}
  curl --location 'https://api.wetrocloud.com/v1/extract/' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Token <api_key>' \
    --data '{
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article",
      "json_schema": [
        {"name": "string"},
        {"networth": "number"}
      ],
      "delay": 2
    }'
  ```
</CodeGroup>

**Response Format (Structured Output):**

```json theme={null}
{
  "response": [
    {
      "name": "Elon Musk",
      "networth": "$462 billion"
    },
    {
      "name": "Larry Ellison",
      "networth": "$340 billion"
    }
    // ... more results
  ],
  "success": true
}
```

**Response Format (Plain Text - when json\_schema is omitted):**

```json theme={null}
{
  "response": "Here are the names and net worths of the billionaires listed in the article:\n\n1. **Elon Musk:** $462 billion\n2. **Larry Ellison:** $340 billion...",
  "success": true
}
```

| Field      | Type            | Description                                                                                   |
| ---------- | --------------- | --------------------------------------------------------------------------------------------- |
| `response` | Array or String | Extracted data matching your JSON schema (array) or plain text (string) if no schema provided |
| `success`  | Boolean         | Indicates whether the extraction was successful                                               |

**Status Codes:**

* `200 OK` - Request successful
* `400 Bad Request` - Invalid parameters or malformed JSON schema
* `401 Unauthorized` - Invalid or missing API key
* `404 Not Found` - URL not accessible

**Error Response:**

```json theme={null}
{
  "error": "Error message describing what went wrong",
  "success": false
}
```


# Extract Data
Source: https://docs.wetrocloud.com/api-reference/endpoints/data-extraction

post /v1/extract/
This endpoint allows you to extract specific information from any web page and receive it in a structured JSON format that matches your requirements.

#### Request Body

- `link` (string): The URL of the website to extract data from.
- `prompt` (string): Instructions describing what data to extract.
- `json_schema` (array, optional): The structure defining your desired output format. If not provided, returns plain text.
- `delay` (integer, optional): Delay in seconds before extraction (useful for dynamic content). Default: 0.

#### Response

The response is a JSON object with the following properties:

- `response` (array): Extracted data matching your JSON schema.
- `success` (boolean): Indicates whether the extraction was successful.



# Introduction
Source: https://docs.wetrocloud.com/api-reference/introduction

Learn how to easily integrate AI-powered data extraction into your applications.

<Note>
  Before you begin!<br />
  Visit the [Wetrocloud console](https://wetrocloud.com/console) to get your API key. If you have trouble obtaining it, refer to this [guide](/how-to-access-your-API-Key).
</Note>

The WetroCloud API provides powerful data extraction capabilities that allow you to extract structured data from any website using AI. Simply provide a URL, describe what you want to extract, and define your desired output schema.

### Sample Requests

We provide sample API calls next to each method, using cURL, Python, and JavaScript. Simply replace the placeholders with your specific parameters and test the calls directly.

<Warning>
  Important! <br />Always prefix your API key with `Token ` (including a space). Example: `Token YOUR_API_KEY`. Requests without this format will be rejected.
</Warning>

## Getting Started

The API is designed to be simple and straightforward:

1. **Authenticate**: Include your API key in the `Authorization` header
2. **Make a request**: Send a POST request with your extraction parameters
3. **Receive structured data**: Get back JSON-formatted data matching your schema

## Base URL

All API endpoints are prefixed with:

```
https://api.wetrocloud.com
```

## Authentication

All requests require authentication using an API key. Include it in the `Authorization` header:

```bash theme={null}
Authorization: Token YOUR_API_KEY
```

## Rate Limits

Please refer to your plan details in the [Wetrocloud Console](https://wetrocloud.com/console) for rate limit information.


# Data Extraction API
Source: https://docs.wetrocloud.com/endpoint-explanations/data-extraction

Extract structured data from any website using AI-powered extraction with custom JSON schemas

The Wetrocloud Data Extraction API allows you to extract specific information from any web page and receive it in a structured JSON format that matches your requirements. Simply provide a URL, describe what you want to extract, and define your desired output schema.

## How It Works

The API uses advanced AI to:

1. Load and analyze the content from the provided URL
2. Understand your extraction requirements from the prompt
3. Extract the relevant data
4. Format the results according to your JSON schema

## Endpoint

```
POST https://api.wetrocloud.com/v1/extract/
```

## Example Request (Structured Output)

This example shows how to extract data in a structured JSON format by providing a `json_schema`:

<CodeGroup>
  ```python Python theme={null}
  import requests
  import json

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

  headers = {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
  }

  payload = {
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article",
      "json_schema": [
          {"name": "string"},
          {"networth": "number"}
      ],
      "delay": 2
  }

  response = requests.post(url, headers=headers, data=json.dumps(payload))
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://api.wetrocloud.com/v1/extract/";

  const headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <api_key>"
  };

  const payload = {
    link: "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
    prompt: "Extract the names and networth of Billionares in the article",
    json_schema: [
      { name: "string" },
      { networth: "number" }
    ],
    delay: 2
  };

  fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```bash cURL theme={null}
  curl --location 'https://api.wetrocloud.com/v1/extract/' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Token <api_key>' \
    --data '{
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article",
      "json_schema": [
        {"name": "string"},
        {"networth": "number"}
      ],
      "delay": 2
    }'
  ```
</CodeGroup>

**Response:**

```json theme={null}
{
  "response": [
    {
      "name": "Elon Musk",
      "networth": "$462 billion"
    },
    {
      "name": "Larry Ellison",
      "networth": "$340 billion"
    },
    {
      "name": "Mark Zuckerberg",
      "networth": "$258 billion"
    },
    {
      "name": "Jeff Bezos",
      "networth": "$244 billion"
    },
    {
      "name": "Larry Page",
      "networth": "$221 billion"
    },
    {
      "name": "Sergey Brin",
      "networth": "$207 billion"
    },
    {
      "name": "Bernard Arnault",
      "networth": "$197 billion"
    },
    {
      "name": "Steve Ballmer",
      "networth": "$179 billion"
    },
    {
      "name": "Jensen Huang",
      "networth": "$158 billion"
    },
    {
      "name": "Michael Dell",
      "networth": "$156 billion"
    }
  ],
  "success": true
}
```

## Request Parameters

| Parameter     | Type    | Required | Description                                                                            |
| ------------- | ------- | -------- | -------------------------------------------------------------------------------------- |
| `link`        | String  | Yes      | The URL of the website to extract data from                                            |
| `prompt`      | String  | Yes      | Instructions describing what data to extract                                           |
| `json_schema` | Array   | No       | The structure defining your desired output format. If not provided, returns plain text |
| `delay`       | Integer | No       | Delay in seconds before extraction (useful for dynamic content). Default: 0            |

### The `json_schema` Parameter (Optional)

The `json_schema` parameter defines the structure of the data you want to extract. It's an array of objects where each object represents a field in your output.

**When to use:**

* Use `json_schema` when you want structured data in a specific format
* Omit `json_schema` when you want a plain text response

**Format:**

```json theme={null}
[
  {"field_name": "data_type"},
  {"another_field": "data_type"}
]
```

**Supported data types:**

* `"string"` - Text values
* `"number"` - Numeric values
* `"boolean"` - True/false values

**Example schemas:**

Single object extraction:

```json theme={null}
[
  {"title": "string"},
  {"price": "number"},
  {"in_stock": "boolean"}
]
```

Multiple items extraction (same schema, returns array):

```json theme={null}
[
  {"name": "string"},
  {"networth": "number"}
]
```

### The `prompt` Parameter

The `prompt` tells the AI what information to extract. Be specific and clear about what you want.

**Good prompts:**

* "Extract the names and net worth of all billionaires mentioned in the article"
* "Get all product names, prices, and ratings from this page"
* "Find all email addresses and phone numbers in the contact section"

**Tips for better prompts:**

* Be specific about what data you want
* Mention if you want all instances or just specific ones
* Indicate any filtering criteria

### The `delay` Parameter

Use the `delay` parameter when extracting from dynamic websites that load content via JavaScript. The delay gives the page time to fully load before extraction begins.

**When to use:**

* Single-page applications (SPAs)
* Pages with lazy-loaded content
* Dynamic dashboards
* Sites with JavaScript-rendered content

## More Examples

### Extract Billionaire Data (Plain Text Response)

When you omit the `json_schema`, you get a plain text response:

<CodeGroup>
  ```python Python theme={null}
  import requests
  import json

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

  headers = {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
  }

  payload = {
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article"
  }

  response = requests.post(url, headers=headers, data=json.dumps(payload))
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://api.wetrocloud.com/v1/extract/";

  const headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <api_key>"
  };

  const payload = {
    link: "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
    prompt: "Extract the names and networth of Billionares in the article"
  };

  fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```bash cURL theme={null}
  curl --location 'https://api.wetrocloud.com/v1/extract/' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Token <api_key>' \
    --data '{
      "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
      "prompt": "Extract the names and networth of Billionares in the article"
    }'
  ```
</CodeGroup>

**Response:**

```json theme={null}
{
  "response": "Here are the names and net worths of the billionaires listed in the article \"Who are the 10 richest people in the world in 2025?\":\n\n1.  **Elon Musk:** $462 billion\n2.  **Larry Ellison:** $340 billion\n3.  **Mark Zuckerberg:** $258 billion\n4.  **Jeff Bezos:** $244 billion\n5.  **Larry Page:** $221 billion\n6.  **Sergey Brin:** $207 billion\n7.  **Bernard Arnault:** $197 billion\n8.  **Steve Ballmer:** $179 billion\n9.  **Jensen Huang:** $158 billion\n10. **Michael Dell:** $156 billion",
  "success": true
}
```

### Extract Product Information

<CodeGroup>
  ```python Python theme={null}
  import requests
  import json

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

  headers = {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
  }

  payload = {
      "link": "https://example-store.com/products",
      "prompt": "Extract all product information including name, price, and availability",
      "json_schema": [
          {"product_name": "string"},
          {"price": "number"},
          {"available": "boolean"}
      ]
  }

  response = requests.post(url, headers=headers, data=json.dumps(payload))
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://api.wetrocloud.com/v1/extract/";

  const payload = {
    link: "https://example-store.com/products",
    prompt: "Extract all product information including name, price, and availability",
    json_schema: [
      { product_name: "string" },
      { price: "number" },
      { available: "boolean" }
    ]
  };

  fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
    },
    body: JSON.stringify(payload)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```bash cURL theme={null}
  curl --location 'https://api.wetrocloud.com/v1/extract/' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Token <api_key>' \
    --data '{
      "link": "https://example-store.com/products",
      "prompt": "Extract all product information including name, price, and availability",
      "json_schema": [
        {"product_name": "string"},
        {"price": "number"},
        {"available": "boolean"}
      ]
    }'
  ```
</CodeGroup>

### Extract Article Metadata

<CodeGroup>
  ```python Python theme={null}
  import requests
  import json

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

  headers = {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
  }

  payload = {
      "link": "https://example-blog.com/article",
      "prompt": "Extract the article title, author, publication date, and read time",
      "json_schema": [
          {"title": "string"},
          {"author": "string"},
          {"date": "string"},
          {"read_time": "number"}
      ],
      "delay": 1
  }

  response = requests.post(url, headers=headers, data=json.dumps(payload))
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://api.wetrocloud.com/v1/extract/";

  const payload = {
    link: "https://example-blog.com/article",
    prompt: "Extract the article title, author, publication date, and read time",
    json_schema: [
      { title: "string" },
      { author: "string" },
      { date: "string" },
      { read_time: "number" }
    ],
    delay: 1
  };

  fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Token <api_key>"
    },
    body: JSON.stringify(payload)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```bash cURL theme={null}
  curl --location 'https://api.wetrocloud.com/v1/extract/' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Token <api_key>' \
    --data '{
      "link": "https://example-blog.com/article",
      "prompt": "Extract the article title, author, publication date, and read time",
      "json_schema": [
        {"title": "string"},
        {"author": "string"},
        {"date": "string"},
        {"read_time": "number"}
      ],
      "delay": 1
    }'
  ```
</CodeGroup>

## Response Format

All successful requests return a JSON object with the following structure:

**With `json_schema` (Structured Output):**

```json theme={null}
{
  "response": [...],
  "success": true
}
```

**Without `json_schema` (Plain Text):**

```json theme={null}
{
  "response": "Plain text response...",
  "success": true
}
```

| Field      | Type            | Description                                                                                   |
| ---------- | --------------- | --------------------------------------------------------------------------------------------- |
| `response` | Array or String | Extracted data matching your JSON schema (array) or plain text (string) if no schema provided |
| `success`  | Boolean         | Indicates whether the extraction was successful                                               |

## Error Handling

If the request fails, you'll receive an error response:

```json theme={null}
{
  "error": "Error message describing what went wrong",
  "success": false
}
```

**Common errors:**

* Invalid API key
* Malformed JSON schema
* Inaccessible URL
* Invalid URL format

## Best Practices

1. **Be specific in your prompts**: Clear, detailed prompts produce better results
2. **Use appropriate delays**: Add a delay for JavaScript-heavy websites
3. **Design clear schemas**: Use descriptive field names and appropriate data types
4. **Handle errors gracefully**: Always check the `success` field in responses
5. **Test your schemas**: Start with simple schemas and iterate based on results

## Use Cases

The Data Extraction API is perfect for:

* **Price monitoring**: Track competitor pricing across multiple websites
* **Lead generation**: Extract contact information from business directories
* **Content aggregation**: Gather articles, blogs, or news from various sources
* **Market research**: Collect product data, reviews, and ratings
* **Data migration**: Extract data from old systems or websites
* **Real estate**: Gather property listings and details
* **Job boards**: Collect job postings and requirements

## Authentication

All requests require an API key in the Authorization header:

```bash theme={null}
Authorization: Token <your_api_key>
```

Get your API key from the [Wetrocloud Console](https://wetrocloud.com/console). If you need help obtaining your API key, refer to [this guide](/how-to-access-your-API-Key).

## Rate Limits

Please refer to your plan details in the [Wetrocloud Console](https://wetrocloud.com/console) for rate limit information.

## Need Help?

* Email us at [hello@wetrocloud.com](mailto:hello@wetrocloud.com)
* Check out the [API Reference](/api-reference/introduction) for more details


# Overview Markdown
Source: https://docs.wetrocloud.com/endpoint-explanations/overview-markdown

Coming soon



# How to Access Your API Key
Source: https://docs.wetrocloud.com/how-to-access-your-API-Key

To get started with Wetrocloud’s API, follow these steps to create your API key

1. Open your browser and go to [Wetrocloud's Console](https://wetrocloud.com/console).

2. Click either of the social logins, or fill out your email address and click **Continue with email** to signup.

<Frame>
  <img alt="" />
</Frame>

3. Navigate to the **Dashboard** tab in your account dashboard.

<Frame>
  <img alt="" />
</Frame>

4. Click **Create new API Key** and provide a name for your key.

<Frame>
  <img alt="" />
</Frame>

5. Copy the generated API key and store it securely.

<Frame>
  <img alt="alt" />
</Frame>


# Introduction
Source: https://docs.wetrocloud.com/introduction

Welcome 👋 to the Wetrocloud Developer Documentation. Here you'll learn how to easily integrate Retrieval Augmented Generation (RAG) into your applications using the Wetrocloud API.

<Frame>
  <img alt="Hero Light" />
</Frame>

Some reasons you might want to use Wetrocloud API:

1. **Data Categorization**: Categorize your data by defining specific rules with a JSON schema, making it easy to sort and manage your datasets.
2. **Structured Output**: Generate well-organized, consistent results from your data, ensuring that the information is presented in a clear and predictable format.
3. **Production-ready RAG**: Deploy Retrieval-Augmented Generation systems that are stable, efficient, and designed to handle production environments.
4. **Fast Retrieval**: Access relevant data quickly, ensuring your system can deliver responses without unnecessary delays.

## Next Steps

Learn how to make your first API request in minutes. Follow step-by-step instructions to get up and running

<CardGroup>
  <Card title="Quick Start" icon="pen-to-square" href="quickstart">
    Cant wait to get started? This quickstart guide will help you setup quickly.
  </Card>

  <Card title="About Retrieval Augmented Generation" icon="image" href="/about-RAG">
    New to RAG? Here is a quick primer to aid your understanding
  </Card>
</CardGroup>


# Quickstart
Source: https://docs.wetrocloud.com/quickstart

Extract structured data from any website in minutes with Wetrocloud's Data Extraction API

<Note>
  Before you begin!<br />
  Visit the [Wetrocloud console](https://wetrocloud.com/console) to get your API key. If you have trouble obtaining it, refer to this [guide](/how-to-access-your-API-Key).
</Note>

## Introduction

This quickstart guide will show you how to extract structured data from any website using the Wetrocloud API. In just a few minutes, you'll be able to:

* Extract data from any URL
* Define your own JSON schema for structured output
* Use AI-powered prompts to specify what data to extract

**Prerequisites:**

* An API key from the [Wetrocloud Console](https://wetrocloud.com/console)

## Your First Data Extraction

Let's extract billionaire names and net worth from a news article.

<Steps>
  <Step title="Make Your First Request">
    Extract structured data from a website by providing a link, prompt, and JSON schema.

    <CodeGroup>
      ```python Python theme={null}
      import requests
      import json

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

      headers = {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
      }

      payload = {
          "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
          "prompt": "Extract the names and networth of Billionares in the article",
          "json_schema": [
              {"name": "string"},
              {"networth": "number"}
          ],
          "delay": 2
      }

      response = requests.post(url, headers=headers, data=json.dumps(payload))
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const url = "https://api.wetrocloud.com/v1/extract/";

      const headers = {
        "Content-Type": "application/json",
        "Authorization": "Token <api_key>"
      };

      const payload = {
        link: "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
        prompt: "Extract the names and networth of Billionares in the article",
        json_schema: [
          { name: "string" },
          { networth: "number" }
        ],
        delay: 2
      };

      fetch(url, {
        method: "POST",
        headers: headers,
        body: JSON.stringify(payload)
      })
        .then(response => response.json())
        .then(data => console.log(data))
        .catch(error => console.error("Error:", error));
      ```

      ```bash cURL theme={null}
      curl --location 'https://api.wetrocloud.com/v1/extract/' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Token <api_key>' \
        --data '{
          "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
          "prompt": "Extract the names and networth of Billionares in the article",
          "json_schema": [
            {"name": "string"},
            {"networth": "number"}
          ],
          "delay": 2
        }'
      ```
    </CodeGroup>
  </Step>

  <Step title="Understanding the Response">
    The API returns a structured JSON response matching your schema:

    ```json theme={null}
    {
      "response": [
        {
          "name": "Elon Musk",
          "networth": "$462 billion"
        },
        {
          "name": "Larry Ellison",
          "networth": "$340 billion"
        },
        {
          "name": "Mark Zuckerberg",
          "networth": "$258 billion"
        },
        {
          "name": "Jeff Bezos",
          "networth": "$244 billion"
        },
        {
          "name": "Larry Page",
          "networth": "$221 billion"
        },
        {
          "name": "Sergey Brin",
          "networth": "$207 billion"
        },
        {
          "name": "Bernard Arnault",
          "networth": "$197 billion"
        },
        {
          "name": "Steve Ballmer",
          "networth": "$179 billion"
        },
        {
          "name": "Jensen Huang",
          "networth": "$158 billion"
        },
        {
          "name": "Michael Dell",
          "networth": "$156 billion"
        }
      ],
      "success": true
    }
    ```

    | Field      | Description                                         |
    | ---------- | --------------------------------------------------- |
    | `response` | Array of extracted data matching your JSON schema   |
    | `success`  | Boolean indicating if the extraction was successful |
  </Step>

  <Step title="Try Different Schemas or Plain Text">
    You can customize the JSON schema to extract different types of data, or omit it entirely for plain text responses.

    <Info>
      **Pro tip:** The `json_schema` parameter is optional. Omit it to get a plain text response instead of structured JSON.
    </Info>

    Here are some examples:

    **Extract product information:**

    <CodeGroup>
      ```python Python theme={null}
      import requests
      import json

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

      headers = {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
      }

      payload = {
          "link": "https://example.com/products",
          "prompt": "Extract all product details",
          "json_schema": [
              {"product_name": "string"},
              {"price": "number"},
              {"rating": "number"}
          ]
      }

      response = requests.post(url, headers=headers, data=json.dumps(payload))
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const payload = {
        link: "https://example.com/products",
        prompt: "Extract all product details",
        json_schema: [
          { product_name: "string" },
          { price: "number" },
          { rating: "number" }
        ]
      };

      fetch("https://api.wetrocloud.com/v1/extract/", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
        },
        body: JSON.stringify(payload)
      })
        .then(response => response.json())
        .then(data => console.log(data));
      ```

      ```bash cURL theme={null}
      curl --location 'https://api.wetrocloud.com/v1/extract/' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Token <api_key>' \
        --data '{
          "link": "https://example.com/products",
          "prompt": "Extract all product details",
          "json_schema": [
            {"product_name": "string"},
            {"price": "number"},
            {"rating": "number"}
          ]
        }'
      ```
    </CodeGroup>

    **Extract contact information:**

    <CodeGroup>
      ```python Python theme={null}
      import requests
      import json

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

      headers = {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
      }

      payload = {
          "link": "https://example.com/contact",
          "prompt": "Extract contact details",
          "json_schema": [
              {"name": "string"},
              {"email": "string"},
              {"phone": "string"}
          ]
      }

      response = requests.post(url, headers=headers, data=json.dumps(payload))
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const payload = {
        link: "https://example.com/contact",
        prompt: "Extract contact details",
        json_schema: [
          { name: "string" },
          { email: "string" },
          { phone: "string" }
        ]
      };

      fetch("https://api.wetrocloud.com/v1/extract/", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
        },
        body: JSON.stringify(payload)
      })
        .then(response => response.json())
        .then(data => console.log(data));
      ```

      ```bash cURL theme={null}
      curl --location 'https://api.wetrocloud.com/v1/extract/' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Token <api_key>' \
        --data '{
          "link": "https://example.com/contact",
          "prompt": "Extract contact details",
          "json_schema": [
            {"name": "string"},
            {"email": "string"},
            {"phone": "string"}
          ]
        }'
      ```
    </CodeGroup>

    **Get plain text response (without json\_schema):**

    <CodeGroup>
      ```python Python theme={null}
      import requests
      import json

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

      headers = {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
      }

      payload = {
          "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
          "prompt": "Extract the names and networth of Billionares in the article"
      }

      response = requests.post(url, headers=headers, data=json.dumps(payload))
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const payload = {
        link: "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
        prompt: "Extract the names and networth of Billionares in the article"
      };

      fetch("https://api.wetrocloud.com/v1/extract/", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": "Token <api_key>"
        },
        body: JSON.stringify(payload)
      })
        .then(response => response.json())
        .then(data => console.log(data));
      ```

      ```bash cURL theme={null}
      curl --location 'https://api.wetrocloud.com/v1/extract/' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Token <api_key>' \
        --data '{
          "link": "https://theweek.com/news/people/954994/billionaires-richest-person-in-the-world",
          "prompt": "Extract the names and networth of Billionares in the article"
        }'
      ```
    </CodeGroup>

    **Response:**

    ```json theme={null}
    {
      "response": "Here are the names and net worths of the billionaires...\n\n1. **Elon Musk:** $462 billion\n2. **Larry Ellison:** $340 billion...",
      "success": true
    }
    ```
  </Step>
</Steps>

## Next Steps

Great! You've successfully extracted structured data from a website.

Now you can:

* Learn more about the [Data Extraction API](/endpoint-explanations/data-extraction) and all available parameters
* Explore the complete [API Reference](/api-reference/introduction)
* Check out advanced features like custom delays and complex schemas

<Info>
  **Need help?** Email us at [hello@wetrocloud.com](mailto:hello@wetrocloud.com)
</Info>