# Search Pugongying creators by keyword, audience, and price

Search Xiaohongshu Pugongying creators with keyword, audience, location, content, pricing, performance, cooperation, live, and similarity filters.

|  |  |
| --- | --- |
| Tool id | `justoneapi.x-xiaohongshu-pgysolar-cooperator-blogger-v2-v1` |
| Platform | [Xiaohongshu Pugongying](https://www.orcarouter.ai/tools/pugongying.md) |
| Capability | [Places](https://www.orcarouter.ai/tools/pugongying/place-search.md) |
| Price | $0.08118 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | yes |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `accumCommonImpMedinNum30d` | string | no | Daily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound. |
| `accumCoopImpMedinNum30d` | string | no | Cooperation note exposure median range. Pass two comma-separated numeric bounds. |
| `audienceGroup` | string | no | Audience target filter. Pass Pugongying audience group IDs (\`dmpGroupId\`) separated by English or Chinese commas. These IDs are dynamic and account-specific, so there is no fixed global value list. Use the audience group name shown in Pugongying Audience Management to identify what each ID means. |
| `avgAgmv90d` | string | no | Average live sales amount range. Pass two comma-separated numeric bounds. |
| `avgLiveViewerNum` | string | no | Average live viewer count range. Pass two comma-separated numeric bounds. |
| `contentSceneLabel` | string | no | Content scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas. Available values: - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探 |
| `contentTag` | string | no | Content category filter. Pass first-level or second-level category labels from Pugongying, separated by commas. Available values: - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才 |
| `contentThemeLabel` | string | no | Content theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs. |
| `estimateCpuv30d` | string | no | Estimated outer-store visit unit price range. Pass two comma-separated numeric bounds. |
| `estimatePicReadPrice` | string | no | Estimated photo-text read unit price range. Pass two comma-separated numeric bounds. |
| `estimatePictureCpm` | string | no | Estimated photo-text CPM range. Pass two comma-separated numeric bounds. |
| `estimatePictureEngageCost` | string | no | Estimated photo-text engagement unit price range. Pass two comma-separated numeric bounds. |
| `estimateVideoCpm` | string | no | Estimated video CPM range. Pass two comma-separated numeric bounds. |
| `estimateVideoEngageCost` | string | no | Estimated video engagement unit price range. Pass two comma-separated numeric bounds. |
| `estimateVideoReadPrice` | string | no | Estimated video read unit price range. Pass two comma-separated numeric bounds. |
| `excludeLowActive` | boolean | no | Whether to exclude low-activity bloggers. |
| `excludeTradeReportBrandIds` | boolean | no | Whether to exclude creators who cooperated with the selected recent cooperation brands. |
| `fansAge` | string | no | Target fans age group. Available Values: - \`ALL\`: All ages - \`LT_18\`: Under 18 - \`AGE_18_24\`: 18 to 24 - \`AGE_25_34\`: 25 to 34 - \`AGE_35_44\`: 35 to 44 - \`GT_44\`: Above 44 One of: ALL, LT_18, AGE_18_24, AGE_25_34, AGE_35_44, GT_44. |
| `fansChildAgeInfo` | string | no | Mother-and-baby audience stage filter. Pass Pugongying labels or numeric codes separated by English or Chinese commas. Available values: - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期 |
| `fansGender` | string | no | Target fans gender. Available Values: - \`ALL\`: All genders - \`MALE_HIGH\`: Mainly Male - \`FE_MALE_HIGH\`: Mainly Female One of: ALL, MALE_HIGH, FE_MALE_HIGH. |
| `fansLocation` | string | no | Follower audience location filter. Pass Pugongying follower-region labels separated by English or Chinese commas. Country, China province, and city-level paths are supported; district/county-level paths are not accepted. Only paths present in the Pugongying follower-region tree are accepted. Use cit |
| `fansNumUp` | boolean | no | Whether to exclude bloggers whose fan count is dropping. |
| `fansNumberLower` | integer | no | Minimum number of fans. |
| `fansNumberUpper` | integer | no | Maximum number of fans. |
| `featureTags` | string | no | Good-at content tag filter. Pass label values separated by commas. |
| `gender` | string | no | KOL's gender. Available Values: - \`ALL\`: All genders - \`MALE\`: Male - \`FEMALE\`: Female One of: ALL, MALE, FEMALE. |
| `industry` | string | no | Pugongying industry preset for industry assistant style creator recommendations. Available Values: - \`BEAUTY_PERSONAL_CARE_BEAUTY\`: Beauty and personal care - beauty - \`BEAUTY_PERSONAL_CARE_SKINCARE\`: Beauty and personal care - skincare - \`BEAUTY_PERSONAL_CARE_PERSONAL_CARE\`: Beauty and personal ca… |
| `industrySpecificCrowdsMotorDom` | string | no | Industry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas. |
| `interMidCoop30` | string | no | Cooperation note interaction median range. Pass two comma-separated numeric bounds. |
| `interMidNor30` | string | no | Daily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound. |
| `inviteReply48hNumRatio` | string | no | 48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95. |
| `keyword` | string | no | Search keyword. |
| `kliveCnt30d` | string | no | Live count in the last 30 days range. Pass two comma-separated numeric bounds. |
| `location` | string | no | Creator profile location filter. Pass Pugongying location labels separated by English or Chinese commas. Country, China province or region, city-level paths, and district/county-level paths are supported. China province or region short labels are normalized to the full Pugongying value. Only paths p |
| `mCpuvNum30d` | string | no | Cooperation note outer-store median range. Pass two comma-separated numeric bounds. |
| `marketTarget` | string | no | Marketing target filter. Pass one Pugongying marketing target value. Available values: - estimateAllCpm: Exposure - exposure performance - cost - mAccumImpNum: Exposure - exposure performance - scale - readCost: Exposure - read performance - cost - mValidRawReadFeedNum: Exposure - read performance - |
| `notePrice` | string | no | Photo-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound. |
| `noteType` | string | no | Note type filter. Values: ALL=all note types, PHOTO_TEXT=mainly photo-text notes, VIDEO=mainly video notes. Available Values: - \`ALL\`: All note types - \`PHOTO_TEXT\`: Mainly photo-text notes - \`VIDEO\`: Mainly video notes One of: ALL, PHOTO_TEXT, VIDEO. |
| `page` | integer | no | Page number. |
| `personalTags` | string | no | Blogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas. Available values: - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR |
| `progressOrderCnt` | string | no | Current cooperation order count range. Pass two comma-separated numeric bounds. |
| `readMidCoop30` | string | no | Cooperation note read median range. Pass two comma-separated numeric bounds. |
| `readMidNor30` | string | no | Daily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound. |
| `searchType` | string | no | Search criteria type. Available Values: - \`NICKNAME\`: Search by nickname - \`NOTE\`: Search by note content One of: NICKNAME, NOTE. |
| `similarUserId` | string | no | Similar creator user ID. \`similarUserId\` and \`similarWord\` must be provided together. |
| `similarWord` | string | no | Similar creator keyword shown by Pugongying. \`similarUserId\` and \`similarWord\` must be provided together. |
| `sort` | string | no | Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Pugongying intelligent ranking. Available Values: - \`DEFAULT\`: Platform default intelligent ranking - \`FANS\`: Sort by follower count descending One of: DEFAULT, FANS. |
| `thousandLikePercent30` | string | no | Thousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null. |
| `top20CrowdsLabel` | string | no | Top-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values. |
| `tradeReportBrandIds` | string | no | Recent cooperation brand IDs, separated by English or Chinese commas. |
| `tradeType` | string | no | Recent cooperation industry filter from Pugongying. |
| `videoPrice` | string | no | Video cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound. |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/justoneapi.x-xiaohongshu-pgysolar-cooperator-blogger-v2-v1/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/justoneapi.x-xiaohongshu-pgysolar-cooperator-blogger-v2-v1/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Search Pugongying Content Square notes by keyword](https://www.orcarouter.ai/tools/pugongying/place-search/x-xiaohongshu-pgypgy-content-square-search-note-v2-v1.md) | — | $0.024354 per call | OK |

## FAQ

### How much does Search Pugongying creators by keyword, audience, and price cost?

Search Pugongying creators by keyword, audience, and price costs $0.08118 per call: 1,000 calls cost $81.18.

### What does a $10 budget buy with Search Pugongying creators by keyword, audience, and price?

About 123 calls at $0.08118 per call.

### What inputs does Search Pugongying creators by keyword, audience, and price need?

It has no required inputs.

### How do I call Search Pugongying creators by keyword, audience, and price?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/pugongying/place-search/x-xiaohongshu-pgysolar-cooperator-blogger-v2-v1
