Get autocomplete suggestions for person search fields

# Get autocomplete suggestions for person search fields

Return indexed values for a person search field such as title, location, employer or skill. Send field and a partial query to get ranked suggestions and use limit to control their number. Reuse each selected value as a person search filter. This helps recruiting forms and agents turn partial text or variant spellings into values present in the dataset.
Documentation: https://openany.si/apis/337ecd01-2695-469d-a97b-793e04e06aed
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/crustdata/crustdata/person/search/autocomplete
Price: $0 / call
Provider: crustdata
Contract revision: 2
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.

Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.

## Prepared request
```bash
curl \
  'https://api.openany.si/v1/agent-apis/crustdata/crustdata/person/search/autocomplete' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "field": "experience.employment_details.current.title",
  "limit": 2,
  "query": "VP"
}'
```

## API contract
```json
{
  "resource_type": "api",
  "name": "Get autocomplete suggestions for person search fields",
  "endpoint": "https://api.openany.si/v1/agent-apis/crustdata/crustdata/person/search/autocomplete",
  "method": "POST",
  "content_type": "application/json",
  "execution_mode": "sync",
  "authentication": {
    "type": "bearer",
    "environment_variable": "OPENANY_API_KEY"
  },
  "inputs": [
    {
      "description": "The dataset API field name to get suggestions for. Valid fields include: basic_profile.name, basic_profile.first_name, basic_profile.last_name, basic_profile.headline, basic_profile.languages, basic_profile.location, basic_profile.location.raw, basic_profile.location.full_location, basic_profile.location.city, basic_profile.location.state, basic_profile.location.country, basic_profile.location.continent, professional_network.location, professional_network.location.raw, professional_network.location.city, professional_network.location.state, professional_network.location.country, professional_network.location.continent, professional_network.open_to_cards, skills.professional_network_skills, experience.employment_details.current.name, experience.employment_details.current.title, experience.employment_details.current.seniority_level, experience.employment_details.current.function_category, experience.employment_details.current.company_industries, experience.employment_details.current.company_type, experience.employment_details.current.company_hq_location, experience.employment_details.current.company_website_domain, experience.employment_details.current.employment_type, experience.employment_details.past.name, experience.employment_details.past.title, experience.employment_details.past.seniority_level, experience.employment_details.past.function_category, experience.employment_details.past.company_type, experience.employment_details.past.company_hq_location, experience.employment_details.past.company_website_domain, experience.employment_details.past.employment_type, experience.employment_details.employment_type, education.schools.school, education.schools.degree, education.schools.field_of_study, certifications.name, certifications.issuing_organization, honors.title, research_profiles.research_interests, research_profiles.affiliated_organisation, open_to_cards, employment_type. The two research_profiles paths also accept the flat names research_interests and affiliated_organisation.\n",
      "location": "body",
      "name": "field",
      "nullable": false,
      "pointer": "/field",
      "required": true,
      "type": "string"
    },
    {
      "description": "The search query text (can be empty to get top values by frequency)",
      "location": "body",
      "name": "query",
      "nullable": false,
      "pointer": "/query",
      "required": true,
      "type": "string"
    },
    {
      "description": "Maximum number of suggestions to return",
      "location": "body",
      "maximum": "100",
      "minimum": "1",
      "name": "limit",
      "nullable": false,
      "pointer": "/limit",
      "required": false,
      "type": "integer"
    }
  ],
  "billing": {
    "currency": "USD",
    "mode": "fixed",
    "priceMicroUsd": "0",
    "rounding": null,
    "unit": "call",
    "unitQuantity": null
  },
  "examples": [
    {
      "http_status": 200,
      "name": "Documentation example",
      "request": {
        "body": {
          "field": "experience.employment_details.current.title",
          "limit": 2,
          "query": "VP"
        },
        "headers": {},
        "path": {},
        "query": {}
      },
      "response_body": {
        "openany_cost": 0,
        "suggestions": [
          {
            "value": "VP"
          },
          {
            "value": "VP of Sales"
          }
        ]
      }
    }
  ]
}
```