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.
1 credit / profile
for successful requestsPricing 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 get97
, you will only be charged for97
.
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
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 foundMust be provided as a multiple of 10Default: 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
.
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
.
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 accountX-Credits-Expire
A datetime string with the expiration dateX-Credits-Used
The number of credits the operation consumedErrors are handled in line with our Error Rules. Please make sure to read it carefully and follow the instructions for the best experience possible.