Convert Channel ID to Finder Username

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel_id": "sphi9BjV8GK0Zsl",
  "raw": false
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username"

payload = {
    "channel_id": "sphi9BjV8GK0Zsl",
    "raw": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({channel_id: 'sphi9BjV8GK0Zsl', raw: false})
};

fetch('https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'channel_id' => 'sphi9BjV8GK0Zsl',
    'raw' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username"

	payload := strings.NewReader("{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "request_id": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles",
  "docs": "<string>",
  "cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
  "cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "router": "",
  "params": {},
  "data": "<unknown>"
}

POST

https://api.aisa.one/apis/v1

tikhub

wechat_channels

fetch_channel_id_to_username

Convert Channel ID to Finder Username

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel_id": "sphi9BjV8GK0Zsl",
  "raw": false
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username"

payload = {
    "channel_id": "sphi9BjV8GK0Zsl",
    "raw": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({channel_id: 'sphi9BjV8GK0Zsl', raw: false})
};

fetch('https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'channel_id' => 'sphi9BjV8GK0Zsl',
    'raw' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username"

	payload := strings.NewReader("{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"channel_id\": \"sphi9BjV8GK0Zsl\",\n  \"raw\": false\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "request_id": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles",
  "docs": "<string>",
  "cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
  "cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "router": "",
  "params": {},
  "data": "<unknown>"
}

Convert Channel ID to Finder Username Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.

Response structure is not yet fully documented — refer to the actual API response.

Example

curl -X POST "https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below

Authorizations

Authorization

string

header

required

AIsa API key. Get yours at https://aisa.one

Body

application/json

channel_id

string

required

WeChat Channels ID (short ID starting with sph

Usage: Channel ID (sph… short ID), e.g. sphi9BjV8GK0Zsl (People's Daily). Must start with sph.

Maximum string length: 64

Pattern: ^sph[A-Za-z0-9_-]+$

Example:

"sphi9BjV8GK0Zsl"

raw

boolean

default:false

True=raw response; False=simplified parsed structure

Response

200 - application/json

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

Return

Resolved finder username plus account nickname and description

Response structure & JSON Path

`raw=false` (simplified):

Input echo: $.data.channel_id
Resolved finder username (feed directly into downstream endpoints): $.data.username
Account nickname (search highlight markers stripped): $.data.nickname
Account description: $.data.desc (may be null)
On miss: $.data.username is null with an explanation at $.data.error

`raw=true` (raw):

Result groups: $.data.data[N] (each group has type + items[] / subBoxes[].items[])
Finder username inside account items: $.data.data[N].items[M].jumpInfo.userName or $.data.data[N].items[M].noticeParam.finderUsername
Title / description: $.data.data[N].items[M].title / .desc
Others: $.data.query (query echo), $.data.continueFlag, $.data.offset
Mapping: username / nickname / desc of raw=false are extracted from the first @finder account item in data[].items[] (or subBoxes[].items[]) of raw=true.

code

integer

default:200

HTTP status code

request_id

string | null

Unique request identifier

message

string

default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh

string

default:请求成功，本次请求将被计费。

Response message (ZH-CN)

support

string

default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time

string

The time the response was generated

time_stamp

integer

The timestamp the response was generated

time_zone

string

default:America/Los_Angeles

The timezone of the response time

docs

string | null

Link to the API Swagger documentation for this endpoint

cache_message

string | null

default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh

string | null

default:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url

string | null

The URL to access the cached result

router

string

default:""

The endpoint that generated this response

params

any

default:{}

The parameters used in the request

data

any | null

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

Overview

Chat API

Embeddings & Rerank

Search API

Exa API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

Duffel Flights

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

TikHub API

Convert Channel ID to Finder Username

Example

Authorizations

Body

Response

Return

Response structure & JSON Path

`raw=false` (simplified):

`raw=true` (raw):

​Example

Authorizations

Body

Response

Return

Response structure & JSON Path

raw=false (simplified):

raw=true (raw):

Example

`raw=false` (simplified):

`raw=true` (raw):