v7

latestOpenAPI 3.1.0raw.githubusercontent.com2025-03-27193380.5 KB
LAM

Lam Run Endpoint

post/lam/run

Request body

querystring required

The input query string for the request. This is typically the main prompt.

chat_historyobject[] nullable

The history of the conversation as a list of messages or objects you might use while building a chat app to give the model context of the past conversation.

app_urlstring nullable

This is the entrypoint URL for the web agent.

schemaobject

The expected schema for the response. This is a dictionary where the keys describe the fields and the values describe their purposes.

max_countinteger nullable

The maximum number of results to extract.

streamboolean nullable

Whether the response should be streamed back or not.

mode'deepsearch' | 'default' nullable

Mode of execution.

raccoon_passcodestring required

The raccoon passcode associated with the end user on behalf of which the call is being made.

Example request

{
  "query": "Find YCombinator startups who got funded in W24.",
  "chat_history": [],
  "app_url": "https://www.ycombinator.com/companies",
  "schema": {
    "address": {
      "city": "What city is the company located in?",
      "country": "Which country is the company located in?"
    },
    "funding_season": "The funding season like W24 as a string",
    "name": "Name of the company as a string"
  },
  "max_count": 5,
  "stream": true,
  "mode": "deepsearch",
  "raccoon_passcode": "<end-user-raccoon-passcode>",
  "advanced": {
    "block_ads": true,
    "solve_captchas": true,
    "proxy": {
      "country": "us",
      "city": "sanfrancisco",
      "state": "ca",
      "zip": 90210
    },
    "extension_ids": [
      "df2399ea-a938-438f-9d4b-ef3bc95cf8af"
    ]
  }
}

Response

Successful Response

task_status'STARTING' | 'PROCESSING' | 'DONE' | 'HUMAN_INTERACTION' | 'FAILURE' required

The current status of the extraction task. For example: 'STARTING', 'PROCESSING', 'DONE', 'HUMAN_INTERACTION', or 'FAILURE'.

messagestring required

A message providing the thought summary if the status is processing currently.

dataobject[] required

The extracted data as a list of objects when the status is DONE. Each object represents an extracted entity.

propertiesobject required

Additional metadata or details related to the run task.

livestream_urlstring required

The Livestream URL

Example response

{
  "task_status": "DONE",
  "message": "The price of iPhone 16 on Amazon is $729.97.",
  "data": [
    {
      "address": {
        "city": "San Francisco",
        "country": "USA"
      },
      "funding_season": "W24",
      "name": "Granza Bio"
    },
    {
      "address": {
        "city": "London",
        "country": "United Kingdom"
      },
      "funding_season": "W24",
      "name": "Konstructly"
    }
  ],
  "properties": {
    "sessionId": "1234"
  },
  "livestream_url": "https://api.raccoonai.tech/sessions/session_12345/stream?enable_actions=true&theme=dark"
}