APIs Pricing
Login

Twitter/X Profiles API (V1)

The Twitter/X Profiles API lets you find up to 1000 Twitter user profiles with the help of Google's Twitter index - all of which are based on your keyword/search query. Its best use-case is to find profiles that have your query in their handle, username, or have engaged with content related to your search term within the past year.

  • Endpoint cost is 1 credit / profile for successful requests

Pricing Note:

While we aim to provide you with the exact number of results you request. In some cases, certain restrictions will cause the number of returned results to be less than requested. Example: No more rows to be found OR duplicate removal.

You will only pay per result delivered. If you request 100 profiles and get 97, you will only be charged for 97.

Input Processing

To keep your query from breaking or returning unexpected results, we sanitize your input as follows:

  • Leading and trailing empty spaces are removed: ' foo ' --> 'foo'

  • Multiple consecutive spaces are collapsed: 'foo bar' --> 'foo bar'

  • The characters " : ( ) are not allowed

Request Parameters

  • API Endpoint: POST https://api.serpgrid.dev/v1/serps/twitter-profiles

  • Required headers: X-API-KEY and Content-Type

Parameter Description
query Your search term
The following characters are NOT allowed: " : ( )
Min length: 3 characters
Max length: 30 characters
results The maximum number of rows to be returned if found
Must be provided as a multiple of 10
Default: 10
Min: 10 & Max: 1000

Execution Time:

Due to the nature of how we request, parse, and sanitize these results in real-time for you, the larger number of results you request, the longer this endpoint will take.

Our target running time for the maximum result count of 1000 is ~7-10 seconds.

Useful Tips

For best results, try searching for segmented target audience groups such as software engineer or pet owner.

Note: Running the same query multiple times will often generated identical results. You are therefore encouraged to find a set of keywords or queries that are of interest and run them in series.

Example: If you're interested in finding mortgage brokers, you can run that as your first query, and later on run a separate request for loan officer or perhaps real estate agent.

Request Example 1

json icon Twitter/X Profiles Request
json icon Twitter/X Profiles Response

Additional Information

The following headers will also be returned as part of the response to you:

  • X-Credits-Remaining The number of credits that remain in your account
  • X-Credits-Expire A datetime string with the expiration date
  • X-Credits-Used The number of credits the operation consumed

Errors are handled in line with our Error Rules. Please make sure to read it carefully and follow the instructions for the best experience possible.