find-influencers
Installation
SKILL.md
Find X Influencers
Find active X accounts in a niche by bio/handle search with follower and activity filters. Read-only.
Endpoints
| Endpoint | Purpose | Cost |
|---|---|---|
| POST /extractions with toolType=people_search | User search by keyword/bio | Per-row |
| POST /extractions/estimate | Preview credit cost before running | Free |
| GET /x/users/{username} | Profile snapshot for shortlisted accounts | Read tier |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Quick reference
POST /extractions/estimate
{ "toolType": "people_search", "searchQuery": "crypto trader" }
POST /extractions
{ "toolType": "people_search", "searchQuery": "crypto trader" }
-> 202 { "id": "<extractionId>", "toolType": "people_search", "status": "running" }
The server only accepts toolType and searchQuery. Follower-count filters and verified-only shortlists happen after extraction, on the returned rows.
Typical flow
- Ask the user for the niche keyword and any follower-range / verified preferences (applied client-side).
- Call
POST /extractions/estimate, show the cost. - On approval,
POST /extractions. - Poll
GET /extractions/{id}untilcompleted. - Retrieve
GET /extractions/{id}/results?cursor=<cursor>and filter locally byfollowers_countrange andverifiedflag. - Optionally enrich the shortlist with
GET /x/users/{username}for recency signals. - Export via
GET /extractions/{id}/export?format=csvif raw data is needed.
Ethics note
This skill is for discovery and research. Do not use to mass-DM, mass-follow, or run automated outreach. If the user wants outreach, they must review each target before any action.
Related
Reach out: send-dms (single DM with confirmation). Full API: x-twitter-scraper.