> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents API

> Build no-code research agents that search, scrape, and crawl the web with Olostep.

Through the Olostep Agents API you can create autonomous research agents that can automate data pipelines and search tasks on a schedule and deliver structured results.

* Web research across sites with automated extraction
* Multi-step workflows with scheduled execution and notifications
* Output to JSON/CSV/Sheets/DB

For availability and details, contact us at [info@olostep.com](mailto:info@olostep.com) or [Contact Sales](https://www.olostep.com/contact-sales).

## Installation

<CodeGroup>
  ```python Python theme={null}
  # pip install requests

  import requests
  ```

  ```js Node theme={null}
  // npm install node-fetch

  // ESM
  import fetch from 'node-fetch'

  // CommonJS
  const fetch = require('node-fetch')
  ```

  ```bash cURL theme={null}
  # macOS: builtin curl is fine
  ```
</CodeGroup>

## Create an agent

Create an agent with a natural language prompt and a target model.

<CodeGroup>
  ```python Python theme={null}
  API_URL = 'https://api.olostep.com/v1/agents' # endpoint available to select customers
  API_KEY = '<YOUR_API_KEY>'

  headers = {
    'Authorization': f'Bearer {API_KEY}', 
    'Content-Type': 'application/json'
  }

  data = {
    "prompt": """
      Find portfolio companies from https://www.vcsheet.com/funds and 
      write to a Google Sheet with columns (Fund Name, Fund Website URL, 
      Fund LinkedIn URL, Portfolio Company Name, Portfolio Company URL, 
      Portfolio Company LinkedIn URL). Run weekly on Monday at 9:00 AM 
      and email steve@example.com when new companies are added.
    """,
    "model": "gpt-4.1"
  }

  response = requests.post(API_URL, headers=headers, json=data)
  result = response.json()
  print(result)
  ```

  ```js Node theme={null}
  const res = await fetch('https://api.olostep.com/v1/agents', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer <YOUR_API_KEY>', 'Content-Type': 'application/json' },
    body: JSON.stringify({
      prompt: 'Find portfolio companies from https://www.vcsheet.com/funds and write to a Google Sheet...',
      model: 'gpt-4.1'
    })
  })
  console.log(await res.json())
  ```

  ```bash cURL theme={null}
  curl -s -X POST "https://api.olostep.com/v1/agents" \
    -H "Authorization: Bearer $OLOSTEP_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "Find portfolio companies from https://www.vcsheet.com/funds and write to a Google Sheet...",
      "model": "gpt-4.1"
    }'
  ```
</CodeGroup>

## Capabilities

The Olostep agent can:

* **Web Research**: Automatically search and extract data from websites
* **Data Organization**: Structure information into spreadsheets, databases, or other formats
* **Scheduled Execution**: Run tasks on a recurring schedule (daily, weekly, at a predefined time)
* **Multi-step Workflows**: Perform complex, multi-part research tasks autonomously
* **Notifications**: Send email alerts when new data is found or tasks complete
* **Custom Output**: Return data as CSV, JSON, Google Sheet, or directly in your database

## Access

The Agents API is currently available to select customers. To get access:

* Email us at [info@olostep.com](mailto:info@olostep.com)
* Or [contact our sales team](https://www.olostep.com/contact-sales)

## Pricing

Agents pricing is variable. It's billed by outcome. The price is negotiated between the client and the agent. Reach out to [info@olostep.com](mailto:info@olostep.com) for more details