> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 电子邮件查询
> 由主页 URL 查询单个 TikTok、Instagram 或 YouTube 创作者的联系邮箱。
根据 Instagram、TikTok 或 YouTube 创作者的主页 URL 查询联系邮箱。传入 `profile_url`，响应返回解析出的 `platform`、规范化后的 `profile_url`，以及形如 `{status, value}` 的 `email` 对象。
`status` 为 `not_found`（`value` 为 null）表示该创作者未公开邮箱 —— 这是正常结果，不是错误，且仍按一次有效查询计费。
每次调用只处理一个创作者。若需要先获得一批创作者，请用 [`post_waveinflu_similar_creators`](/docs/zh/api-reference/waveinflu/post_waveinflu-similar) 或 [`post_waveinflu_ai_search`](/docs/zh/api-reference/waveinflu/post_waveinflu-ai-search) —— 它们对多数匹配已直接返回 `email`，本接口只需用于 `email` 为 null 的结果。
**破坏性变更（上游迁移至 hiCreator）。** 请求字段由 `url` 改为 `profile_url`；响应改为 `data.email.{status, value}` 与 `data.profile_url`，原 `emails[]`、`contacts[]`、`username`、`quota` 字段已移除。若仍传旧字段 `url`，将返回 `400 code=10001` 且不计费。
## 示例
```bash REST theme={null}
curl -X POST "https://api.aisa.one/apis/v1/waveinflu/email-lookup" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"profile_url": "https://www.instagram.com/onkimia/"}'
```
```jsonc MCP theme={null}
// 把整段复制给 Claude Code、Codex、Cursor 或任意 coding agent。
// 连接、授权、跑通这个例子需要的东西都在里面 ——
// 不用粘贴任何 key，浏览器里点一次 Allow 就好。
{
"operation_id": "post_waveinflu_email_lookup",
"arguments": {
"profile_url": "https://www.instagram.com/onkimia/"
},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/zh/api-reference/waveinflu/post_waveinflu-email-lookup.md
// Then run the call and show me the result.
```
**第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
[aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/waveinflu/post_waveinflu-email-lookup)
## OpenAPI
````yaml openapi/zh/waveinflu.json POST /waveinflu/email-lookup
openapi: 3.0.0
info:
title: WaveInflu API
version: 2.0.0
description: >-
WaveInflu 创作者发现 API，覆盖 Instagram、TikTok 和 YouTube：相似创作者（按种子账号）、AI
搜索（按自然语言描述）、邮箱查询（单个创作者的联系邮箱）。
servers:
- url: https://api.aisa.one/apis/v1
security:
- bearerAuth: []
paths:
/waveinflu/email-lookup:
post:
summary: 电子邮件查询
description: >-
根据主页 URL 查询单个 Instagram、TikTok 或 YouTube 创作者的联系邮箱。传入
`profile_url`，响应返回解析出的 `platform`、规范化后的 `profile_url`，以及形如 `{status,
value}` 的 `email` 对象。`not_found` 状态（`value` 为
null）属于正常结果、并非错误，仍按一次有效查询计费。每次调用只处理一个创作者。若需先获得一批创作者，请用相似创作者或 AI
搜索——每条匹配对多数创作者已自带 `email`，本接口只需用于为 null 的结果。
operationId: post_waveinflu_email_lookup
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- profile_url
properties:
profile_url:
type: string
description: Instagram、TikTok 或 YouTube 创作者主页 URL。
example: https://www.instagram.com/onkimia/
responses:
'200':
description: 邮箱查询完成
content:
application/json:
schema:
type: object
properties:
requestId:
type: string
description: 用于支持与监控的请求 ID。
example: req-b6a
billingRequestId:
type: string
description: 本次调用的计费引用，关联你的用量记录。
example: 7c12fbeb-1f42-4ca0-88f0-353b72ee03f2
data:
$ref: '#/components/schemas/EmailLookupData'
'400':
description: 请求无效。例如传旧字段 `url`（而非 `profile_url`）会返回 code 10001，且不计费。
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: '10001'
message:
type: string
example: The request is invalid.
requestId:
type: string
details:
type: array
items:
type: object
components:
schemas:
EmailLookupData:
type: object
properties:
platform:
type: string
description: 从主页 URL 解析出的平台：instagram、tiktok 或 youtube。
example: instagram
profile_url:
type: string
description: 本次查询使用的规范化创作者主页 URL。
example: https://www.instagram.com/onkimia/
email:
$ref: '#/components/schemas/EmailResult'
EmailResult:
type: object
properties:
status:
type: string
description: 查询结果：`found` 表示已解析到邮箱，否则为未找到状态。未找到属于正常结果，仍按一次有效查询计费。
example: found
value:
type: string
nullable: true
description: 主联系邮箱；未找到时为 null。
example: onkimia.mexico@gmail.com
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.