# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Lusha Lookalikes API
  version: 1.0.0
extends: openapi/lusha-lookalikes-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v3/contacts/lookalike'].post
  update:
    x-apievangelist-phrasing:
      intent: Find people similar to seed contacts
      effect: read
      questions:
      - How do I find more people like my best customers' buyers?
      - Can I save contact lookalike results straight into a table?
      - How many seed contacts do I need to get lookalike people?
      instructions:
      - text: Find contacts similar to seeds {seeds} and save them to table {tableId}.
        slots:
          seeds: requestBody.seeds
          tableId: requestBody.tableId
      - text: Get {limit} more lookalike people for session {dedupeSessionId} using seeds {seeds}.
        slots:
          limit: requestBody.limit
          dedupeSessionId: requestBody.dedupeSessionId
          seeds: requestBody.seeds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/companies/lookalike'].post
  update:
    x-apievangelist-phrasing:
      intent: Find companies similar to seed accounts
      effect: read
      questions:
      - How do I find more companies like my best customers?
      - Can I store company lookalike results in a companies table?
      - Can I keep existing customers out of company lookalike results?
      instructions:
      - text: Find companies similar to seeds {seeds} and save them to table {tableId}.
        slots:
          seeds: requestBody.seeds
          tableId: requestBody.tableId
      - text: Find accounts like {seeds} but exclude {exclude}.
        slots:
          seeds: requestBody.seeds
          exclude: requestBody.exclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/lookalike/contacts'].post
  update:
    x-apievangelist-phrasing:
      intent: Find lookalike contacts (older endpoint)
      effect: read
      questions:
      - Is there an older lookalike contacts endpoint without table saving?
      - How does the legacy contact lookalike run avoid returning the same people twice?
      instructions:
      - text: Using the older lookalike contacts endpoint, find people like {seeds}.
        slots:
          seeds: requestBody.seeds
      - text: Continue legacy contact lookalike run {dedupeSessionId} for seeds {seeds}, excluding {exclude}.
        slots:
          dedupeSessionId: requestBody.dedupeSessionId
          seeds: requestBody.seeds
          exclude: requestBody.exclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/lookalike/companies'].post
  update:
    x-apievangelist-phrasing:
      intent: Find lookalike companies (older endpoint)
      effect: read
      questions:
      - Is there an older lookalike companies endpoint without table saving?
      - How long does a legacy company lookalike session keep its history?
      instructions:
      - text: Using the older lookalike companies endpoint, find accounts like {seeds}.
        slots:
          seeds: requestBody.seeds
      - text: Continue legacy company lookalike run {dedupeSessionId} for seeds {seeds}, up to {limit} results.
        slots:
          dedupeSessionId: requestBody.dedupeSessionId
          seeds: requestBody.seeds
          limit: requestBody.limit
      method: generated
      generated: '2026-09-26'