Search the Graunt catalog
searchSearch Graunt's catalog of evaluated data from many sellers. Returns matching packets with their id, title, and public URL. Start here to find data, then read one with fetch. search_match.words says how the listings matched the query: ALL (every word, or a synonym of it), SOME (some of the words), WORD_START (words that start with the query's words), SIMILAR_TITLE (titles spelled like the query) or NONE (no listing). On SOME and WORD_START each listing names its matched_words. Each result's type is listing or pool, and search_match describes only listings. Pools use a separate keyword matcher over their public descriptions and data types. When no listing matches, next_steps.post_request_url opens a buyer request with the query filled in.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Only listings of this kind of data, read from their media kind or their files. | |
| limit | No | Max results; default 20, cap 50. | |
| query | Yes | Search keywords. | |
| camera_view | No | Only video listings shot from this camera view. | |
| ai_generation | No | Keep only packets whose seller declares this AI-generation extent: NONE (not AI-generated), PARTIAL or FULL. A seller declaration, not a Graunt finding. AI processing of real material (cleaning, labeling, transcribing, captioning, structuring) is not AI generation, and a packet that contains video declares NONE. | |
| video_subject | No | Only video listings whose footage shows this subject. | |
| rights_public_use | No | The "Show it publicly" permission: NONE keeps only packets that grant no public use, including those that record no answer; EDITORIAL, PROMOTIONAL and COMMERCIAL keep only packets that grant exactly that use. The rights the seller declared on the listing, which Graunt records: a seller declaration, not a Graunt finding. | |
| seller_credential | No | Keep only packets whose seller declares a credential: declared keeps listings whose seller declares at least one credential (a trade license, certification, business registration, membership or qualification); checked keeps those whose seller holds at least one that a Graunt operator checked against a registry. A seller declaration that Graunt records, never a Graunt finding, a score or a ranking input. | |
| rights_license_family | No | Keep only packets whose seller names this license family. In order, the values stand for: Proprietary, CC0 (public domain), CC BY, CC BY-SA, CC BY-NC, CC BY-ND, CC BY-NC-SA, CC BY-NC-ND, MIT, Apache 2.0, BSD 2-clause, BSD 3-clause, GPL 3.0, LGPL 3.0, MPL 2.0, ODC-BY, ODbL, Public domain, U.S. Government work. The rights the seller declared on the listing, which Graunt records: a seller declaration, not a Graunt finding. | |
| rights_training_allowed | No | true keeps only packets whose seller declares that AI models may be trained on them; false keeps only those whose seller declares they may not. The rights the seller declared on the listing, which Graunt records: a seller declaration, not a Graunt finding. | |
| rights_sublicense_one_client | No | The "Sublicensing to one client" permission: true keeps only packets a buyer may license for one client and pass the license through to that client; false keeps only those a buyer may not, including those that record no answer. The rights the seller declared on the listing, which Graunt records: a seller declaration, not a Graunt finding. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes | ||
| next_steps | No | Present only when no listing matches. | |
| search_match | No | How the listings matched the query. Present whenever a query was given. |