# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snov.io Email Finder API
  version: 1.0.0
extends: openapi/snov-io-email-finder-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/v2/emails-by-domain-by-name/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Find emails from a person's name and domain
      effect: read
      questions:
      - Can I find someone's email if I know their name and company domain?
      - How many credits does finding an email by name cost?
      - Can results be sent to a webhook when they're ready?
      instructions:
      - text: 'Find emails for these name and domain rows: {rows}.'
        slots:
          rows: requestBody.rows
      - text: Look up emails for {rows} and post results to {webhook_url}.
        slots:
          rows: requestBody.rows
          webhook_url: requestBody.webhook_url
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/emails-by-domain-by-name/result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get find-emails-by-name results
      effect: read
      questions:
      - Where do I pick up the emails found from names and domains?
      - Is my name-to-email lookup finished?
      instructions:
      - text: Get the name-to-email results for task {task_hash}.
        slots:
          task_hash: query.task_hash
      - text: Fetch emails found by name lookup task {task_hash}.
        slots:
          task_hash: query.task_hash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/company-domain-by-name/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Find company domains from company names
      effect: read
      questions:
      - I only have company names — can I find their website domains?
      - What does it cost to look up a domain from a company name?
      instructions:
      - text: Find domains for companies {names}.
        slots:
          names: requestBody.names
      - text: Look up website domains for {names} and notify {webhook_url}.
        slots:
          names: requestBody.names
          webhook_url: requestBody.webhook_url
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/company-domain-by-name/result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get company-name-to-domain results
      effect: read
      questions:
      - Where do I get the domains found for my company names?
      - Has my company domain lookup by name completed?
      instructions:
      - text: Get company domain results for task {task_hash}.
        slots:
          task_hash: query.task_hash
      - text: Fetch the domains found by company-name task {task_hash}.
        slots:
          task_hash: query.task_hash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/li-profiles-by-urls/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Enrich LinkedIn profiles by URL
      effect: read
      questions:
      - Can I get contact details from a list of LinkedIn profile URLs?
      - How many credits does LinkedIn profile enrichment use?
      instructions:
      - text: Enrich LinkedIn profiles {urls}.
        slots:
          urls: requestBody.urls
      - text: Enrich LinkedIn URLs {urls} and send results to {webhook_url}.
        slots:
          urls: requestBody.urls
          webhook_url: requestBody.webhook_url
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/li-profiles-by-urls/result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get LinkedIn profile enrichment results
      effect: read
      questions:
      - Where are the enriched LinkedIn profiles I requested?
      - Is my LinkedIn URL enrichment task done?
      instructions:
      - text: Get LinkedIn enrichment results for task {task_hash}.
        slots:
          task_hash: query.task_hash
      - text: Fetch enriched LinkedIn profiles for task {task_hash}.
        slots:
          task_hash: query.task_hash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/get-profile-by-email'].post
  update:
    x-apievangelist-phrasing:
      intent: Enrich a person's profile from an email
      effect: read
      questions:
      - Can I find out who's behind an email address — name, job, company?
      - Am I charged a credit if no profile is found for an email?
      instructions:
      - text: Get the profile for {email}.
        slots:
          email: requestBody.email
      - text: Enrich prospect details from email address {email}.
        slots:
          email: requestBody.email
      method: generated
      generated: '2026-10-01'