Metaphor API Guide-neural search for web content

Example

A developer needs to find articles on sustainable architecture shared by reputable sources. They use the API with a query like 'This is a must-read on sustainable architecture best practices: [link]', setting `useAutoprompt` to `false` to maintain a custom, specific search format.

Scenario

This function is ideal for users who want highly specific results that closely match a particular format of shared links, allowing for precision and relevance in content discovery beyond simple keyword-based searches.

Example

A content creator is looking for trending news articles on renewable energy. They input a straightforward query like 'latest news on renewable energy', with `useAutoprompt` set to `true`. The API converts this into a more contextually relevant query format that aligns with how content is typically shared.

Scenario

This function simplifies the search process for users who may not be familiar with crafting Metaphor-specific queries, enabling broader access to the API’s capabilities by allowing more traditional search inputs while still yielding high-quality, contextually appropriate results.

Example

A marketer wants to discover similar articles to a popular blog post on marketing strategies. They use the `/findSimilar` endpoint with the URL of the original article to get a list of other relevant content pieces.

Scenario

This function is useful for users needing to expand on a theme or topic, find competitive content, or build collections of similar resources for research or content strategy purposes. It helps in exploring related content spaces by finding articles with similar context, style, and shared audience relevance.