Skip to main content
POST
/
api
/
v1
/
rag
/
discover
Discover URLs
curl --request POST \
  --url https://api.ravan.ai/api/v1/rag/discover \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "url": "<string>",
  "max_depth": 123,
  "limit": 123
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "urls": [
      "<string>"
    ]
  }
}

Authorizations

X-Api-Key
string
required
Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header. Find or rotate it from your Ravan AI account settings.

Body

url
string
required
A publicly reachable URL. Include the full protocol, for example https://example.com/docs.
max_depth
integer
The maximum crawl depth when discovering or ingesting URLs. Higher values can include more nested pages.
limit
integer
The maximum number of records to return. Use this with offset or pagination fields to page through results.

Response

success
boolean
Whether the request succeeded.
message
string
Human-readable status message.
data
object
Returned data.

Authorizations

X-Api-Key
string
header
required

Body

application/json
url
string
required

Root URL to discover from

max_depth
integer

Max crawl depth

limit
integer

Max URLs to return

Response

200 - application/json

Successful response

success
boolean
message
string
data
object