AI query builder

What is the AI query builder?

It’s a feature that lets users enter natural language prompts, which the tool then transforms into search and collect API queries. It simplifies the exploration process and makes it easy to generate custom queries, helping you avoid errors.

It gives you:

• The complete search and collect API requests

• The total number of matching records in our database

• A sample record for quick validation

Why are there no results?

If there are no results in our database, the post response field will display 0. However, if the AI query builder fails to generate a data collection request, it indicates that the API couldn’t find any results based on the search filters.

However, that doesn’t necessarily mean that we don’t have such data. Try to modify your prompt following the best practices:

• Broaden your search criteria. Using too many or overly strict filters is a primary cause of empty results. Try using broader criteria first, then narrow the search down as needed.

• Check for typos and spelling errors. Requests often fail due to simple misspellings in the prompt. Ensure all names and terms are spelled correctly.

• Verify that the entity exists. The company or employee you are looking for may be rare, new, or not available in our dataset.

If you have followed the advice above, it is likely that the data you’re looking for is not available in our database.

How to fix a prompt causing an error?

When using the AI query builder, you may run into one of the following errors:

Failed to submit request

This error message appears when the system cannot process your query as written.

Here’s how you can try to adjust your prompt:

• Remove requests for private data. The most common reason for an error is an off-topic request. The AI cannot search for personal contact details, so you should remove any mention of emails or phone numbers from your prompt.

• Ensure the prompt is well-formed. A query can fail if it has a malformed or unsupported structure. The best way to fix this is to use one of the prompt examples as a guide to ensure your request is structured correctly.

• Avoid using test inputs. Prompts that consist of simple test inputs, typos, or random characters (e.g., “ddkdopqkwd”) are considered unsupported and will cause an error.

• Make sure your prompt uses clear, descriptive language.

Insufficient credits

You’ll see this error message if you don’t have enough credits to generate or update a query.

What’s the most effective way to formulate a prompt?

• Follow the structure of the prompt examples provided in the playground.

• Keep it short (5-500 characters) and refine your search through multiple prompts instead of overcomplicating a single prompt.

• Use precise criteria instead of broader adjectives. For example, instead of “biggest” or “top”, indicate a company size, revenue range, exact job role, required experience duration, etc.

• Aim to formulate prompts that resemble real data fields and values.

Can I modify the AI-generated query or prompt?

Yes. Both the original prompt and the generated query are editable. You can refine and rerun as needed to fine-tune results.

In the search request window, you can change, remove, or add filters and values.

In the data collection request, you can change the record ID and preview another data record.

How much does using the AI query builder cost?

Executing a search API query costs 1 Search credit (or 2 for multi-source searches). Similarly, collecting each record uses 1 Collect credit (or 2 for multi-source records).

Will I be charged for unsuccessful requests?

If you run into an error when trying to generate a search query, you won’t be charged. If no results in our database match the criteria in your prompt, you will only be charged for the search request generation.