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:

facet filters
order_by parameter
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