Get X Handle API - AI-Powered X/Twitter Handle Lookup

API Overview

This API uses advanced AI processing and multiple data sources to identify and return the most relevant X (formerly Twitter) handle for a given lookup value. Simply provide a person's name, organization, team, title, or descriptive phrase to retrieve the corresponding X handle along with a confidence score.

Flexible Lookup

Search by person name, organization, team name, job title, or descriptive phrase to find the right X handle.

Confidence Scoring

Each result includes a confidence score indicating the reliability of the returned handle match.

Broad Coverage

Find X handles for sports teams, business leaders, government entities, public figures, and organizations worldwide.

Premium API

This is a premium API that utilizes AI processing, multiple data sources, and enhanced matching algorithms to accurately identify X handles for a wide range of entities.

5 credits per API call

Sample Results ("San Francisco 49ers Football")

Field	Example Value	Description
`Handle`	@49ers	The X (Twitter) handle for the entity
`ConfidenceScore`	99	Confidence level of the handle match (0-100)
`Code`	Success	Status code of the API response
`Credits`	201027	Remaining account credits

API Details

Endpoint

https://api.interzoid.com/getuserxhandle

Request Format

https://api.interzoid.com/getuserxhandle?license=[licensekey]&lookup=[person, organization, team, or entity]

Sample Request

https://api.interzoid.com/getuserxhandle?license=fh5hs7*****&lookup=sf 49ers

Sample Response

{ "Handle": "@49ers", "ConfidenceScore": "99", "Code": "Success", "Credits": "201027" }

cURL Example (with API key in header)

curl --header "x-api-key: fh5hs7*****" "https://api.interzoid.com/getuserxhandle?lookup=sf%2049ers"

Additional Examples

Here are additional real-world examples showing the API's versatility across different types of entities:

Business Leader Business

{ "Handle": "@ajassy", "ConfidenceScore": "99", "Code": "Success", "Credits": "5353" }

Lookup: "amazon ceo"

City Government Government

{ "Handle": "@Chicago", "ConfidenceScore": "99", "Code": "Success", "Credits": "-6704" }

Lookup: "chicago city government"

World Leader Politics

{ "Handle": "@Claudiashein", "ConfidenceScore": "99", "Code": "Success", "Credits": "949921" }

Lookup: "president of mexico"

Sports Team Sports

{ "Handle": "@49ers", "ConfidenceScore": "99", "Code": "Success", "Credits": "201027" }

Lookup: "sf 49ers"

These examples demonstrate the API's ability to resolve X handles across diverse categories including sports teams, business executives, government entities, and world leaders using natural language lookup values.

Code Examples, Database Queries, and Specifications

Usage Examples

See quick and easy code examples in multiple programming languages, including Python, Node.js, Java, Typescript, and Go. Also see how to use within database queries on popular database platforms and open specifications such as OpenAPI.

See All Examples

Additional Resources

Try this API Interactively

Our API interactive usage tool enables you to try this API interactively with a user interface and without writing code. The tool is available for all of our APIs.

Try it Now

Use this API in a High-Performance, No-Code, Cloud Batch Mode

Our No-Code batch tool enables you to quickly use this API within our parallel-processing Cloud platform, processing text files (CSV/TSV) with a few clicks and without writing code. This is the fastest and easiest way to use this API with higher volumes of data, enabling results in minutes.

Start Now