# DeviantArt 关键词搜索 API (deviantart.search)

- Canonical page: [https://everyinfra.com/deviantart-api/search](https://everyinfra.com/deviantart-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "deviantart", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 30, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

DeviantArt 关键词搜索用 `keyword` 按作品主题检索公开作品，结果来自不同创作者，字段和画廊相同。它回答「这个主题下有哪些作品、是谁画的」，适合做视觉参考的情绪板、按风格找可以约稿的画师，或者看一个题材都有谁在做。

`keyword` 写作品主题，例如示例里的 landscape illustration，不是用户名的精确查询；知道作者是谁，就去用户名对应的接口。`category` 把结果收窄到一个大类，同样搜风景，`traditional_art` 和 `digital_art` 分别拿到传统艺术和数字艺术两批作品，`photography` 则是摄影。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=deviantart&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | DeviantArt 作品主题搜索词，例如 landscape；用于搜索作品，不是用户名精确查询。 |
| category | enum: any_category / designs / digital_art / fan_art / film_animation / literature / photography / traditional_art | no | not declared | search 的作品类别：any_category 不限、digital_art 数字艺术、traditional_art 传统艺术、photography 摄影、fan_art 同人、literature 文学、film_animation 影视动画、designs 设计。 |
| limit | integer (1–100) | no | 30 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| thumbnail_url | 缩略图链接，分辨率低于 image_url。 |
| author_username | 作者用户名（@handle），通常可用于拼 URL。 |
| author_name | 作者昵称（显示名）。 |
| author_url | 作者在原平台的主页链接。 |
| author_avatar_url | 作者头像。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| author_emails | 作者公开的联系邮箱列表，原文返回；没有时没有这个字段。 |
| author_email_domains | 上面那些邮箱的域名列表。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "deviantart",
  "action": "search",
  "params": {
    "keyword": "landscape illustration"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "deviantart",
        "action": "search",
        "params": {
            "keyword": "landscape illustration",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 30. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "deviantart",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.deviantart.com/nicknamejeffreyjiang/art/Radio-Telescope-On-Mountain-Peak-1383309800",
      "title": "Radio Telescope On Mountain Peak",
      "text": "Want more AI art and wallpapers? Watch for new inspiration every day: https://www.deviantart.com/nicknamejeffreyjiang This artwork is available as a wide-screen digital file, suitable for wallpaper use, personal collection, and visual inspiration. Full resolution: 2016 × 864 px. …",
      "image_url": "https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/f/5237e797-4a93-4bff-a339-3bd118dc3794/dmvl4o8-e13abb79-e506-4726-becb-a95f1fcbe4bb.jpg/v1/fill/w_1366,h_585,q_70,strp/radio_telescope_on_mountain_peak_by_nicknamejeffreyjiang_dmvl4o8-pre.jpg?token=eyJ0eXAiOiJKV1QiLCJhbGciOi…",
      "thumbnail_url": "https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/f/5237e797-4a93-4bff-a339-3bd118dc3794/dmvl4o8-e13abb79-e506-4726-becb-a95f1fcbe4bb.jpg/v1/fit/w_300,h_823,q_70,strp/radio_telescope_on_mountain_peak_by_nicknamejeffreyjiang_dmvl4o8-300w.jpg?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJ…",
      "author_username": "•••",
      "author_name": "•••",
      "author_url": "https://www.deviantart.com/•••",
      "author_avatar_url": "https://a.deviantart.net/•••",
      "posted_at": "2026-09-22T04:14:33.000Z",
      "platform": "deviantart"
    },
    {
      "id": "•••",
      "url": "https://www.deviantart.com/titzerfirm/art/Vibrant-Desert-Mountain-Valley-Landscape-Illustration-1382946370",
      "title": "Vibrant Desert Mountain Valley Landscape Illustration",
      "image_url": "https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/f/c8405067-6894-4abc-bee9-654f0b46e062/dmvdc8y-b995d9e4-f449-42a4-adeb-e64ce269ac78.png/v1/fill/w_1182,h_676,q_70,strp/vibrant_desert_mountain_valley_landscape_illustration_by_titzerfirm_dmvdc8y-pre.jpg?token=eyJ0eXAiOiJKV1Q…",
      "thumbnail_url": "https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/f/c8405067-6894-4abc-bee9-654f0b46e062/dmvdc8y-b995d9e4-f449-42a4-adeb-e64ce269ac78.png/v1/fit/w_300,h_732,q_70,strp/vibrant_desert_mountain_valley_landscape_illustration_by_titzerfirm_dmvdc8y-300w.jpg?token=eyJ0eXAiOiJKV1Qi…",
      "author_username": "•••",
      "author_name": "•••",
      "author_url": "https://www.deviantart.com/•••",
      "author_avatar_url": "https://a.deviantart.net/•••",
      "posted_at": "2026-09-21T03:28:22.000Z",
      "platform": "deviantart"
    }
  ],
  "count": 30,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 搜到喜欢的作品后，怎么找到作者的更多作品？

记下这一行的 `author_username`，不带 @ 传给作品画廊，就能读这位作者画廊里的公开作品；要看作者本人的资料，用资料那一项能力。同一位作者可能在结果里出现好几次，按 `author_username` 合并，就能看出这批结果里谁出现得最多。

### 能用搜索结果建一份画师联系名单吗？

可以，靠 `author_emails` 和 `author_email_domains`。作者公开了邮箱时，前者是原文邮箱列表，后者是这些邮箱的域名；没公开时 `author_emails` 不出现，不是空值。按作者合并后，有邮箱的直接进名单，没有的保留 `author_url` 留待站内联系。再按域名分组，用同一个邮箱域名的作者会归到一起。

### 一次能搜多少条，`category` 怎么选？

默认 30 条，单次最多 100 条。主题宽的词，例如单独一个 landscape，作品会很杂，先用 `category` 挑一个最贴近的大类收窄，`any_category` 才是不限。返回行里的 `category` 沿用 DeviantArt 自己的分类名，没做跨平台归一。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=deviantart
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
