How can I get the most out of the FullContact API?
As you get started using the FullContact API, here are some important tips that'll help you get the best results:
1. Get a free match test
Sample sizes of less than a few hundred can skew results, so the free calls may not suffice to give you a broad sense of how well your data matches with us.
We can run simple free tests or more complex paid pilots to give you a better idea of what results you'd see on a larger scale. Just email us at firstname.lastname@example.org and we'll set it up.
2. Remember: you're charged for matches, not calls
We only charge for successful matches - with the free API plan, you get up to 250 free matches per month.
A "match" is a response where we return fields to your query (a 200 response). Any other response code (404, 202) does not count against your monthly matches.
3. What happens when I make repeated calls for the same query?
Every 200 response counts as a match, even if you've made the query before.
4. 202 responses are normal
A 202 means we haven't seen this query before so we're searching for public information. This search takes two minutes or less. If we haven't found anything by then, we return a 404.
Please see our docs for a complete flowchart of the response codes.
5. Implement webhooks to manage 202s
The best way to deal with 202's is to implement webhooks. We'll POST a response back to your webhook listener when we've completed our search.
You can also make queue calls to seed our API then call back later.
6. 404s are also normal
Sometimes we just can't find public information, due to the person's low social presence, high privacy settings, or the terms of service of some networks. In those cases, we return a 404 response.
7. To retain data, you'll need to upgrade
As a user on the free FullContact API plan, you are required to delete data we provide after seven days. If you upgrade to a paid plan, you can retain data for as long as you are a paying customer.