# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WhoisFreaks Geolocation API
  version: 1.0.0
extends: openapi/whoisfreaks-geolocation-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: 2
- target: $.paths['/v1.0/geolocation'].get
  update:
    x-apievangelist-phrasing:
      intent: Geolocate an IP address
      effect: read
      questions:
      - Where is a given IP address located?
      - Can I find the ASN and local currency for a visitor's IP?
      instructions:
      - text: Geolocate IP {ip}.
        slots:
          ip: query.ip
      - text: Tell me the country, city and currency for {ip}.
        slots:
          ip: query.ip
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1.0/geolocation'].post
  update:
    x-apievangelist-phrasing:
      intent: Geolocate a batch of IP addresses
      effect: read
      questions:
      - Can I geolocate up to 100 IPs in a single request?
      - How do I get locations for a whole list of IP addresses at once?
      instructions:
      - text: 'Bulk geolocate these IPs: {ips}.'
        slots:
          ips: requestBody.ips
      - text: Find the locations for the IP list {ips} in one call.
        slots:
          ips: requestBody.ips
      method: generated
      generated: '2026-10-01'