How Credits and Daily Rate Limits Work with API Calls
Credit Consumption: Each API call consumes one credit, but only if it returns results. If no results are returned, your credit balance remains unchanged.
Daily Rate Limits: Every API call contributes to the daily rate limit, regardless of whether results are returned. This limit is independent of credit usage and is based on the number of calls made within a 24-hour period.
The Starter and Advanced plans, as well as the Pro Monthly plan: all have a daily rate limit of 600 API calls. This means you can make up to 600 calls per day without exceeding the limit.
Exceeding Limits: The Pro 6 Semi-Annual subscription offers a higher limit of 20,000 calls per day for users needing greater capacity beyond the Starter and Advanced plans.
Limit Notification: When the daily rate limit is reached, the HTTP status code 429 is returned, accompanied by a "Rate limit exceeded" message.
Using SalesQL API: Accessing the SalesQL API does not require a valid LinkedIn account. Simply having an API key generated from the enrichment dashboard or documented in readme.io is sufficient.
Data Storage: Results from SalesQL API calls are not stored in the dashboard or extension by default. This includes contact information retrieved via API, which can be accessed programmatically.
Mail Status: The API distinguishes between verified and unverified email addresses through the "mail status" field.
Verifying Phone and Email Validity: The API now includes fields for verifying phone numbers and email addresses. Phone validity is indicated by the "is_valid" boolean field, while email status appears as "Valid" or "Unverifiable." Empty arrays indicate absence of emails or phones for a contact.
Managing API Rate Limits and Daily Quotas: For efficient usage, maintain a maximum rate of 50 requests per minute, with a recommended 200-millisecond pause between calls. The daily limit of 600 calls can be reached within 12 minutes at full capacity. In the Pro 6 plan with 20,000 daily calls, maintain the same 50 requests per minute pace, allowing for up to 400 minutes (6 hours and 40 minutes) of continuous usage.
💡 The API KEY header is mandatory for every request to our service.
Why Can’t the API Find Results?
Even though SalesQL boasts a massive database of B2B contacts, our search algorithm is all about precision. If there's any doubt about the accuracy of the results, it won’t show them. To keep our accuracy rate high and false positives low, sometimes results might not appear.
Prohibited Practices: 🚫
Automating requests against non-public API endpoints is strictly prohibited and does not align with our usage guidelines. Such actions can result in account suspension and potential loss of access to our services. ⚠️ Users are expected to adhere to the established rate limits and guidelines to ensure fair usage and optimal performance of the SalesQL API. For detailed information regarding our terms and conditions, please refer to our Terms of Service
Please visit the API documentation page for more information on supported API requests.