Search X community members by name or username

{
  "users": [
    {
      "id": "641633",
      "username": "marckohlbrugge",
      "name": "Marc Köhlbrugge",
      "communityRole": "Admin",
      "profilePicture": "https://pbs.twimg.com/profile_images/1857124042433572864/iMivVaYP_normal.jpg"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

communities

{id}

members

Search X community members by name or username

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/{id}/members/search

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/communities/{id}/members/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/members/search"

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

{
  "users": [
    {
      "communityRole": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.

1 credit per member returned · An answer without members is free · All plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/communities/1493446837214187523/members/search?q=marckohlbrugge" \
  -H "x-api-key: xq_your_api_key_here" | jq

const communityId = "1493446837214187523";
const params = new URLSearchParams({ q: "marckohlbrugge" });
const response = await fetch(
  `https://xquik.com/api/v1/x/communities/${communityId}/members/search?${params}`,
  { headers: { "x-api-key": "xq_your_api_key_here" } },
);
const page = await response.json();
if (!response.ok) throw new Error(JSON.stringify(page));

const memberRows = page.users.map((user) => ({
  community_id: communityId,
  member_id: user.id,
  username: user.username,
  name: user.name,
  role: user.communityRole ?? null,
  followers: user.followers ?? null,
}));
process.stdout.write(JSON.stringify(memberRows, null, 2));

import json
import requests

community_id = "1493446837214187523"
response = requests.get(
    f"https://xquik.com/api/v1/x/communities/{community_id}/members/search",
    params={"q": "marckohlbrugge"},
    headers={"x-api-key": "xq_your_api_key_here"},
)
page = response.json()
if not response.ok:
    raise RuntimeError(page)

member_rows = [
    {
        "community_id": community_id,
        "member_id": user["id"],
        "username": user["username"],
        "name": user["name"],
        "role": user.get("communityRole"),
        "followers": user.get("followers"),
    }
    for user in page["users"]
]
print(json.dumps(member_rows, indent=2))

Find members by name

Use GET /x/communities/{id}/members/search to check whether people belong to a Community. It works like the search box on x.com’s members page. X checks up to 10 accounts whose name or username starts with q. The answer holds the members among them, in X’s order. Each row is a full profile with its communityRole: Admin, Moderator or Member. A name that finds only people outside the Community returns an empty users list. That answer is free. Try the exact username when a common name finds no member. All results fit in 1 answer, so has_next_page is false. To list every member, use Community members.

Path parameters

string

required

Community ID (numeric string), such as 1493446837214187523.

Query parameters

string

required

Name or username to find members by, such as marckohlbrugge. A leading @ is dropped. Alias: query.

User result filters

These filters apply before billing. Selective filters can return fewer rows.

integer

Require this minimum follower count. Filtering happens before billing.

integer

Allow this maximum follower count. Missing counts pass this filter.

integer

Require this minimum following count.

integer

Allow this maximum following count. Missing counts pass this filter.

integer

Require this minimum post count.

integer

Allow this maximum post count. Missing counts pass this filter.

integer

Require this minimum account age in days.

boolean

When true, only return verified profiles.

string

Match the exact verification type.

boolean

When true, require a profile website.

boolean

When true, require a profile location.

string

Require every comma-separated or line-separated bio term.

string

Require this text in the profile location.

string

Require this text in the username.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Members X found for the name, in X’s order. Each holds the same profile fields as Community members, such as id, username, name, followers & verified.

string

The member’s role in the Community: Admin, Moderator or Member.

boolean

Always false. X sends all results in 1 answer.

string

Always an empty string.

400 Missing name or invalid Community ID

{ "error": "missing_query" }

Send a name or username in q. A Community ID must be numeric, or the answer is invalid_community_id.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

Missing or invalid API key.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

{
  "users": [
    {
      "id": "641633",
      "username": "marckohlbrugge",
      "name": "Marc Köhlbrugge",
      "communityRole": "Admin",
      "profilePicture": "https://pbs.twimg.com/profile_images/1857124042433572864/iMivVaYP_normal.jpg"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Search X community members by name or username

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/{id}/members/search

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/communities/{id}/members/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/members/search"

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

{
  "users": [
    {
      "communityRole": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Search X community members by name or username

Find members by name

Path parameters

Query parameters

User result filters

Headers

Response

200 OK

400 Missing name or invalid Community ID

401 Unauthenticated

402 Payment required

429 Rate limit exceeded

502 X API unavailable

​Find members by name

​Path parameters

​Query parameters

​User result filters

​Headers

​Response

​200 OK

​400 Missing name or invalid Community ID

​401 Unauthenticated

​402 Payment required

​429 Rate limit exceeded

​502 X API unavailable

Find members by name

Path parameters

Query parameters

User result filters

Headers

Response

200 OK

400 Missing name or invalid Community ID

401 Unauthenticated

402 Payment required

429 Rate limit exceeded

502 X API unavailable