# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Partner Service Async Enrichment Jobs API
  version: 1.0.0
extends: openapi/explorium-asyncenrichmentjobs-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: 22
- target: $.paths['/v2/businesses/bombora_intent/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for Bombora intent on a list
      effect: write
      questions:
      - Can I pull Bombora intent signals for an entire uploaded company list in the background?
      - Which topics are my saved accounts researching, if I run it as an async job?
      instructions:
      - text: Start an async Bombora intent job for company list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue Bombora buying-intent enrichment for every business in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/company_hierarchies/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for company hierarchies
      effect: write
      questions:
      - How do I map parent companies and subsidiaries for a whole list of accounts at once?
      - Can corporate family trees be built asynchronously for an uploaded business list?
      instructions:
      - text: Run a company hierarchy job over business list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue parent and subsidiary lookups for list {list_id} as a background job.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/company_ratings_by_employees/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for employee ratings
      effect: write
      questions:
      - Can I get employee review ratings for hundreds of companies without waiting on each one?
      - What do staff think of the employers on my list, gathered as an async job?
      instructions:
      - text: Start an employee-ratings enrichment job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue a job collecting workplace ratings by employees for companies in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/company_website_keywords/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background website keyword scan on a list
      effect: write
      questions:
      - Can I check which companies in a large list mention certain keywords on their websites?
      - Is there an async way to scan many company sites for terms I choose?
      instructions:
      - text: Start a website keyword job on list {list_id} searching for {keywords}.
        slots:
          list_id: requestBody.list_id
          keywords: requestBody.parameters
      - text: Queue a scan of every company site in list {list_id} for the keywords {keywords}.
        slots:
          list_id: requestBody.list_id
          keywords: requestBody.parameters
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/financial_indicators/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for financial indicators
      effect: write
      questions:
      - How can I get financial metrics like revenue for a big account list asynchronously?
      - Can financial indicators be enriched for a whole business list in one queued job?
      instructions:
      - text: Run a financial indicators job for business list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue financial metric enrichment for all companies in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/firmographics/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background firmographics job for a list
      effect: write
      questions:
      - Can I enrich industry, size and location for an uploaded company list in the background?
      - What's the async route to firmographic data for thousands of businesses?
      instructions:
      - text: Start a firmographics job for company list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue firmographic enrichment (industry, headcount, location) for list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/funding_and_acquisition/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for funding and M&A data
      effect: write
      questions:
      - Which companies on my list raised money or were acquired, using a queued job?
      - Can funding rounds and acquisitions be pulled for a whole business list asynchronously?
      instructions:
      - text: Start a funding and acquisition job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue an async lookup of investment rounds and acquisitions for list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/linkedin_posts/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for company LinkedIn posts
      effect: write
      questions:
      - Can I collect recent LinkedIn posts from every company in a list as a background job?
      - What are the accounts on my uploaded list posting on LinkedIn, gathered asynchronously?
      instructions:
      - text: Start a company LinkedIn posts job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue collection of LinkedIn company-page posts for businesses in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/lookalikes/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job finding lookalike companies
      effect: write
      questions:
      - How do I find similar companies for each account in a large list without blocking?
      - Can lookalike businesses be generated for a whole uploaded list in one job?
      instructions:
      - text: Start a lookalikes job for business list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue a search for companies similar to each account in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/pc_business_challenges_10k/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a job on 10-K business challenges for a list
      effect: write
      questions:
      - Can I extract the business challenges public companies report in their 10-K filings for a whole list?
      - What risks and challenges do the public companies on my list disclose, pulled as a background job?
      instructions:
      - text: Start a 10-K business challenges job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue extraction of challenges from annual 10-K filings for companies in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/pc_competitive_landscape_10k/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a job on 10-K competitive landscape for a list
      effect: write
      questions:
      - Who do the public companies on my list name as competitors in their 10-Ks, run asynchronously?
      - Can competitive landscape data from 10-K filings be enriched for an entire list?
      instructions:
      - text: Start a 10-K competitive landscape job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue a background pull of rivals named in 10-K filings for list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/pc_strategy_10k/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a job on 10-K strategy for a list
      effect: write
      questions:
      - Can I summarise the strategic priorities public companies state in their 10-Ks for a big list?
      - What strategy do my listed public accounts describe in annual filings, gathered as a job?
      instructions:
      - text: Start a 10-K strategy job for business list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue extraction of stated corporate strategy from 10-K filings for {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/research/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background AI research job on a company list
      effect: write
      questions:
      - Can I ask a custom research question about every company in a list and get answers asynchronously?
      - Is there a queued version of company research for large business lists?
      instructions:
      - text: Start a research job on business list {list_id} asking {question}.
        slots:
          list_id: requestBody.list_id
          question: requestBody.parameters
      - text: Queue company research for list {list_id} with the prompt {question}.
        slots:
          list_id: requestBody.list_id
          question: requestBody.parameters
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/technographics/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background technographics job for a list
      effect: write
      questions:
      - Which software and tools do the companies on my list use, enriched as a background job?
      - Can technographic data be added to thousands of accounts asynchronously?
      instructions:
      - text: Start a technographics job for company list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue a tech stack lookup for every business in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/website_changes/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for website changes
      effect: write
      questions:
      - Can I track what changed on the websites of every company in a list with a queued job?
      - Which accounts on my list recently updated their websites?
      instructions:
      - text: Start a website changes job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue detection of recent site changes for companies in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/website_traffic/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for website traffic
      effect: write
      questions:
      - How do I get web traffic estimates for a large company list asynchronously?
      - Can site visit metrics be enriched for an uploaded business list in one job?
      instructions:
      - text: Start a website traffic job for business list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue traffic enrichment for the websites of companies in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/webstack/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background webstack job for a list
      effect: write
      questions:
      - Can I detect the technologies running on each company's website across a big list?
      - What web frameworks and site tools do my listed accounts use, as an async job?
      instructions:
      - text: Start a webstack job for company list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue detection of website technologies for businesses in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/businesses/workforce_trends/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for workforce trends
      effect: write
      questions:
      - Can I see headcount trends by department for every company in a list, run in the background?
      - Which accounts on my list are growing or shrinking their teams?
      instructions:
      - text: Start a workforce trends job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue employee headcount trend enrichment for companies in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects/contact_information/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for prospect contact info
      effect: write
      questions:
      - How can I get emails and phone numbers for a whole list of prospects asynchronously?
      - Can contact details be enriched for an uploaded people list in one background job?
      instructions:
      - text: Start a contact information job for prospect list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue email and phone enrichment for every person in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects/linkedin_posts/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for prospects' LinkedIn posts
      effect: write
      questions:
      - Can I gather what each person on my prospect list has posted on LinkedIn as a queued job?
      - What are my uploaded prospects posting on LinkedIn lately?
      instructions:
      - text: Start a prospect LinkedIn posts job for list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue collection of personal LinkedIn posts for prospects in {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects/profiles/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background job for prospect profiles
      effect: write
      questions:
      - Can I enrich job titles and work history for a big list of people in the background?
      - Is there an async way to build professional profiles for an uploaded prospect list?
      instructions:
      - text: Start a profiles job for prospect list {list_id}.
        slots:
          list_id: requestBody.list_id
      - text: Queue professional profile enrichment for the people in list {list_id}.
        slots:
          list_id: requestBody.list_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects/research/job'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a background AI research job on a prospect list
      effect: write
      questions:
      - Can I ask a custom research question about every person on a prospect list asynchronously?
      - Is there a queued way to research many individual contacts with my own prompt?
      instructions:
      - text: Start a research job on prospect list {list_id} asking {question}.
        slots:
          list_id: requestBody.list_id
          question: requestBody.parameters
      - text: Queue people research for list {list_id} using the prompt {question}.
        slots:
          list_id: requestBody.list_id
          question: requestBody.parameters
      method: generated
      generated: '2026-10-01'