DEVELOPER DOCS
API docs
tags()

tags([{ name, value }])

Queries using metadata tags attached to transactions during upload.

Parameters

  • [{ name, value }]: An array of tag name / value pairs

Search for a single tag name / value pair:

const results = await myQuery
	.search("irys:transactions")
	.tags([{ name: "Content-Type", values: ["image/png"] }]);

Search for a single tag name with a list of possible values. The search uses OR logic and returns transactions tagged with ANY provided value:

const results = await myQuery
	.search("irys:transactions")
	.tags([{ name: "Content-Type", values: ["image/png", "image/jpg"] }]);

Search for multiple tags. The search uses AND logic and returns transactions tagged with ALL provided values:

const results = await myQuery.search("irys:transactions")
	.tags([{ name: "Content-Type", values: ["image/png"] },
	       { name: "Application-ID", values: ["myApp"] }]);

You can also search Arweave by tags:

const results = await myQuery
	.search("arweave:transactions")
	.tags([{ name: "Content-Type", values: ["image/png", "image/jpg"] }]);