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