API Key & Access
How do I create a RocketReach API key?
Go to Account Settings and click “Generate New API Key.”
Tracking Usage & Rate Limits
Can I track my team’s API usage?
Yes—use the /v2/account endpoint to view current usage.
Can I track my team’s rate limits?
Yes—use the /v2/account endpoint. For full details, refer to our Rate Limits Guide.
Testing the API
How can I test different endpoints?
Use the “Try it” feature in the API documentation to make live calls.
What Can I Do with the API?
- Find people & companies: Use People and Company Search with filters (e.g., title, location, industry).
- Enrich data: Append or update emails, phones, and firmographics for single or bulk contacts.
- Build integrations: Embed lookups, searches, exports, etc., into your application.
Credits & Billing
How do credits get charged?
| Credit Type | When It's Used |
|---|---|
| Premium Credit | A or A- grade email or valid phone |
| Standard Credit | A or A- grade email only |
| Enrich Credit | When the contact exists in our database |
| Company Credit | When any company information is returned |
If I re-lookup the same profile, am I charged again?
No—re-lookups and updates are free as long as your plan is active.
Can I use my API credits on the UI?
Yes! In the UI, these are called Exports.
1 Export = 1 API Credit
Email Grades & Preferences
What do the email grades mean?
| Grade | Deliverability |
|---|---|
| A | ~98% - Personal: >99%, Professional: >97% |
| A- | ~90% |
| B | 75–85% |
| F | Invalid - o not send |
Can I set an email preference (personal vs. professional)?
Yes—go to Account Settings → Other Settings and choose your preferred email type.
Only that type will be shown, and credits are only charged if it’s found.
Search Functionality
How can I ensure profiles with phone or email appear in search?
Use the contact_method parameter in your search call.
Can I suppress (hide) certain profiles from search?
Yes—upload a Suppression List (via LinkedIn URL or Name & Company) in Account Settings.
How are search results paginated?
- Up to 100 profiles per page
- Max 10,000 results per query
- Narrow search with filters if over the limit
Why doesn't the data in a profile match the API?
This should almost never happen. Contact support if you notice discrepancies.
Why don't UI and API search results match?
The UI uses NLP for search facets. Try adjusting:
facetfiltersorder_byparameter- Use exact match around values
Errors & Troubleshooting
What do these API errors mean?
See our Errors Guide for full explanations and troubleshooting tips.
Why am I getting 429 (rate limited) errors?
Rate limits depend on your plan. Contact us to upgrade. More help: Rate Limits
Teaser & Data Availability
What does the “teaser” include?
A teaser gives a hint of data availability. Final lookups may reveal more, even if the teaser appears empty.
Why does the teaser only show phone numbers and no emails?
Teaser data is only shown if it’s cached.
Do I get charged a credit if no data is returned?
- Lookups: No credit is charged if no data is found
- Searches: Metered, but ~10,000/day are free on paid API plans
- B or F grade emails: No credits are charged
How do I know if RocketReach has data for a profile?
- 87% of lookups return profiles
- LinkedIn URLs return data 99% of the time
- Even if teaser is empty, final lookup may still return data due to real-time validation