Clearbit Discovery API

[gabebw]

The tentatively proposed interface for the Clearbit Discovery API (#2) is:

clearbit discover --tech marketo --sort alexa_asc

The actual query API is quite rich, supporting many fields, and and or queries, etc. It seems like a nice approach would be to support a few important fields as flags (--tech above), and then allow users to write more complex queries directly if needed.

Looking through Clearbit's supported discovery fields, the most likely to warrant flags look to be:

• employees
• location
• raised
• tech

[harlow]

We've also created our own DSL for searching which we'll parse on the backend.

Might be easier to allow person to submit a string query instead of having the library know about each attribute

clearbit discover --query 'employees:~100 or:(tech:marketo tech:google_apps)'  --sort alexa_asc

https://clearbit.com/docs#discovery-api-andor-queries