# Querying using the Taxonomy IN Operator ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations/querying-using-the-taxonomy-in-operator | | **course_slug** | taxonomy-foundations | | **lesson_slug** | querying-using-the-taxonomy-in-operator | | **learning_path_slug** | contentstack-developer-certification | | **markdown_file_url** | /academy/md/learning-paths/contentstack-developer-certification/taxonomy-foundations/querying-using-the-taxonomy-in-operator.md | | **generated_at** | 2026-05-22T14:37:41.671Z | > Lesson in **[Taxonomy Foundations](https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations)** within the **contentstack-developer-certification** learning path on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Video details #### At a glance - **Title:** Taxonomy-content-delivery-api-query2 - **Duration:** 6m 40s - **Media link:** https://cdn.jwplayer.com/previews/2xYXuWUi - **Publish date (unix):** 1716059980 #### Streaming renditions - application/vnd.apple.mpegurl - audio/mp4 · AAC Audio · 113678 kbps - video/mp4 · 180p · 180p · 150041 kbps - video/mp4 · 270p · 270p · 177521 kbps - video/mp4 · 360p · 360p · 204802 kbps - video/mp4 · 406p · 406p · 222754 kbps - video/mp4 · 540p · 540p · 277945 kbps - video/mp4 · 720p · 720p · 362506 kbps - video/mp4 · 1080p · 1080p · 552258 kbps #### Timed text tracks (delivery) - **thumbnails:** `https://cdn.jwplayer.com/strips/2xYXuWUi-120.vtt` #### Video transcript In this module, we'll take a look at how we can use the Content Delivery API to query for entries using our taxonomy. To get started, first, open the Content Delivery Documentation and Content Stack and navigate down to the Taxonomy section. Over here, you can get a list of the possible methods we can use to query for entries that are tagged with our taxonomy terms. So let's get started. We have two main entry points. One is slash taxonomies slash entries. The other one is slash content types. We're going to be focused on this first entry point in this module. The first example we're going to take a look at is using the n operator to query for entries that are tagged with our term. And this small example here, you can see that we have a taxonomy defined with a term color, and that has two child terms, red and yellow. And this example, we're actually looking for any entries that have been tagged with either red or yellow. Any other entries that are not tagged with red or yellow would not be retrieved. And by the way, this API is really intended to be used by your front-end website. It's read-only and it's high performance. All the content is cached in the ContentStack CDN, and it's really intended only to be used for your front-end website. If you're importing content or want to use taxonomy and terms and the back-end, then you would use a content management API, which is part of a different module. So here we're really focused on what code and queries would my website use to query content from ContentStack. Before we get started with this API example, let's make sure that our entries are tagged and published. So going into ContentStack, navigate over here to entries, and on the bottom left, make sure that you have your superhero taxonomy defined, you have origin here, and then you have these at least one term. Here I have three, and I've used natural powers to tag two of my characters. You can tag your entries with any of these terms, but just make sure you have tagged at least one, and after you tag one, you need to publish it. So for example, let me go ahead and do that with another entry here. So I'm going to go ahead and choose the cyber savior, and I'm going to select my term here, and I'm going to choose origin, and I'm going to choose scientific experimentation, and click apply. Then I'm going to go ahead and hit publish, and choose development, preview, and production, and choose send. This is now going to send my character to the front end. Maybe I want to tag him with another origin too. Maybe he also has two origins, his natural powers and scientific experimentation. So I'm going to go ahead and click apply, and then click publish, and again, publish my changes out. When I click publish, I'm pushing this entry to my content delivery environment, and therefore I can use my content delivery API to retrieve my entry. Now if I go back to my entries list, and I go over here under taxonomies, I should be able to open up superhero, and then origin, and choose scientific experimentation. We see cyber savior there, but we also see it under natural powers. Okay, great. So now what should happen is I can go back to my content delivery API, and use a query with my in operator to retrieve any entries that are tagged with origin and natural powers, or origin and scientific experimentation. You can either do your query here, in the documentation website, or as I prefer, use postman. Okay, in postman, you want to go over to collections, make sure you're content delivery collection, and under queries, you should see the in operator. Under the get request, make sure that it says v3 taxonomies. If for any reason you don't see this in operator query under queries, it's possible that your postman collection was downloaded several months ago, before taxonomies was released. In that case, just go over here and update your collection. You can click there, and you can click pull changes. Or you can go to the content sack documentation website, and download a new set of the postman collections. You can see that over here under content delivery. And then on the right side, you have using postman collections, and you can get the postman collections right over here. So this is where you can find the postman collections. So this is where you can get them at, and we also have them available on GitHub. And over there, you can also find the environment variables. So if you haven't done this before, I highly recommend also to download them from GitHub. We do have a module in this course about setting up postman, and go back and look at that module if you have any questions about this. Okay, so now that we have postman set up and working, let's go ahead and query for entries. Over here, I'm going to navigate again to my end operator, and notice my query. So I say taxonomies.superhero.origin in natural powers. So it always starts with taxonomies, that's always our first root term or node. And then you can go to superhero and origin. That maps very nicely to what we define in content stack here. We have superhero, origin, and origin should contain a term, natural powers, and I'm looking for all my entries, right? So let's go back to postman and run our query. I click send here, and now we get a list of all my characters. This is great. So you can see my entries is populated, and the first entry I have here is my entry for my cyber savior that we just tagged. Then after that, I have two other characters too. So I have my thunder monarch, and then at the end, we have cyber search. That's it for this module. Thank you very much for watching. #### Key takeaways - Connect **Querying using the Taxonomy IN Operator** back to your stack configuration before moving to the next module. - Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment. - Re-read the delivery versus management boundary for anything you changed in the entry model. ## Supplement for indexing ### Content summary Querying using the Taxonomy IN Operator. Querying using the Taxonomy IN Operator in Taxonomy Foundations (taxonomy-foundations). ### Retrieval tags - Querying - using - the - Taxonomy - Operator - taxonomy-foundations - lesson 21 - Querying using the Taxonomy IN Operator - taxonomy-foundations lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "21" and topics: [Querying, using, the, Taxonomy, Operator]. Parent course slug: taxonomy-foundations. Use asset_references URLs as thumbnail hints in search results when present. Never surface LMS quiz content or assessment answers from this file. ### Asset references | Label | URL | | --- | --- | | Video thumbnail: Querying using the Taxonomy IN Operator | `https://cdn.jwplayer.com/v2/media/2xYXuWUi/poster.jpg?width=720` | ### External links | Label | URL | | --- | --- | | Contentstack Academy home | `https://www.contentstack.com/academy/` | | Training instance setup | `https://www.contentstack.com/academy/training-instance` | | Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` | | Contentstack documentation | `https://www.contentstack.com/docs/` |