Optimizely Search & Navigation sorts search results by score (relevance) by default. In some scenarios, you can boost scores based on certain criteria by using Unified weights, as described in this topic.
You can only suggest edits to Markdown body content, but not to the API spec.