Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Just One API / Creator Search

Just One API tool justoneapi-api-xiaohongshu-pgy-api-solar-cooperator-blogger on looot: input fields, $0.0743 per call, output shape, and code to run it with curl, JavaScript or Python.

Search Xiaohongshu Pugongying creators with keyword, audience, location, content, pricing, performance, cooperation, live, and similarity filters. Use it to build a campaign creator shortlist.

Inputs

Name Type Required Description
accumCommonImpMedinNum30d string no
accumCoopImpMedinNum30d string no
audienceGroup string no
avgAgmv90d string no
avgLiveViewerNum string no
contentSceneLabel string no
contentTag string no
contentThemeLabel string no
estimateCpuv30d string no
estimatePicReadPrice string no
estimatePictureCpm string no
estimatePictureEngageCost string no
estimateVideoCpm string no
estimateVideoEngageCost string no
estimateVideoReadPrice string no
excludeLowActive boolean no
excludeTradeReportBrandIds boolean no
fansAge string no Fans age distribution
fansChildAgeInfo string no
fansGender string no Fans gender distribution
fansLocation string no
fansNumberLower integer no
fansNumberUpper integer no
fansNumUp boolean no
featureTags string no
gender string no Gender type
industry string no Industry assistant creator recommendation industry
industrySpecificCrowdsMotorDom string no
interMidCoop30 string no
interMidNor30 string no
inviteReply48hNumRatio string no
keyword string no
kliveCnt30d string no
location string no
marketTarget string no
mCpuvNum30d string no
notePrice string no
noteType string no Creator search note type preference
page integer no
personalTags string no
progressOrderCnt string no
readMidCoop30 string no
readMidNor30 string no
searchType string no Search Type
similarUserId string no
similarWord string no
sort string no Creator search sorting
thousandLikePercent30 string no
top20CrowdsLabel string no
tradeReportBrandIds string no
tradeType string no
videoPrice string no

Output

Shape of the run’s result, the expected shape, not yet checked against real answers:

{ code, data: { kols: unknown[], total, trackId, resultType, highlightWords: unk... ...

The shape is cut here. Signed in, looot inspect justoneapi-api-xiaohongshu-pgy-api-solar-cooperator-blogger prints all of it.

Run it

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"justoneapi-api-xiaohongshu-pgy-api-solar-cooperator-blogger","input":{},"wait":30}'
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "justoneapi-api-xiaohongshu-pgy-api-solar-cooperator-blogger",
    input: {},
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "justoneapi-api-xiaohongshu-pgy-api-solar-cooperator-blogger",
        "input": {},
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:creators.search as endpointId; see the job page.

Was this page helpful?