Competitive Displacement List
Turn a competitor’s customer base into a ranked outreach list by chaining the Product Catalog, Vendorgraphics, and Discover.
Step paths below are relative — every request also needs the version and environment prefix,
https://api.aggknowledgeai.com/v2/{environment}. So POST /person/enrich is called at https://api.aggknowledgeai.com/v2/test/person/enrich. See Environments.1
Resolve the productGET /vendorgraphics/products
Look up the competitor’s product in the catalog and store its ID — all vendorgraphic queries key off catalog IDs.
2
Pull their customersPOST /vendorgraphics/search/customers/by-product
Product customer search returns the companies using that product. Filter by firmographics to match your serviceable market.
3
Find the peoplePOST /discover/people/advanced
Feed the company IDs into Discover with
workExperience.role/seniority filters for the buyers and users of that product category.4
Enrich the shortlistPOST /person/enrich
Full records for the people who survive qualification — this is the call that consumes credits, so run it on the shortlist only.
5
Request contact infoPOST /person/contact-info
Async batch for the final qualified set. On v3 the path is
POST /contact-info — the resource moves out from under /person. See Retrieve Contact Info at Scale.Tip: Combine with a job-change filter: people who used the competitor’s product at their previous company are warm champions at their new one. Person role vendorgraphics confirms the exposure.