Search catalog listings
search_assetsSearch the public catalog and return listing rows as Graunt's API gives them (GET /v1/listings), paginated. To find data for a person, use search, then 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. When no listing matches, next_steps.post_request_url opens a buyer request with the query filled in.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_assets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query string. | |
| kind | No | Only listings of this kind of data, read from their media kind or their files. | |
| limit | No | Max rows; default 20, cap 100. | |
| 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. |