Skip to main content
A person types one query in one language and reads the first page of results. A research question has more than one form: the term a lawyer uses, the words of a news story, the same question in German and in French. search takes all of them in one call, runs each where it can be understood, and returns one list.

Send a question with its other wordings

Put the question in query and the other wordings in alternate_queries. This search asks one question in 9 wordings and 5 languages: the legal reference, the plain words of a news story, and the terms that lawyers use in German, French, Spanish, and Italian.
A search takes up to 10 other wordings. A wording with OR in it counts once for each side, and a search runs at most 20 in all. Nothing is translated. A wording runs on the datasources that cover its language, so the German wordings reach German sources that the English ones do not. The web takes every wording. You write the wordings, or the model behind the agent does, in the languages of the place you research.

Read the list

The results come as candidates, in rank order. This response is cut to the first result and to the fields that say what it is.
201 Created
A result is one page for a group of copies. copy_count says on how many other sites the same text was found, so the copies of one story count as one source. source_profile says who publishes the page and whether it is a primary source. For how to rank by these facts, see Put primary sources first. matches says which wording found the result, on which datasource, and at which rank there. A result that 3 wordings found on 2 datasources is one row with 6 matches.

See what each wording found

The response says how each wording did, so the next search can be better than this one. interpretation.wordings has one row for each wording, with its language and the number of results it found on each datasource. This response is cut to 4 of the 9 rows.
Part of the response
The Italian wording found nothing, so the next search can try other Italian words or leave the language out. A wording that no datasource covers is not dropped in silence. It comes back in coverage_gaps with the reason, so you know what was asked and not searched.

Use the operators you know

A wording can have a phrase in quotation marks, a word to exclude with a minus sign, OR, site:, filetype:, intitle:, inurl:, before:, after:, and *. Each datasource applies the operators it supports. The response says for each datasource what it did with each operator, so you can see whether an operator was applied.

Narrow the results

These fields remove results. Each is applied by the datasource where it can be, and by getclean after the search where it cannot. A datasource that can do neither is left out of the search, and the response says so. max_candidates sets how many results come back, from 1 to 50. The default is 10. The results after those are stored with the search, and get_search returns them at no charge.

Check what a search costs

A search costs one search unit and one unit for each wording on each datasource it ran on. By default a model ranks the results and chooses datasources that fit the question, and each of those 2 steps is charged as a model step. To run a search without a model, send deterministic_only as true. The search then runs on the web alone unless you name the datasources, and the results come in the order the datasources gave them, merged.