Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Tarot → Search Cards

AI-generated

Summary

Search Tarot cards using keyword matching and astrological filters such as arcana, suit, element, planet, zodiac sign, house, and life area.

Inputs

  • Filter by Arcana — Filter cards by arcana type (Major Arcana or Minor Arcana).
  • Filter by Suit — Filter Minor Arcana cards by suit (Cups, Pentacles, Swords, or Wands).
  • Filter by Element — Filter cards by elemental correspondence (Air, Earth, Fire, or Water).
  • Filter by Planet — Filter cards by planetary correspondence in lowercase (e.g., mars, venus, moon).
  • Filter by Zodiac Sign — Filter cards by zodiac sign correspondence using a 3-letter code (e.g., ari, tau, gem).
  • Filter by House — Filter cards by astrological house correspondence (1 to 12, or 0 for all).
  • Keyword — Case-insensitive keyword to match against card names.
  • Page — Page number for paginated search results (1-based, defaults to 1).
  • Page Size — Number of card results per page (between 1 and 78, defaults to 20).
  • Life Area — Optional life area focus filter (e.g., career, love, health, finances).

Output shape

a list of items

Returns a paginated list of Tarot card objects matching the defined filter and search criteria.

Examples

Example 1: Search Major Arcana cards associated with Fire

Set Filter by Arcana to 'Major Arcana' and Filter by Element to 'Fire'.

Example 2: Search cards matching a keyword in a specific life area

Set Keyword to 'love' and Life Area to 'love'.

Links

Discussion