Twitter (X) API · Discovery Attribute reference

Twitter (X) Account AI natural-language search API

Find Twitter (X) profiles by aI natural-language search from 122.9M searchable profiles

Is there an API to search Twitter (X) creators with natural language?

Yes. The Influencers.club Discovery API filters Twitter (X) creator profiles by a plain-language description of who you’re looking for, mapped to filters automatically. Describe the search in a sentence — like “fitness coaches in Texas with over 10k followers” — the AI maps it to structured filters (explicit filters always win), and get back full profiles with follower counts, engagement rates and verified contact data.

Verified against the live API in Endpoint reference →

How many Twitter (X) profiles this filter returns

Counted on the live search index, not modelled or rounded.

Measured
122,888,505
Searchable Twitter (X) profiles
69
Match “crypto traders with 10k+ followers”, the example below
0.00%
Share of the searchable index
9
Of those, with 100k+ followers
Request

Make the call

Both samples below are complete. Paste one in, swap the key, get a 200.

POST https://api-dashboard.influencers.club/public/v1/discovery/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.01 credits per creator returned Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/discovery/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "platform": "twitter",
  "filters": {},
  "nlp_search": "crypto traders with 10k+ followers",
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/discovery/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
  "platform": "twitter",
  "filters": {},
  "nlp_search": "crypto traders with 10k+ followers",
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/discovery/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "platform": "twitter",
  "filters": {},
  "nlp_search": "crypto traders with 10k+ followers",
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/discovery/");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json", ]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "platform": "twitter", "filters": {},
  "nlp_search": "crypto traders with 10k+ followers", "paging": { "limit": 10, "page": 0 }, "sort": { "sort_by": "relevancy" }}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{
  "platform": "twitter",
  "filters": {},
  "nlp_search": "crypto traders with 10k+ followers",
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/discovery/", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
Response

What comes back

A 200 with the page of creators and your remaining credit balance. Creator values below are elided — field names and types are exactly as published in the API schema.

200 OKJSON
{
  "total": 69,
  "limit": 10,
  "accounts": [ … ],
  "credits_left": 361.22 }
Response fields 10 always returned · 3 on request
FieldTypeMeaning
Envelope · 4 fields
totalintegerCreators matching the filter set, before paging.
limitintegerPage size, echoed back from the request.
credits_leftstringDecimal balance after this call.
accounts[]arrayThe requested page of creators.
accounts[] · one entry per creator · 6 fields
user_idstringThe creator’s unique platform identifier.
profile.full_namestringDisplay name.
profile.usernamestringHandle on the platform.
profile.picturestringProfile picture URL.
profile.followersintegerFollower count.
profile.engagement_percentfloatEngagement rate relative to followers.

Three more appear conditionally: matched_filters with return_filter_values=true, and applied_filters plus nlp_search when you send a natural-language brief.

Parameters

The spec

Parameter Type Accepted values Behaviour
filters.nlp_search string A structured object — see the endpoint reference Combines with all other filters in the same request.
platform string instagram · youtube · tiktok · twitch · twitter · onlyfans Required. Selects the platform-specific filter set.
paging.limit / paging.page integer Any positive integer Required. Page numbering starts at 0.
sort.sort_by / sort.sort_order string relevancy · asc / desc Optional. Defaults to descending.
return_filter_values boolean true · false Adds the matched filter values to each creator. Bills 0.03 credits instead of 0.01.

Billing. 0.01 credits per creator returned. If no creators are returned, no credits are deducted.

Recipes

AI natural-language search is rarely the only filter

Three combinations that people actually send. Every filter below exists today.

A brief in one sentence

Skip the filter syntax; describe the creator instead.

filters: {
  "nlp_search": "fitness coaches in Texas with 10k+ followers",
  "engagement_percent": { "min": 2 } }

Natural language plus hard constraints

Let the AI draft the search, then pin the filters that matter.

filters: {
  "nlp_search": "fitness coaches in Texas with 10k+ followers",
  "has_link_in_bio": true }

Plain-language search, verified output

The response shows exactly which filters were applied.

filters: {
  "nlp_search": "fitness coaches in Texas with 10k+ followers",
  "number_of_followers": { "min": 10000, "max": 100000 } }

Other Twitter (X) data you can access

Twitter (X) API endpoints

Platform coverage

Six platforms with full data, 40+ more in the social graph

Plus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.

FAQ

Frequently asked questions

How do I structure the aI natural-language search filter?+

It’s a structured object — the exact shape is in the endpoint reference, and the code samples above show a working example.

Where can I find my API key?+

Create a free account. You will find your API key through the API side menu.

How do I find creators with natural language using your API?+

Simply sign up for free, copy your API key, then POST to the Discovery endpoint with filters.nlp_search set. You’ll get Twitter (X) profiles ready to be ingested for your use case.

What are your pricing plans and what do they include?+

Paid plans start at $249/month and use a flexible credit-based model.

Each API call consumes a specific number of credits depending on the endpoint and data depth. You can compare all tiers, credit amounts, and per-endpoint costs in the Pricing section of our API docs.

How can I get in touch with your team?+

Book a time on our calendar to talk to someone from our team and learn about the full capabilities of our API.