Buying Committee DealMap

Map the buying committee for a prospect company — stakeholder roles, org hierarchy, and top picks.

Read the current DealMap

Send a GET request to check if a buying committee map already exists for a product and company. This is a free operation.

curl "https://dealsurface.com/api/v2/dealmap?product_id=12&ticker=TRV" \
  -H "Authorization: Bearer $DEALSURFACE_API_KEY"

Generate or refresh the DealMap

If the DealMap is empty or stale, generate it with a POST request. The endpoint fetches the org chart and uses AI to assign buying committee roles to each stakeholder.

curl -X POST https://dealsurface.com/api/v2/dealmap/generate \
  -H "Authorization: Bearer $DEALSURFACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 12, "ticker": "TRV"}'

Caching and billing

The DealMap generation endpoint caches results to minimize costs:

Cached org chart — the org chart was already fetched recently (org_cache), or the annotated DealMap is reused (annotated_cache_hit). No charge.
Fresh org chart fetch — no cached org chart exists. A fresh fetch is performed (org_fresh). A successful fresh empty org result supplemented with people (org_fresh_empty) has the same price. 10 credits charged.

Check the credits_charged and generation_source fields in the response to understand what happened.

Use force_refresh with caution

Setting force_refresh: true requests a fresh fetch. Successful fresh results cost 10 credits; failed generation is not charged. Only use this when you know the cached data is stale and need fresh org chart data.

Stakeholder data fields

Each stakeholder includes:

full_name and title — the contact's name and position.
stakeholder_role — AI-assigned buying committee role (Economic Buyer, Decision Maker, Champion, Executive Sponsor, Evaluator, Blocker, etc.).
is_top_pick — whether this person is the recommended contact for their role.
level — seniority bucket (c_suite, vp, director, manager).
linkedin_url — direct LinkedIn profile link (when available).
annotation_reason — why this role was assigned.

Next steps

Pass a stakeholder to the outreach endpoint to generate a personalized message for that contact.

Ranking Prospects Crafting Outreach