Xingtu creator search API

Search Creator

GET/v1/xingtu/creators/search

Use the Xingtu creator search API to read public Xingtu creators. Search Creator

Request

Send your API key as a Bearer token. Replace YOUR_API_KEY with a key from your console.

curl "https://xtikapi.com/v1/xingtu/creators/search?keyword=city" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequired
keywordstringoptional
seach_typestringoptional
time_range_daysstringoptional
cursornumberoptional
sort_fieldstringoptional
sortnumberoptional
task_categorynumberoptional
marketing_targetnumberoptional
first_industry_idnumberoptional
author_list_idstringoptional
price_typestringoptional
price_minstringoptional
price_maxstringoptional
tagstringoptional
persona_tagsstringoptional
genderstringoptional
fans_minstringoptional
fans_maxstringoptional
expected_play_minstringoptional
expected_play_maxstringoptional
cpm_minstringoptional
cpm_maxstringoptional
cpe_minstringoptional
cpe_maxstringoptional
interact_rate_minstringoptional
interact_rate_maxstringoptional
play_over_rate_minstringoptional
play_over_rate_maxstringoptional
burst_text_rate_minstringoptional
burst_text_rate_maxstringoptional
extra_filterstringoptional

Response fields

Every platform returns the same account shape. A field the platform does not provide is named in meta.unavailable.

  • id
  • username
  • name
  • url
  • avatar
  • followers
  • description

Example response

Recorded from a live call on 2026-11-18. Names, text, links and images are replaced with examples; counts, dates and field names are real.

{
  "data": {
    "items": [
      {
        "id": "3074185296307418529",
        "name": "Example name",
        "avatar": "https://example.com/image.jpg",
        "followers": 2769272
      },
      {
        "id": "3074185296307418529",
        "name": "Example name",
        "avatar": "https://example.com/image.jpg",
        "followers": 2979018
      }
    ]
  },
  "meta": {
    "request_id": "example",
    "endpoint": "xingtu.creators.search",
    "normalized": true,
    "unavailable": [
      "username",
      "url",
      "description"
    ],
    "billing": {
      "charged": true,
      "amount": 0.004,
      "balance": 4.98
    }
  }
}

Error codes

Errors are not billed. Retry the ones marked yes. More in the API quickstart.

CodeHTTPRetryMeaning
unauthorized401noAPI key is missing, invalid, or revoked.
rate_limited429yesToo many requests.
invalid_params422noRequest parameters are invalid.
price_exceeds_max402noThis call costs more than X-Max-Price.
insufficient_balance402noBalance is too low for this call.
key_limit_reached402noThis API key has reached its spend limit.
idempotency_conflict409noThis Idempotency-Key was already used with different parameters.
idempotency_in_progress409yesA request with this Idempotency-Key is still running.
response_too_large409noThe response is too large to store for a safe retry.
upstream_error502yesThe data provider returned an error. You were not charged.
upstream_timeout504yesThe data provider timed out. You were not charged.
internal_error500yesSomething went wrong on our side. You were not charged.
not_found404noNo such endpoint.

Questions this API answers

Same call on other platforms

Change the platform word in the path. The request and the response shape stay the same.

More Xingtu APIs

Questions

What does the Xingtu creator search API return?

A account object with the fields listed on this page. Missing provider fields are named in meta.unavailable.

When is the Xingtu creator search API billed?

This call costs $0.004 when the provider returns HTTP 200. An empty result is billed. Errors and timeouts are not billed.

What do I do if the provider returns an error?

The response has charged set to false. Read the error code and retry if the error says retry is true. Your balance is unchanged.

Where is this resource on another platform?

Use the links on this page for the same resource and action on other platforms. Change the platform word in the path.