Skip to main content
A search engine orders pages for a person who will read the first one. For a report on the AI strategies of 60 countries, the order that matters is another: the ministry’s own text before the commentary on it, the statistics office before the blog. A search here returns what each result is, and you can order the list by it.

Read what a source is

Each result has a source_profile with 4 facts. These values are facts about the source, read from what the site declares and from public registers. They are not a score. A fact that cannot be read is unknown, and it is not a guess. What a source is worth for your question stays your decision.

Put the sources that count first

ranking_priorities takes up to 4 of these values, in the order you give them.
A priority reorders the list and removes nothing. This response is cut to the title and the profile of the first 4 results.
201 Created
The official sources come first, and the news story and the commentary stay under them, where you can still read them for context. Inside each group the results are in order of relevance, or by date if you set ranking_order to newest or oldest.

Remove the kinds you do not want

To remove results, use a filter. source_kinds returns only the kinds of publisher you name.
Part of a request
source_independence returns only sources that are independent of the subject, or only the subject’s own. It needs a subject that the search can identify, which you give as an identifier, such as a company’s registry number. The response counts what a filter removed. counts.dropped has a number for each reason, and get_search returns the removed results with the reason for each, at no charge.

Say in words what matters

The request on this page has 2 fields that take plain sentences. purpose says why you search. It is stored with the search and read by every step that a model makes. ranking_instructions says how to rank, in your own words. purpose is never sent to a datasource. The response says in ranking.instructions_applied whether the instructions were used.

Keep one site from filling the list

ranking_preferred_domains puts results from the sites you name first among results of equal relevance. ranking_max_per_domain sets the most results from one site, from 1 to 50.

Count copies once

A story that 14 sites reprint is one source, and a report that counts it 14 times is wrong. The list shows one result for a group of copies, the copy with the earliest date among them, and copy_count says how many others there are.