This article answers the questions we receive most often about the SalesQL API.
For endpoint documentation, request parameters, response schemas, and code examples, see the API Documentation
Do I need a LinkedIn account to use the API?
No. API access only requires a valid API key generated from your SalesQL dashboard. A LinkedIn account is not needed.
What can I do with the API?
The SalesQL API lets you:
Enrich individual people using a LinkedIn profile or name and company.
Enrich company records.
Process multiple people or companies in bulk.
Check your available API credits.
For endpoint details, request parameters, and response examples, see the API Documentation
How are credits charged?
Each API call consumes one credit — but only if it returns results. Calls that come back empty don't touch your balance.
What are the daily rate limits?
Every call counts toward your daily limit, regardless of whether it returns results. The limits by plan are:
Plan | Daily calls | Max requests/min |
Professional | 5,000 | 180 |
Organization | 20,000 | 300 |
When you hit the daily limit, the API returns HTTP 429 with the message "Rate limit exceeded". To stay comfortably within the per-minute limit, a pause of around 200ms between consecutive calls is recommended.
Why isn't the API returning results?
SalesQL's search algorithm prioritizes accuracy. If it isn't confident enough in a match, it won't return a result rather than risk a false positive. This doesn't consume a credit.
Common reasons for no results: the LinkedIn profile is private or incomplete, the name/company input is ambiguous, or the contact isn't in our database yet.
Where are the results stored?
API results are not saved to your SalesQL dashboard or extension automatically. If you need to store or reference them later, that's handled on your end.
Can I filter results to return only personal emails?
Yes. You can configure calls to return only personal email addresses instead of a mix of personal and business. See the Person endpoint documentation for the exact parameter.
How do I know if an email or phone number is verified?
The API response includes a mail_status field that distinguishes between verified and unverified email addresses, and an is_valid boolean for phone numbers. Empty arrays mean no email or phone was found for that contact.
What's not allowed?
Making automated requests against non-public or undocumented endpoints is prohibited and can result in account suspension. Reselling or redistributing SalesQL data to third parties is also not permitted under our Terms of Service.
Please visit the API documentation page for more information on supported API requests.