跳转到主要内容
POST
/
v1
/
maps
curl --request POST \
  --url https://api.olostep.com/v1/maps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://docs.olostep.com"
}
'
{
  "id": "map_abc123",
  "urls_count": 22,
  "urls": [
    "https://docs.olostep.com/api-reference/batches/create",
    "https://docs.olostep.com/api-reference/batches/info",
    "https://docs.olostep.com/api-reference/batches/items"
  ]
}

授权

Authorization
string
header
必填

Bearer认证头格式为Bearer ,其中是你的认证令牌。

请求体

application/json
url
string<uri>
必填

你想要获取链接的网站的 URL

search_query
string

一个可选的搜索查询,用于按搜索相关性排序链接。

top_n
number

一个可选的数字,用于限制搜索查询的前 n 个链接。

include_subdomain
boolean

包含给定 URL 的子域。默认值为 true

include_urls
string[]

使用 glob 语法包含的 URL 路径模式。例如:/blog/** 仅包含博客 URL。只有匹配这些模式的 URL 才会被返回。

exclude_urls
string[]

使用 glob 语法排除的 URL 路径模式。例如:/careers/**。被排除的 URL 将优先于包含的 URL。

cursor
string

可选:来自先前响应的分页游标。当提供时,将从上一个请求由于响应大小限制而停止的地方返回下一组 URL。

响应

成功响应包含页面上找到的 URL。

urls_count
integer
必填

当前响应中的 URL 数量

urls
string[]
必填

页面上找到的 URL 数组

id
string

此地图的唯一标识符

cursor
string

分页游标用于检索由于10MB大小限制而受限的下一组URL。如果为null或不存在,则表示所有URL都已检索完毕。

credits_consumed
integer | null

此请求消耗的积分数量。在执行完成后填充。积分是计费的真实来源。

cost_usd
number | null

此请求的估计成本(以美元计)。在执行完成后填充。根据消耗的积分和你的计划费率计算——99% 准确,但 credits_consumed 是权威值。