Twitter Affiliates API | Org Sub-Account Lookup

User Affiliates lists the accounts affiliated under an organization's Verified Organizations profile, returned as cursor-paginated user objects. Use it to map a company to its linked employee and brand accounts. Pass the organization handle; each page is one $0.0008 standard read with bearer auth.

curl -X GET "https://example.com/user/affiliates?username=stripe&user_id=44196397&count=20"

{  "users": [    {      "id": "12345",      "username": "stripedev",      "name": "Stripe Developers",      "verified": true    }  ],  "next_cursor": ""}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

Each page is one $0.0008 read, though most orgs return their affiliates in a single page, so cost is usually one call.

When to use

Use it to map an org to its sub-accounts, for example listing a company's verified employee and brand profiles.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

Related endpoints

• User About: Fetch a profile's extended About / professional details.
• User Info by Username: Fetch a full profile by @handle.
• List Members: Page through the members of a public Twitter/X List.

FAQ

What are affiliated accounts?

They are the employee and brand accounts linked under an organization's Verified Organizations profile, showing the org affiliation badge.

Which accounts have affiliates?

Only Verified Organizations profiles. A standard personal account returns no affiliates, so target company handles.

What does each affiliate row return?

Each row is a full user object, so you get the handle, name, and verification of every affiliated account in one pass.