API Ninjas offers over 120 unique APIs across various categories, enabling developers to build real applications with real data.
API Ninjas offers over 120 unique APIs across various categories, enabling developers to build real applications with real data. On Nagent, API Ninjas is exposed as a fully-configurable developer tools integration that any agent can call — 129 actions, and API key authentication. No code is required to wire API Ninjas into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use API Ninjas to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire API Ninjas into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against API Ninjas, with input parameters and output schema. Drop these into any step of an agent built in Helix.
API_NINJAS_ANALYZE_SENTIMENTTool to analyze the sentiment of text. Returns a numerical sentiment score from -1 to 1 and a classification (POSITIVE, WEAK_POSITIVE, NEUTRAL, WEAK_NEGATIVE, or NEGATIVE). Use when you need to determine the emotional tone or sentiment of text content.
Input parameters
Text to analyze for sentiment. Maximum 2000 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_BARCODE_GENERATETool to generate a barcode image for specified text. Use when you need a barcode image (PNG or SVG) of custom data.
Input parameters
Text to encode in the barcode
Type of barcode to generate
Image format to return
Whether to include the text below the barcode
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_BIN_LOOKUPTool to look up bank information from a Bank Identification Number. Use after you have a BIN to fetch issuer details (brand, type, country).
Input parameters
Bank Identification Number (first 6-8 digits of a credit/debit card). Must be numeric.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_BITCOINTool to retrieve the latest Bitcoin price and 24-hour market data. Use when you need real-time Bitcoin metrics in USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CALCULATE_CALORIES_BURNEDTool to calculate calories burned for an activity based on duration and body weight. Use when you need to estimate energy expenditure for physical activities.
Input parameters
Body weight in kg or lbs. If not provided, API uses default.
Name of the activity (e.g., 'running', 'swimming', 'cycling').
Duration in minutes. If not provided, API uses default (typically 60 minutes).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CALCULATE_MORTGAGETool to calculate mortgage payments and breakdowns. Use when you need to determine monthly/annual payments, including mortgage, property tax, HOA, and insurance components.
Input parameters
Total value of the home or asset. Must be greater than downpayment.
Downpayment on the home or asset. Cannot exceed home_value.
Principal loan amount. Either this OR (home_value + downpayment) must be provided.
Monthly homeowner association fees
Annual interest rate (in %). For example, a 3.5% interest rate would be 3.5
Loan duration in years (1-10000). Defaults to 30.
Annual property tax owed
Annual homeowner's insurance bill
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CALCULATE_SALES_TAXTool to calculate sales tax for a purchase amount at a US location. Use when you need to determine the sales tax for a purchase based on ZIP code or city/state. Premium features include detailed breakdowns by city, county, and special districts.
Input parameters
City name (must be used with state parameter). Use this with state OR use zip_code for location.
State name (must be used with city parameter). Use this with city OR use zip_code for location.
Purchase amount to calculate sales tax on. Must be non-negative.
Valid US ZIP code (5 digits). Use this OR both city and state parameters for location.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CHECK_DOMAINTool to check domain availability and retrieve registration information. Use when you need to verify if a domain is available for registration or get details about an existing domain.
Input parameters
Valid domain to check (e.g., example.com). For top-level domains other than .com, a premium subscription is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CHECK_IS_PUBLIC_HOLIDAYTool to check if a specific date is a public holiday in a given country. Use when you need to verify holiday status for scheduling, planning, or calendar-related tasks. Returns holiday name if applicable.
Input parameters
Date to check in YYYY-MM-DD format (e.g., '2026-01-01'). Must be between 1980-01-01 and 2050-12-31.
2-letter ISO 3166-1 alpha-2 country code (e.g., 'US' for United States, 'GB' for United Kingdom, 'JP' for Japan). This determines which country's public holidays are checked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CHECK_IS_WORKING_DAYTool to check if a date is a working day in a specific country. Returns whether the date is a working day, accounting for weekends and public holidays. Use when you need to determine if a business is likely to be open on a specific date.
Input parameters
Date in YYYY-MM-DD format. Must be between 1980-01-01 and 2050-12-31 (inclusive).
Country code (2-letter ISO 3166-1 alpha-2 code, e.g., 'US' for United States, 'GB' for United Kingdom).
Comma-separated list of weekend days (mon,tue,wed,thu,fri,sat,sun). Optional: if not provided, default weekend days are determined by country.
Whether to include public holidays as non-working days. Defaults to true if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CHECK_SPELLINGTool to check spelling and get corrections for text. Returns the original text, corrected version, and detailed corrections with alternative suggestions.
Input parameters
The text to be spell-checked. Can be a single word or multiple words.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_COMMODITY_PRICEGet real-time commodity prices from major exchanges (CME, NYMEX, COMEX). Prices are based on rolling futures contracts in USD. Free tier has limited commodities that rotate weekly. Use snake_case for commodity names (e.g., 'micro_gold', 'natural_gas'). Example: "What is the current price of natural gas?"
Input parameters
Name of the commodity to fetch price for. Use snake_case format. Free tier commodities rotate weekly. Common free tier options include: micro_gold, micro_silver, natural_gas, heating_oil, lumber, lean_hogs, live_cattle. Premium commodities (require paid plan): gold, silver, crude_oil, corn, wheat, platinum, copper, coffee, sugar, cotton, soybeans, etc.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_COMPUTE_TEXT_SIMILARITYTool to compute semantic similarity between two texts. Returns a similarity score from 0 to 1 using NLP embeddings and cosine similarity. Use when comparing text content, detecting duplicates, or measuring semantic relatedness.
Input parameters
First text to compare for similarity.
Second text to compare for similarity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CONVERT_CURRENCYConvert between currencies using current exchange rates. Returns the converted amount with both source and target currency details. Use this when you need to know how much a specific amount in one currency is worth in another currency.
Input parameters
Source currency code (e.g., USD, EUR, GBP, JPY). The currency you currently have.
Target currency code (e.g., USD, EUR, GBP, AUD). The currency you want to convert to.
Amount to convert in the source currency. Must be a positive number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CONVERT_UNITConvert between measurement units across different categories. Returns converted values for all units in the same category. Use this when you need to convert measurements (length, weight, temperature, volume, area, time, speed, etc.) from one unit to another.
Input parameters
The source unit to convert from (e.g., 'meter', 'kilogram', 'celsius', 'gallon'). If the unit name has spaces, replace them with underscores (e.g., 'square_meter').
The numerical value to convert. Must be a positive or negative number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_CRYPTO_PRICEGet the current real-time price for a cryptocurrency trading pair. Returns the latest price and timestamp for symbols like BTCUSDT (Bitcoin to USD), ETHUSDT (Ethereum to USD), or crypto-to-crypto pairs like LTCBTC (Litecoin to Bitcoin). Use this to check current cryptocurrency market prices.
Input parameters
Cryptocurrency trading pair symbol. Common formats include crypto-to-USD pairs like 'BTCUSDT', 'ETHUSDT', 'XRPUSDT', 'DOGEUSDT', or crypto-to-crypto pairs like 'LTCBTC', 'ETHBTC'. Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_DETECT_TEXT_LANGUAGETool to detect the language of input text. Returns the ISO language code and full language name. For best accuracy, use text with 10 or more words.
Input parameters
Input text to detect language from. Maximum 1000 characters. For best results, use 10 words or more.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_DISPOSABLE_EMAIL_CHECKERTool to check whether an email address is from a disposable email provider. Use when validating user emails prior to sending communications.
Input parameters
The email address to check for disposability.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_DNS_LOOKUPTool to retrieve DNS records for a specified domain. Use when you need DNS record details for troubleshooting or validation.
Input parameters
The domain to look up DNS records for (e.g., example.com). Top-level domains other than .com require a premium subscription.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_EARNINGS_CALENDARFetches historical earnings data (EPS and revenue - actual vs. estimated) for a publicly traded company by stock ticker. Returns past quarterly earnings dates with actual and estimated EPS/revenue figures. Useful for tracking earnings beats/misses and analyzing company financial performance over time.
Input parameters
Maximum number of earnings records to return (1-100). Premium subscribers only.
Stock ticker symbol to get earnings data for (e.g., 'AAPL', 'MSFT', 'GOOGL').
Whether to include upcoming/scheduled earnings dates in addition to past earnings. Defaults to false. Premium subscribers only.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_EARNINGS_CALL_TRANSCRIPTRetrieve the full earnings call transcript for a publicly traded company. Use this tool when you need to analyze what was discussed during a company's quarterly earnings call, including management commentary, Q&A with analysts, financial guidance, and strategic updates. Note: This endpoint requires a premium API Ninjas subscription. Example use cases: - Analyze management sentiment during earnings calls - Extract forward guidance and projections - Review analyst questions and company responses - Compare earnings call content across quarters
Input parameters
Company Central Index Key (CIK), a unique identifier assigned by the SEC (e.g., '320193' for Apple Inc.). Either ticker or cik must be provided.
Fiscal year of the earnings call (e.g., 2024). If omitted along with quarter, returns the most recent transcript. Must be between 2000 and the current year.
Company stock ticker symbol (e.g., 'AAPL' for Apple Inc.). Either ticker or cik must be provided.
Fiscal quarter of the earnings call (1=Q1, 2=Q2, 3=Q3, 4=Q4). If omitted along with year, returns the most recent transcript.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_ETF_INFORetrieve detailed information about an Exchange-Traded Fund (ETF) by its ticker symbol. Returns the ETF's full name, ISIN, CUSIP, and country of origin. Note: expense_ratio, aum, holdings, and num_holdings require a premium API subscription and will return null for free-tier users.
Input parameters
ETF ticker symbol. Case-insensitive. Examples: 'SPY' (S&P 500), 'QQQ' (NASDAQ-100), 'VTI' (Total Stock Market), 'BND' (Bond Market).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_EXTRACT_WEBPAGE_CONTENTTool to extract main content and metadata from a webpage. Returns URL, domain, path, page title, description, meta tags, and favicon. Use when you need to retrieve structured information from any web page.
Input parameters
The URL of the webpage to extract content from. Must be a valid HTTP or HTTPS URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_FILTER_PROFANITYTool to detect and censor profanity in text. Returns the original text, censored version with profane words replaced by asterisks, and whether profanity was detected.
Input parameters
Text to filter for profanity. Maximum 1000 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_FIND_EV_CHARGING_STATIONSTool to find electric vehicle charging stations near a specified location. Use when you need to locate EV charging infrastructure by geographic coordinates.
Input parameters
Latitude coordinate of the search location.
Longitude coordinate of the search location.
Filter by charging level: 1 (slow), 2 (medium), or 3 (fast/DC).
Maximum number of results to return. Range: 1-30, default 3.
Number of results to skip for pagination.
Search radius distance in kilometers. Maximum 50 km, default 3 km.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_LOREM_IPSUMTool to generate Lorem Ipsum placeholder text. Use when you need dummy text for design mockups, testing, or content placeholders.
Input parameters
Number of paragraphs of Lorem Ipsum text to generate. Must be a positive integer. Defaults to 1 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_PASSWORDTool to generate secure random passwords with configurable length and character types. Use when you need to create strong passwords with specific requirements for uppercase, lowercase, numbers, and special characters.
Input parameters
Password length in characters. Default is 16.
Include numbers (0-9) in the password.
Include special characters (!@#$%^&*() etc.) in the password.
Include lowercase letters (a-z) in the password.
Include uppercase letters (A-Z) in the password.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_QR_CODETool to generate QR code images for encoding data. Use when you need to create scannable QR codes for URLs, text, or other data. Returns the QR code as a PNG or SVG image file.
Input parameters
Data to encode in the QR code. Can be any text, URL, or other string content.
Output format for the QR code image. Choose 'png' for raster image or 'svg' for vector graphics.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_RANDOM_USERTool to generate fake random user profiles with realistic data. Returns user profiles with names, addresses, contact info, job details, and technical data. Use when you need realistic test data, demo users, or placeholder profiles for development and testing purposes.
Input parameters
Seed value for reproducible random data generation. Using the same seed value will always produce the same set of random users, which is useful for testing or creating consistent demo data.
Number of random user profiles to generate. Must be between 1 and 30. Default: 10
Comma-separated list of specific fields to include in the response. Only these fields will be returned. Example: 'first_name,last_name,email,phone'. Available fields include: id, username, password, email, uuid, locale, name, first_name, last_name, full_name, prefix, suffix, phone, cell, company_email, street_address, city, state, postal_code, country, address, latitude, longitude, timezone, dob, age, gender, job, company, ssn, credit_card, credit_card_provider, iban, ipv4, ipv6, mac_address, user_agent, url, domain, md5, sha1, sha256, picture, avatar.
Gender filter for random user generation
Locale for generating localized data such as names, addresses, and phone numbers. Use standard locale codes like 'en_US' (English - United States), 'de_DE' (German - Germany), 'fr_FR' (French - France), 'es_ES' (Spanish - Spain), etc. Default: 'en_US'
Comma-separated list of fields to exclude from the response. All fields except these will be returned. Example: 'ssn,credit_card,password' to exclude sensitive data. Cannot be used together with 'fields' parameter.
Maximum age for generated users. Must be between 0 and 1000. Default: 100
Minimum age for generated users. Must be between 0 and 1000. Default: 0
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_SUDOKUTool to generate a new Sudoku puzzle with a specified difficulty level. Use when you need to create Sudoku puzzles for games or educational purposes. Returns both the puzzle grid (with empty cells) and the complete solution.
Input parameters
Seed value for reproducible puzzle generation. Use the same seed to generate the same puzzle. Optional.
Width of each box in the Sudoku grid. Must be between 2 and 4. Default is 3 (standard 9x9 Sudoku).
Height of each box in the Sudoku grid. Must be between 2 and 4. Default is 3 (standard 9x9 Sudoku).
Supported difficulty levels for Sudoku puzzle generation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_TEXT_EMBEDDINGSTool to encode text into vector embeddings using NLP models. Use when you need to generate semantic vectors for text comparison, search, or recommendation systems.
Input parameters
Text to generate embeddings for. Maximum 5,000 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GENERATE_USER_AGENTTool to generate realistic random user agent strings with optional filters for brand, model, OS, and browser. Use when you need authentic-looking user agent strings for web scraping, testing, or browser simulation.
Input parameters
Operating system to filter by (e.g., 'Windows', 'iOS', 'Android', 'macOS', 'Linux'). If not specified, any OS may be used.
Device manufacturer/brand to filter by (e.g., 'Apple', 'Samsung', 'Google', 'LG'). If not specified, any brand may be used.
Device model name to filter by (e.g., 'iPhone', 'Galaxy', 'Pixel'). If not specified, any model may be used.
Browser application to filter by (e.g., 'Chrome', 'Firefox', 'Safari', 'Edge'). If not specified, any browser may be used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_ADVICETool to get a random piece of life advice from the API Ninjas Advice endpoint. Use when you need motivational or thought-provoking advice.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_AIRCRAFTTool to retrieve aircraft information by manufacturer and model including specifications and performance data. Use when you need technical details about specific aircraft models or want to search aircraft by performance criteria.
Input parameters
Aircraft model name (e.g., 'G550', '747', 'Citation').
Maximum range in nautical miles. Filter aircraft with range less than or equal to this value.
Maximum speed in knots. Filter aircraft with speed less than or equal to this value.
Minimum range in nautical miles. Filter aircraft with range greater than or equal to this value.
Minimum speed in knots. Filter aircraft with speed greater than or equal to this value.
Aircraft manufacturer name (e.g., 'Gulfstream', 'Boeing', 'Cessna').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_AIRLINESTool to retrieve airline information by name, IATA code, or ICAO code. Use when you need details about airlines including fleet size, base location, and branding assets.
Input parameters
2-letter IATA airline code (e.g., 'LH' for Lufthansa, 'SQ' for Singapore Airlines).
3-letter ICAO airline code (e.g., 'DLH' for Lufthansa, 'SIA' for Singapore Airlines).
Airline name to search for (e.g., 'Lufthansa', 'Singapore Airlines'). Partial matches are supported.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_AIRPORTSTool to search for airport information by IATA code, ICAO code, name, city, country, or region. Use when you need to find airport details, coordinates, or codes. Returns up to 10 matching airports.
Input parameters
City name to search for airports (e.g., 'New York', 'London', 'Paris'). Returns all airports in the specified city.
3-letter IATA airport code (e.g., 'JFK', 'LHR', 'CDG'). Use this to search for a specific airport by its international code.
4-letter ICAO airport code (e.g., 'KJFK', 'EGLL', 'LFPG'). Use this to search for a specific airport by its ICAO designation.
Airport name to search for (e.g., 'John F Kennedy International Airport', 'Heathrow'). Partial matches are supported.
Number of results to offset for pagination. Use this to paginate through results by setting offset to multiples of the result limit (e.g., 0, 30, 60).
Region or state to search for airports (e.g., 'California', 'Texas', 'England'). Returns all airports in the specified region.
Country code or name to search for airports (e.g., 'US', 'United States', 'GB', 'United Kingdom'). Returns all airports in the specified country.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_AIR_QUALITYTool to retrieve air quality index and pollutant data for a location. Use when you need current air quality information for environmental monitoring or health assessments. Query by city name or GPS coordinates.
Input parameters
Latitude coordinate (-90 to 90). Must be used together with lon parameter.
Longitude coordinate (-180 to 180). Must be used together with lat parameter.
City name. Must provide either city or coordinates (lat/lon).
US state name or abbreviation (for US cities only). Use with city parameter to disambiguate locations.
Country name or ISO 3166-1 alpha-2 code. Use with city parameter to disambiguate locations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_ANIMALSTool to retrieve detailed scientific information about animal species including taxonomy, habitat, diet, and physical characteristics. Use when you need comprehensive facts about specific animals.
Input parameters
Common name of the animal to search for. Returns up to 10 matching results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_BABY_NAMESTool to get baby name suggestions by gender. Returns 10 baby name suggestions that can be filtered by gender (boy, girl, or neutral) and popularity. Use when you need baby name ideas or recommendations.
Input parameters
Gender filter for baby names
Whether to only return popular names (top 10% of names). Set to true to get only popular names, false to include less common names. Defaults to true.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_BUCKETLISTTool to retrieve a random bucket list idea or activity. Use when you need inspiration for bucket list items or life goals.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_CARSTool to get car specifications including make, model, fuel type, MPG, transmission, and engine details. Use when you need detailed vehicle data filtered by manufacturer, year, fuel efficiency, or other attributes. Note: This endpoint is deprecated; consider using newer car API endpoints if available.
Input parameters
Car manufacturer/make (e.g., 'toyota', 'honda', 'ford').
Model year (e.g., 2020, 2015, 1993).
Drive type. Valid values: 'fwd' (front-wheel drive), 'rwd' (rear-wheel drive), 'awd' (all-wheel drive), '4wd' (four-wheel drive).
Number of results to return. Maximum is typically 30.
Car model name (e.g., 'camry', 'civic', 'mustang').
Number of cylinders in the engine (e.g., 4, 6, 8).
Fuel type. Valid values: 'gas', 'diesel', 'electricity'.
Maximum highway miles per gallon (MPG).
Minimum highway miles per gallon (MPG).
Maximum city miles per gallon (MPG).
Minimum city miles per gallon (MPG).
Transmission type. Valid values: 'manual', 'automatic' (or 'a' for automatic, 'm' for manual).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_CATSTool to retrieve information on cat breeds matching specified parameters. Use when you need to search for cat breeds by characteristics such as name, weight, life expectancy, shedding level, playfulness, grooming needs, or friendliness with family and other pets.
Input parameters
Cat breed name to search for (e.g., 'persian', 'siamese'). Partial matches are supported.
Number of results to offset for pagination. Use this to paginate through results by setting offset to multiples of the result limit (e.g., 0, 20, 40).
Grooming needs on a scale of 1-5, where 1 requires minimal grooming and 5 requires extensive grooming.
Shedding level on a scale of 1-5, where 1 is minimal shedding and 5 is heavy shedding.
Maximum weight in pounds. Must be greater than min_weight if both are specified.
Minimum weight in pounds. Must be less than max_weight if both are specified.
Playfulness level on a scale of 1-5, where 1 is less playful and 5 is very playful.
Family friendliness level on a scale of 1-5, where 1 is less family-friendly and 5 is very family-friendly.
Maximum life expectancy in years. Must be greater than min_life_expectancy if both are specified.
Minimum life expectancy in years. Must be less than max_life_expectancy if both are specified.
Pet friendliness level on a scale of 1-5, where 1 is less friendly with other pets and 5 is very friendly with other pets.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_CELEBRITYTool to search for celebrity information by name or other criteria. Returns details including net worth, height, birthday, nationality, and occupation. Use when you need to find information about famous people, filter celebrities by attributes like net worth or nationality, or gather biographical data.
Input parameters
Name of the celebrity you wish to search. This field is case-insensitive.
Number of results to offset for pagination.
Maximum height of celebrities in meters.
Minimum height of celebrities in meters.
Nationality of celebrities. Must be an ISO 3166 Alpha-2 country code (e.g., US, GB, FR).
Maximum net worth of celebrities in US dollars.
Minimum net worth of celebrities in US dollars.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_CHUCK_NORRIS_JOKETool to retrieve a random Chuck Norris joke from the API Ninjas database. Use when you need humorous Chuck Norris content.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_CITYTool to retrieve city information by name, country, coordinates, or population filters. Use when you need geographic data about cities including coordinates, population, and capital status. At least one search parameter is required.
Input parameters
City name to search for (e.g., 'London', 'New York').
Number of results to return per request (range: 1-30). Premium feature only.
Pagination offset to skip the first N results.
ISO-3166 alpha-2 country code to filter cities (e.g., 'US', 'GB', 'JP').
Maximum latitude coordinate for geographic filtering (range: -90 to 90).
Maximum longitude coordinate for geographic filtering (range: -180 to 180).
Minimum latitude coordinate for geographic filtering (range: -90 to 90).
Minimum longitude coordinate for geographic filtering (range: -180 to 180).
Maximum population count for filtering cities.
Minimum population count for filtering cities.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COCKTAILTool to search for cocktail recipes by name or ingredients. Returns up to 10 cocktail recipes with ingredients and preparation instructions. Use when you need cocktail recipes, drink mixing instructions, or want to find drinks by specific ingredients.
Input parameters
Cocktail name to search for. Supports partial matches (e.g., 'marg' matches 'Margarita'). Case-insensitive.
Comma-separated list of ingredients to search for. Uses AND logic (returns cocktails containing all specified ingredients). Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COMPANY_LOGOTool to retrieve company logo images by company name or ticker symbol. Use when you need to display or download company logos.
Input parameters
Company name that supports partial matching (case-insensitive). Either name or ticker is required.
Company ticker symbol for publicly traded companies. Either name or ticker is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COUNTERTool to get and optionally increment a persistent counter. Use when you need to track counts or maintain state across API calls.
Input parameters
ID to specify the counter. Use a new id to create a new counter.
Increments counter by 1 when set to true. If false or not provided, counter is not incremented.
Sets counter to specific value. Use 0 to reset the counter. If provided, this overrides the 'hit' parameter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COUNTRY_FLAGTool to retrieve country flag images in SVG format. Use when you need flag URLs for display or download.
Input parameters
Country name (e.g., 'United States') or ISO 3166-1 alpha-2 country code (e.g., 'US')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COUNTRY_INFOTool to retrieve detailed country information by name, ISO code, or filtering by economic and demographic criteria. Use when you need comprehensive data about countries including population, GDP, surface area, unemployment, fertility rates, and other key statistics. Supports filtering by min/max ranges for various metrics.
Input parameters
Plain English name, 2-letter ISO-3166 alpha-2 (e.g., 'US'), or 3-letter ISO-3166 alpha-3 (e.g., 'USA') code of country.
How many results to return. Must be between 1 and 30. Default is 5.
Maximum gross domestic product (GDP) of country, in US Dollars.
Minimum gross domestic product (GDP) of country, in US Dollars.
Maximum fertility rate in %.
Minimum fertility rate in %.
Maximum GDP growth rate in %.
Maximum population of country.
Minimum GDP growth rate in %.
Minimum population of country.
Maximum surface area of country in km2.
Maximum unemployment rate in %.
Minimum surface area of country in km2.
Minimum unemployment rate in %.
Maximum infant mortality rate in %.
Minimum infant mortality rate in %.
Maximum urban population rate in %.
Minimum urban population rate in %.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_COUNTYTool to retrieve US county information by name, ZIP code, or state. Use when you need geographic, demographic, or administrative data about US counties. Returns county name, FIPS code, location coordinates, timezone, population, and median age.
Input parameters
Number of results to return. Must be between 1 and 30. Default is 1. Premium only.
2-letter state code (e.g., 'CA', 'OR', 'NY'). At least one of county, zipcode, or state must be provided.
Full county name (e.g., 'Los Angeles County', 'Multnomah County'). At least one of county, zipcode, or state must be provided.
Number of results to offset for pagination. Default is 0. Premium only.
5-digit ZIP code to search for county information. At least one of county, zipcode, or state must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_DAD_JOKETool to retrieve random dad jokes from API Ninjas. Returns one or more dad jokes suitable for light humor. Use when you need clean, family-friendly jokes.
Input parameters
How many jokes to return. Must be between 1 and 100. Default is 1. Note: Values greater than 1 require a premium API Ninjas subscription.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_DAY_IN_HISTORYTool to get historical events for a specific date. Use when you need to retrieve events that occurred on a particular day in history. Returns events for today's date if no parameters are provided.
Input parameters
The day of the month for the historical events to retrieve. Must be between 1 and 31. If specified, month must also be provided. Premium subscription required to specify custom dates.
The maximum number of results to return. Must be between 1 and 30. Default is 1.
The month of the historical events to retrieve. Must be between 1 and 12. If specified, day must also be provided. Premium subscription required to specify custom dates.
The number of results to skip. Must be zero or a positive integer. Used for pagination. Default is 0.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_DICTIONARY_DEFINITIONTool to retrieve dictionary definition for an English word. Use when you need the meaning or definition of a word.
Input parameters
Word to look up in the dictionary. Must be a valid English word.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_DOGSTool to get information on dog breeds matching specified parameters. Use when you need breed characteristics like temperament, size, life expectancy, or other traits.
Input parameters
Dog breed name to search for (e.g., 'husky', 'labrador').
Energy level (1-5, where 1 is lowest and 5 is highest).
Number of results to offset for pagination. Use this to paginate through results by setting offset to multiples of the result limit (e.g., 0, 20, 40).
Barking level (1-5, where 1 is lowest and 5 is highest).
Shedding level (1-5, where 1 is lowest and 5 is highest).
Maximum height in inches.
Maximum weight in pounds.
Minimum height in inches.
Minimum weight in pounds.
Trainability level (1-5, where 1 is lowest and 5 is highest).
Protectiveness level (1-5, where 1 is lowest and 5 is highest).
Maximum life expectancy in years.
Minimum life expectancy in years.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_EARNINGSTool to retrieve comprehensive earnings report data for publicly traded companies. Returns financial statements including income statement, balance sheet, and cash flow data sourced from SEC filings (10-Q for Q1-Q3, 10-K for Q4). Use when you need detailed quarterly financial metrics.
Input parameters
Central Index Key (CIK) to identify the company. Either ticker or cik must be provided.
Fiscal year (e.g., 2025). Must be between 2000 and 2100. If omitted, returns most recent earnings data.
Fiscal quarter period options.
Company ticker symbol (e.g., 'AAPL', 'ADBE'). Either ticker or cik must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_ELECTRIC_VEHICLE_INFOGet electric vehicle information by make, model, year range, or electric range. Returns details including battery capacity, charging power, dimensions, and performance specs. At least one filter parameter (make, model, min_year, max_year, min_range, or max_range) is required - limit and offset alone are not sufficient.
Input parameters
Vehicle manufacturer (e.g., 'tesla', 'nissan', 'chevrolet'). Case-insensitive.
How many results to return. Must be between 1 and 10. Default is 1.
Vehicle model (e.g., 'model3', 'leaf', 'bolt'). Case-insensitive.
Number of results to skip for pagination. Default is 0.
Maximum vehicle model year (e.g., 2023). Filter results to vehicles up to this year.
Minimum vehicle model year (e.g., 2020). Filter results to vehicles from this year onwards.
Maximum electric range in kilometers (e.g., 600). Filter results to vehicles with at most this range.
Minimum electric range in kilometers (e.g., 250). Filter results to vehicles with at least this range.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_EMOJITool to retrieve emoji information and images from the API Ninjas Emoji database. Use when you need emoji metadata, Unicode codes, or emoji images based on name, code, category, or subcategory. At least one search parameter (name, code, group, or subgroup) must be provided. Returns up to 30 results per request; use offset for pagination.
Input parameters
Unicode character code for the emoji (e.g., 'U+1F642'). Must be uppercase with U+ prefix.
Descriptive name of emoji to search for (e.g., 'smile', 'heart').
Main category to filter emojis. Valid categories: smileys_emotion, people_body, component, animals_nature, food_drink, travel_places, activities, objects, symbols, flags.
Number of results to offset for pagination. Use this to retrieve results beyond the first 30. Default is 0.
Sub-category to filter emojis within a group. The subgroup must be valid for the selected group.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_EXCHANGE_RATEGet the current exchange rate for a currency pair. Returns the conversion rate from the first currency to the second currency. Use this to check current foreign exchange rates between any two currencies.
Input parameters
Currency pair in format CURRENCY1_CURRENCY2 (e.g., 'GBP_AUD', 'USD_EUR', 'JPY_USD'). Use underscore to separate the two currency codes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_EXERCISESTool to get exercise information by muscle group, type, or difficulty level. Returns up to 10 exercises that match the specified criteria. Use when you need to find exercises for specific muscle groups, workout types, or difficulty levels.
Input parameters
Name of the exercise to search for. Searches for exercises matching this name.
Exercise type categories
Target muscle group to filter by. Common values include: abdominals, abductors, adductors, biceps, calves, chest, forearms, glutes, hamstrings, lats, lower_back, middle_back, neck, quadriceps, traps, triceps.
Number of results to offset for pagination. Use this to paginate through results by setting offset to multiples of the result limit (e.g., 0, 10, 20).
Exercise difficulty levels
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_FACT_OF_THE_DAYTool to retrieve the fact of the day from API Ninjas. Returns the same fact for all users on a given day, with facts changing daily. Use when you need a daily interesting fact to display or share.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_FACTSTool to retrieve random interesting facts from API Ninjas. Returns facts about science, literature, philosophy, and other topics. Use when you need interesting factual information to display or share.
Input parameters
Number of facts to return. Must be between 1 and 100. Default is 1. Note: Requesting more than 1 fact requires a premium API Ninjas subscription.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_GDPTool to get GDP data for a country. Use when you need GDP statistics including growth rate, nominal GDP, GDP per capita, and purchasing power parity data.
Input parameters
Year for which to retrieve GDP data. At least one of country or year must be set.
Country name (case-insensitive) or 2-letter ISO-3166 alpha-2 code (e.g., 'Canada' or 'CA'). At least one of country or year must be set.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_GEOCODINGTool to convert city names to geographic coordinates (forward geocoding). Returns latitude, longitude, and country code for specified city. Use when you need to find the coordinates of a location by its name.
Input parameters
City name to geocode. Required parameter for converting a city location to latitude and longitude coordinates.
Optional US state name or abbreviation to narrow down the search. Only applicable for cities in the United States (e.g., 'California' or 'CA').
Optional 2-letter ISO 3166 alpha-2 country code to narrow down the search (e.g., 'GB' for United Kingdom, 'US' for United States). Useful when multiple cities share the same name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HELICOPTERTool to get helicopter information by manufacturer, model, and specifications. Use when you need detailed technical specifications for helicopters including speed, range, dimensions, and load capacity. At least one search parameter (manufacturer, model, or specification filter) must be provided.
Input parameters
Number of results to return. Must be between 1 and 30. Defaults to 1 if not specified.
Helicopter model name (e.g., '206L-3', 'UH-60').
Maximum range in nautical miles.
Maximum air speed ceiling in knots.
Minimum range in nautical miles.
Minimum maximum air speed in knots.
Maximum height in feet.
Maximum length in feet.
Minimum height in feet.
Minimum length in feet.
Company that designed and built the helicopter (e.g., 'Bell', 'Airbus', 'Sikorsky').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HISTORICAL_EVENTSTool to retrieve historical events by date or keywords. Use when you need information about events that happened on a specific date or related to specific topics.
Input parameters
Calendar day of the month to filter events (1-31).
Keywords or short phrases to search events. Useful for finding events related to specific topics or people.
4-digit year to filter events. Use negative values for BC/BCE dates (e.g., -351 for 351 BC).
Month number to filter events (1-12, e.g., 3 for March).
Number of results to offset for pagination. Premium feature only.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HISTORICAL_FIGURESTool to search for historical figures by name. Returns biographical information including birth/death dates, titles, awards, offices held, and family details. Use when you need information about famous people from history.
Input parameters
Name of the person to search. Supports partial matching (e.g., 'julius' will match Julius Caesar). Case-insensitive.
Number of results to offset for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HOBBIESTool to get random hobby suggestions from API Ninjas. Use when you need inspiration for new hobbies or activities, optionally filtered by category.
Input parameters
Hobby category options
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HOLIDAYSTool to retrieve holidays for a specific country and year. Use when you need information about public holidays, observances, or national holidays for planning or scheduling purposes. Supports over 230 countries worldwide.
Input parameters
Holiday type filter to narrow results (e.g., 'public_holiday', 'observance', 'national_holiday', 'religious'). If not specified, returns all holiday types.
Calendar year to retrieve holidays for (e.g., 2024, 2025). Note: This parameter requires premium subscription. If not provided, defaults to current year.
2-letter ISO 3166-1 alpha-2 country code (e.g., 'US' for United States, 'GB' for United Kingdom, 'CA' for Canada).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HOROSCOPETool to get daily horoscope for a zodiac sign. Returns the horoscope text for the specified zodiac sign and date. Use when you need astrological predictions or daily horoscope information for any of the 12 zodiac signs.
Input parameters
Historical horoscope retrieval in YYYY-MM-DD format (premium feature). Must be current date or earlier. Defaults to today's date if omitted.
The astrological sign to retrieve horoscope data for. Must be one of the 12 zodiac signs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_HOSPITALSTool to retrieve hospital information by name, location, or geographic coordinates. Use when you need to find hospitals in a specific area or search for a particular hospital by name.
Input parameters
City where the hospital is located (e.g., 'New York', 'Los Angeles').
Hospital name to search for (e.g., 'General Hospital', 'Memorial'). Partial matches are supported.
Number of results to return per request (maximum 100, free users limited to 5).
State where the hospital is located (e.g., 'NY', 'CA', 'Texas').
County where the hospital is located (e.g., 'New York County', 'Los Angeles County').
Pagination offset to skip the first N results.
Hospital ZIP code (e.g., '10001', '90001').
Maximum latitude coordinate for geographic filtering (range: -90 to 90).
Minimum latitude coordinate for geographic filtering (range: -90 to 90).
Maximum longitude coordinate for geographic filtering (range: -180 to 180).
Minimum longitude coordinate for geographic filtering (range: -180 to 180).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_INCOME_TAXGet current and historical income tax bracket rates for a country by year. Returns federal tax brackets organized by filing status (e.g., single, married, head_of_household for US) or as a single bracket list for countries without filing statuses. State/provincial data may require a premium subscription. Use this tool when you need to: - Look up tax brackets and rates for a specific country and tax year - Compare tax rates across different filing statuses - Get historical tax bracket information Supported countries include US (United States) and CA (Canada).
Input parameters
Tax year to retrieve data for (e.g., 2024, 2023). Historical data is available for past years.
2-letter ISO 3166-1 alpha-2 country code in uppercase. Supported countries include US and CA. Use 'US' for United States, 'CA' for Canada.
If true, returns only federal tax information without state/provincial details. Set to true to exclude state/province data from the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_INSIDER_TRANSACTIONSTool to get insider trading transactions for publicly traded companies. Returns SEC-filed insider trading data including purchases, sales, and awards by company executives, directors, and major shareholders. Use when you need to track insider activity, analyze insider sentiment, or research specific transactions by ticker, insider name, or transaction details.
Input parameters
Central Index Key (CIK) of the company. Alternative to ticker for identifying companies (e.g., '789019').
Maximum number of results to return. Use to limit response size.
Company ticker symbol (e.g., 'AAPL', 'MSFT'). Use to filter transactions by company stock symbol.
SEC form types for insider trading
Name of the insider (supports partial matching). Use to find transactions by a specific insider.
Type of insider
Transaction codes for insider trading
Exact transaction date in YYYY-MM-DD format. Use to find transactions on a specific date.
Type of transaction (e.g., 'Purchase', 'Sale', 'Award'). Use to filter by transaction category.
Maximum transaction date in YYYY-MM-DD format. Use with min_transaction_date to define a date range.
Minimum transaction date in YYYY-MM-DD format. Use with max_transaction_date to define a date range.
Maximum transaction value in USD. Use with min_transaction_value to define a value range.
Minimum transaction value in USD. Use to filter significant transactions (e.g., 1000000 for transactions over $1M).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_IP_LOOKUPTool to retrieve geolocation information for an IP address. Returns country, region, city, coordinates, ISP, and timezone data. Use when you need to identify the geographic location or ISP associated with an IPv4 or IPv6 address.
Input parameters
IPv4 or IPv6 address to look up. Must be in IPv4 format A.B.C.D (e.g., 8.8.8.8) or IPv6 format X:X:X:X:X:X:X:X (e.g., 2001:0db8:85a3:0000:0000:8a2e:0370:7334).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_JOKE_OF_THE_DAYTool to retrieve the joke of the day from API Ninjas. Returns the same joke for all users on a given day, with jokes changing daily. Use when you need a daily joke to display or share.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_JOKESTool to retrieve random jokes from API Ninjas. Returns one or more jokes suitable for entertainment. Use when you need general humor content.
Input parameters
How many jokes to return. Must be between 1 and 30. Default is 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_MOTORCYCLESTool to get detailed motorcycle specifications by make, model, and year. Use when you need technical data about specific motorcycle models including engine specs, dimensions, transmission, suspension, and performance data.
Input parameters
Name of manufacturer/brand. Supports partial matching (e.g., 'Harley' matches 'Harley-Davidson'). Either make or model must be provided.
Release year in YYYY format (e.g., '2022').
Name of motorcycle model. Supports partial matching (e.g., 'Ninja' matches 'Ninja 650'). Either make or model must be provided.
Number of results to offset for pagination. Default is 0. Premium feature only.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_MUTUAL_FUNDTool to get mutual fund information by ticker. Returns the fund's name, ISIN, CUSIP, and country. Note: price, expense_ratio, aum, num_holdings, and holdings require a premium API subscription and will return null for free-tier users.
Input parameters
Mutual Fund ticker symbol. Case-insensitive. Examples: 'VFIAX' (Vanguard 500 Index Fund), 'FXAIX' (Fidelity 500 Index Fund), 'FZROX' (Fidelity ZERO Total Market Index Fund).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_MX_RECORDSTool to retrieve MX (Mail Exchange) records for a specified domain. Use when you need to identify mail servers responsible for accepting email for a domain.
Input parameters
A valid domain name to query MX records for (e.g., example.com).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_PLANETSTool to retrieve detailed information about planets and exoplanets including mass, radius, orbital period, temperature, and host star data. Use when you need astronomical data about planets in the known universe. At least one parameter (other than offset) must be set.
Input parameters
The name of the planet to search for.
Offset results for pagination. Returns at most 30 results per request.
Maximum mass of the planet in Jupiters (1 Jupiter = 1.898 × 10²⁷ kg).
Minimum mass of the planet in Jupiters (1 Jupiter = 1.898 × 10²⁷ kg).
Maximum orbital period of the planet in Earth days.
Maximum average radius of the planet in Jupiters (1 Jupiter = 69911 km).
Minimum orbital period of the planet in Earth days.
Minimum average radius of the planet in Jupiters (1 Jupiter = 69911 km).
Maximum average surface temperature in Kelvin.
Minimum average surface temperature in Kelvin.
Maximum distance from Earth in light years.
Minimum distance from Earth in light years.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_POPULATIONTool to get population data for a country. Use when you need historical and forecasted population statistics including yearly changes, migration, demographics, and urban population metrics.
Input parameters
Offset results for pagination.
Country name (case-insensitive) or 2-letter ISO-3166 alpha-2 code (e.g., 'Japan' or 'JP'). At least one of country, min_population, or max_population must be set.
Maximum population of country. At least one of country, min_population, or max_population must be set.
Minimum population of country. At least one of country, min_population, or max_population must be set.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_POSTAL_CODETool to retrieve location information for Canadian postal codes. Returns city, province, coordinates, area code, and timezone data. Use when you need to find location details for a postal code or search by city/province.
Input parameters
Full city name (case-sensitive) to search for location information. Premium tier required. At least one of postal_code, city, or province must be provided.
2-letter Canadian province abbreviation (e.g., 'ON' for Ontario, 'BC' for British Columbia). Premium tier required. At least one of postal_code, city, or province must be provided.
Canadian postal code (6 or 7 characters with optional space, e.g., 'K1A0B1' or 'K1A 0B1'). At least one of postal_code, city, or province must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_PROPERTY_TAXTool to get property tax rates by city, county, or ZIP code. Use when you need effective property tax rate statistics for a specific location.
Input parameters
The ZIP Code to look up. At least one of city, county, or zip must be specified.
Full name of the city (case-sensitive). At least one of city, county, or zip must be specified.
2-letter state abbreviation (case-insensitive).
Name of the county requesting property tax data. At least one of city, county, or zip must be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_PUBLIC_HOLIDAYSTool to retrieve official public holidays for a specific country and year. Use when you need information about federal and regional public holidays for planning, scheduling, or calendar-related tasks. Supports calendar years from 1980 to 2050.
Input parameters
Calendar year to retrieve public holidays for. Must be between 1980 and 2050 (inclusive). Defaults to current year if not specified.
2-letter ISO country code or full country name (e.g., 'US', 'United States', 'GB', 'United Kingdom'). Determines which country's public holidays to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_QUOTE_OF_THE_DAYTool to retrieve the quote of the day from API Ninjas. Returns the same quote for all users on a given day, with quotes changing daily. Use when you need an inspirational or thought-provoking daily quote to display or share.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_QUOTESTool to get random quotes from famous people, filtered by category or author. Use when you need inspirational quotes, philosophical wisdom, or quotes for content creation.
Input parameters
Number of quotes to return. Must be between 1 and 10. Default is 1 if not specified.
Author name to filter quotes. Supports partial matching and is case-insensitive (e.g., 'einstein' matches 'Albert Einstein').
Comma-separated list of quote categories to filter by (e.g., 'success,wisdom'). Available categories include: wisdom, philosophy, life, truth, inspirational, relationships, love, faith, humor, success, courage, happiness, art, writing, fear, nature, time, freedom, death, leadership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RANDOM_IMAGETool to get a random image by category from API Ninjas. Use when you need random image content for display or download.
Input parameters
Image category filter (e.g., wildlife, nature, city). Premium subscription required for category filtering.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RANDOM_QUOTESTool to retrieve random quotes from API Ninjas. Filter by categories, author, or work title. Use when you need inspirational quotes, wisdom, or literary references for content or motivation.
Input parameters
Filter by work/book title using partial string matching. Matches quotes from works whose titles contain this string.
Number of random results returned (1-100 range). Default is 1. Note: This is a premium-only feature and will return an error for non-premium accounts.
Filter by author name using partial string matching. Matches quotes from authors whose names contain this string.
Comma-separated list of category names to include. Results match all specified categories. Available categories: wisdom, philosophy, life, truth, inspirational, relationships, love, faith, humor, success, courage, happiness, art, writing, fear, nature, time, freedom, death, leadership.
Comma-separated list of categories to exclude. Results won't match any listed categories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RANDOM_WORDTool to get a random English word from the API Ninjas Random Word endpoint. Use when you need random words for games, education, or creative projects. Optionally filter by word type (noun, verb, adjective, adverb).
Input parameters
Filter by word type. Options: noun, verb, adjective, adverb. Leave empty for any type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RECIPETool to search for recipes by title or ingredients from a database of over 200,000 recipes. Returns up to 10 recipes with ingredients, instructions, servings, and optional nutrition data. Use when you need recipe ideas, cooking instructions, or want to find recipes by specific ingredients.
Input parameters
Recipe title to search for. Supports partial matches (e.g., 'pasta' matches 'Pasta Carbonara'). Case-insensitive.
Number of recipe results to return. Must be between 1 and 10 (inclusive). Defaults to 1 if not specified.
Comma-separated list of ingredients to search for. Returns recipes containing the specified ingredients. Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_REVERSE_GEOCODINGTool to convert geographic coordinates to location information (reverse geocoding). Returns location name, country code, and state/region for specified coordinates. Use when you need to find address or place information from latitude and longitude.
Input parameters
Latitude coordinate in decimal degrees (range: -90 to 90). Required for reverse geocoding.
Longitude coordinate in decimal degrees (range: -180 to 180). Required for reverse geocoding.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RHYMESTool to get words that rhyme with a given word. Use when you need to find rhyming words for creative writing, poetry, or songwriting.
Input parameters
The word to find rhymes for. Must be a valid English word.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_RIDDLESTool to retrieve random riddles with answers from API Ninjas. Returns one or more riddles suitable for entertainment and brain teasers. Use when you need riddles for games, quizzes, or entertainment purposes.
Input parameters
Number of riddles to return. Must be between 1 and 20. Default is 1. Note: Requesting more than 1 riddle is a Premium only feature.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_SALES_TAXTool to get sales tax rates by ZIP code or city and state. Use when you need current sales tax rate information for a specific US location. Either provide zip_code alone OR city+state together.
Input parameters
City name. Must be used together with state parameter as alternative to zip_code. Use either zip_code alone OR city+state together.
State name. Must be used together with city parameter as alternative to zip_code. Use either zip_code alone OR city+state together.
Valid US ZIP code. Required if city and state are not provided. Use either zip_code alone OR city+state together.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_SEC_FILINGTool to retrieve SEC filing information for publicly traded companies. Returns a list of SEC filings including the filing date, form type, and direct URL to the filing document. Use when you need to access company regulatory filings like 10-K annual reports, 10-Q quarterly reports, 8-K current reports, or other SEC documents.
Input parameters
Number of results to return, from 1 to 100. By default, up to 2 results are returned. Use to control response size.
SEC filing form type to filter by (e.g., '10-K' for annual reports, '10-Q' for quarterly reports, '8-K' for current reports, 'S-1' for IPO registration, 'DEF14A' for proxy statements).
Ticker symbol of the company to search (e.g., 'AAPL' for Apple, 'MSFT' for Microsoft). Use to filter filings by company stock symbol.
End date to search filings until. Must be in YYYY-MM-DD format (e.g., '2023-12-31'). Use with start_date to define a date range.
Start date to search filings from. Must be in YYYY-MM-DD format (e.g., '2023-04-01'). Use with end_date to define a date range.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_SP500_CONSTITUENTSTool to retrieve current S&P 500 index constituents with filtering by ticker, name, sector, or date added. Use when you need information about companies in the S&P 500 index. Returns company details including ticker symbols, names, sectors, CIK numbers, sub-industries, headquarters locations, and dates added to the index.
Input parameters
Company name to search for (full or partial match). Returns companies whose names contain the search term.
Maximum number of results to return. Use this to control the size of the response.
Number of results to skip (for pagination). Use with limit to paginate through results.
GICS Sector to filter by (e.g., 'Information Technology', 'Financials', 'Health Care'). Returns companies in the specified sector.
Stock ticker symbol to filter by (e.g., 'AAPL', 'MSFT', 'GOOGL'). Returns companies matching the specified ticker.
Latest date company was added to the S&P 500 (format: YYYY-MM-DD). Returns companies added on or before this date.
Earliest date company was added to the S&P 500 (format: YYYY-MM-DD). Returns companies added on or after this date.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_STARSTool to retrieve detailed information about stars including name, constellation, coordinates, magnitude, distance, and spectral classification. Use when you need astronomical data about stars in the known universe. At least one parameter (other than offset) must be provided.
Input parameters
The name of the star to search for. Note that many star names contain Greek characters.
Offset results for pagination. Returns at most 30 results per request.
The constellation that the star belongs to.
The spectral classification of the star (e.g., O, B, A, F, G, K, M).
Maximum absolute magnitude (intrinsic brightness of the star).
Maximum apparent magnitude (brightness as seen from Earth). Lower values indicate brighter stars.
Minimum absolute magnitude (intrinsic brightness of the star).
Minimum apparent magnitude (brightness as seen from Earth). Lower values indicate brighter stars.
Maximum distance from Earth in light years.
Minimum distance from Earth in light years.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_STOCK_EXCHANGETool to retrieve stock exchange information by Market Identifier Code (MIC), name, city, or country. Use when you need details about stock exchanges including market data, location, and operational hours.
Input parameters
Market Identifier Code (MIC) to search for a specific stock exchange (e.g., 'XNYS' for New York Stock Exchange, 'XLON' for London Stock Exchange).
City where the stock exchange is located (e.g., 'New York', 'London', 'Tokyo').
Stock exchange name to search for (e.g., 'New York Stock Exchange', 'NASDAQ'). Partial matches are supported.
2-letter ISO country code (ISO-3166-1 alpha-2) to filter exchanges by country (e.g., 'US', 'GB', 'JP').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_STOCK_PRICETool to get current stock price data for any publicly traded company or index. Use when you need real-time (premium) or 15-minute delayed (free) stock prices, trading volume, and market data by ticker symbol.
Input parameters
Stock or index ticker symbol (e.g., 'AAPL' for Apple, 'GOOGL' for Google, '^DJI' for Dow Jones Industrial Average). Use standard ticker symbols as recognized by major exchanges.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_SWIFT_CODETool to get bank information from SWIFT code or search by bank name, city, or country. Use when you need to look up bank details using a SWIFT/BIC code or search for banks by various criteria. At least one parameter must be provided.
Input parameters
The name of the bank to look up. This parameter supports partial matching (premium only)
Name of the municipality where the bank operates
The SWIFT Code identifier for a specific bank to retrieve
The number of results to offset for pagination. Default is 0 (premium subscriptions only)
ISO 3166 2-letter country code designation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_THESAURUSTool to get synonyms and antonyms for an English word. Use when you need to find alternative words with similar or opposite meanings.
Input parameters
Word to find synonyms and antonyms for. Must be a valid English word.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_TICKERTool to retrieve comprehensive company profile information for publicly traded companies by stock ticker symbol. Returns executive details, financial metrics, identifiers (CIK, CUSIP, ISIN), exchange, contact information, stock price, market cap, and latest earnings data. Use when you need detailed company information for a specific ticker.
Input parameters
Stock ticker symbol (e.g., 'AAPL', 'MSFT', 'GOOGL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_TIMEZONETool to get timezone information for a location including UTC offset, local time, and timezone name. Use when you need timezone details for geographic locations or IANA timezone names. FREE tier supports timezone parameter; city, state, country, lat, and lon parameters require premium subscription.
Input parameters
Latitude coordinate in decimal degrees (range: -90 to 90). PREMIUM ONLY - requires premium API subscription. Must be used with 'lon' parameter.
Longitude coordinate in decimal degrees (range: -180 to 180). PREMIUM ONLY - requires premium API subscription. Must be used with 'lat' parameter.
City name to get timezone information. PREMIUM ONLY - requires premium API subscription.
US state name or abbreviation (only for US cities). PREMIUM ONLY - requires premium API subscription.
Country code (ISO 3166 alpha-2) or country name. PREMIUM ONLY - requires premium API subscription.
IANA timezone name (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). Available in FREE tier. Use this to get timezone details by direct timezone name lookup.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_TRIVIATool to retrieve trivia questions by category from API Ninjas. Returns trivia questions with answers from various categories like music, sports, science, and more. Use when you need trivia questions for games, quizzes, or entertainment purposes.
Input parameters
Number of trivia questions to return. Must be between 1 and 30. Default is 1. Note: Requesting more than 1 question is a premium feature.
Valid trivia categories for API Ninjas trivia endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_TRIVIA_OF_THE_DAYTool to retrieve the trivia question of the day from API Ninjas. Returns the same trivia question for all users on a given day, with questions changing daily. Use when you need a daily trivia question to display or share.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_UNEMPLOYMENTTool to get unemployment rate data for countries. Use when you need historical or current unemployment statistics by country or year.
Input parameters
Year for which to retrieve unemployment data. At least one of country or year must be provided.
Country name (case-insensitive) or 2-letter ISO-3166 alpha-2 code. Examples: 'Canada' or 'CA', 'United States' or 'US'. At least one of country or year must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_UNIVERSITYTool to retrieve university information by name or country. Use when you need details about universities in the USA or Canada including location, contact info, enrollment, tuition, and degree programs offered. At least one search parameter (name or country) is required.
Input parameters
Name of the university to search for. Can be a partial match (e.g., 'Harvard', 'MIT', 'Stanford').
Number of results to return (range: 1-30 for premium, max 5 for free tier).
Pagination offset to skip the first N results. Premium feature.
Country where university is located. Must be 'USA' or 'Canada'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_URL_LOOKUPTool to get location information for a URL domain. Returns geolocation data including country, region, city, coordinates, ISP, and timezone. Use when you need to identify the geographic location or hosting provider of a URL.
Input parameters
Valid URL to check. It supports schemes (e.g., http://example.com) as well as schemeless formats (e.g., example.com).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_WEATHERTool to retrieve current weather data for a location. Use when you need real-time weather information including temperature, humidity, wind conditions, and sunrise/sunset times. Query by city name or GPS coordinates.
Input parameters
Latitude coordinate (-90 to 90). Must be used together with lon parameter.
Longitude coordinate (-180 to 180). Must be used together with lat parameter.
City name to get weather for. Must provide either city or coordinates (lat/lon).
US state name or abbreviation (for US cities only). Use with city parameter to disambiguate locations.
Country name or ISO 3166-1 alpha-2 code. Use with city parameter to disambiguate locations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_WEATHER_FORECASTTool to retrieve 5-day weather forecast in 3-hour intervals for a location. Use when you need future weather predictions including temperature, humidity, wind, and sunrise/sunset times. Query by GPS coordinates or city name.
Input parameters
Latitude coordinate (-90 to 90). Must be used together with lon parameter.
Longitude coordinate (-180 to 180). Must be used together with lat parameter.
5-digit ZIP code for United States locations only (premium feature). Alternative to lat/lon.
City name (premium feature). Alternative to lat/lon.
US state name or abbreviation (for United States cities only, premium feature). Use with city parameter.
Country name or ISO code (premium feature). Use with city parameter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_WHOISTool to get WHOIS domain registration information including registrar, creation date, and expiration date. Use when you need details about domain registration.
Input parameters
Domain name to look up WHOIS information for (e.g., example.com). Top-level domains other than .com require a premium subscription.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_WORKING_DAYSTool to get working days for a specific country and time period. Returns the count and list of working days, accounting for weekends and public holidays. Use when you need to calculate business days, plan schedules, or determine operational days for a country.
Input parameters
Calendar year between 1980 and 2050 (inclusive). Defaults to current year if not specified.
Month number (1-12). If specified, returns working days for that specific month only.
Country code (2-letter ISO 3166-1 alpha-2 code, e.g., 'US' for United States, 'GB' for United Kingdom).
Comma-separated list of weekend days (mon,tue,wed,thu,fri,sat,sun). Overrides default weekend days for the country.
Whether to include public holidays as non-working days. Defaults to true if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_WORLDTIMETool to get current date and time for a location with detailed date/time components. Returns timezone, datetime, date, year, month, day, hour, minute, second, and day of the week. Use when you need detailed time information for a specific location or timezone.
Input parameters
Latitude coordinate in decimal degrees (range: -90 to 90). PREMIUM ONLY - requires premium API subscription. Must be used with 'lon' parameter.
Longitude coordinate in decimal degrees (range: -180 to 180). PREMIUM ONLY - requires premium API subscription. Must be used with 'lat' parameter.
City name to get current time. PREMIUM ONLY - requires premium API subscription. Can be combined with state and country for more precise results.
IANA timezone identifier (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). Available in FREE tier. Use this to get current time by timezone name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_GET_ZIPCODETool to retrieve location information for US zip codes. Returns city, state, county, coordinates, timezone, and area codes. Use when you need to find location details for a zip code or search by city/state.
Input parameters
The ZIP Code to look up (at least one of zip, city, or state must be provided).
Full name of the city to search (case-sensitive). Premium tier required. At least one of zip, city, or state must be provided.
2-letter abbreviation of the state (case-insensitive). Premium tier required. At least one of zip, city, or state must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_IBAN_LOOKUPTool to look up and validate an International Bank Account Number (IBAN). Use when you have an IBAN and need to retrieve its components (country, bank code, account number, etc.) and its validity.
Input parameters
International Bank Account Number to look up
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_INCOME_TAX_CALCULATORTool to calculate income taxes for US and Canada. Use when you need detailed breakdown of federal, state/provincial, and FICA taxes. Country and region codes must be correct.
Input parameters
Annual income amount; must be non-negative.
State/province code (e.g., 'CA', 'NY', 'ON').
2-letter country code (e.g., 'US' for United States, 'CA' for Canada). Currently only US and CA are supported.
Total tax credits amount; non-negative. Defaults to 0.
Total tax deductions amount; non-negative. Defaults to 0.
Tax filing status; required for US. Possible values: 'single', 'married', 'married_separate', or 'head_of_household'.
Set to true for self-employed tax calculations (US only). Defaults to false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_INFLATIONTool to get current inflation data for a country. Use when you need latest CPI or HICP monthly and annual inflation rates.
Input parameters
Inflation indicator type. 'CPI' = Consumer Price Index (standard national measure). 'HICP' = Harmonized Index of Consumer Prices (EU standardized measure for cross-country comparison). Defaults to 'CPI' if not specified.
Name of country (case-insensitive). If omitted, returns data for all available countries. Free tier includes: Austria, Belgium, Bulgaria, Canada, Chile, Estonia, Germany, Hungary, Iceland, Ireland, Luxembourg, Norway, Portugal, Slovakia, Sweden, Switzerland, The Netherlands. Some countries (e.g., United States) require premium subscription.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_INTEREST_RATETool to get current interest rates for central banks and benchmarks. Use when you need to fetch the latest interest rate for a specific country or all available countries.
Input parameters
Country name to filter by. Use underscore for multi-word names (e.g., 'United_States'). If omitted, returns rates for all available countries. Supported countries include: United_States, Australia, United_Kingdom, Chile, China, Czech_Republic, Denmark, Japan, Mexico, New_Zealand, Norway, Poland, Russia, Saudi_Arabia, South_Africa, South_Korea, Sweden, Switzerland, Türkiye.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_LIST_STOCK_TICKERSTool to retrieve a paginated list of all available stock ticker symbols and company names. Use when you need to browse available stocks or find ticker symbols for specific companies. Returns company tickers and names with pagination support.
Input parameters
Number of results to return. Must be between 1 and 1000.
Number of results to offset for pagination. Must be provided (use 0 for first page).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_LOOKUP_VINTool to decode Vehicle Identification Number (VIN) and retrieve vehicle information. Returns make, model, year, manufacturing country, and VIN components. Use when you need to identify vehicle specifications from a 17-character VIN.
Input parameters
17-character Vehicle Identification Number to decode
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_MARKET_CAPTool to get real-time market cap data for a company. Use when you need up-to-date market capitalization by specifying the stock ticker. Example: "What is the market cap of NVDA?"
Input parameters
Stock ticker symbol, e.g., 'NVDA'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_MORTGAGE_RATETool to get current and historical mortgage rates. Use when you need weekly fixed-rate mortgage data, optionally for specific dates or date ranges.
Input parameters
Individual date to query in YYYY-MM-DD format. Premium-only; returns the week matching this date.
Maximum date in YYYY-MM-DD format for range query (must be used with min_date). Premium-only.
Minimum date in YYYY-MM-DD format for range query (must be used with max_date). Premium-only.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_NUTRITIONTool to extract nutrition information from text query. Use when you need to parse food-related text (e.g., recipes, menus) to calculate corresponding nutrition data.
Input parameters
Text to extract nutrition information from. Specify quantities if needed (e.g., '1lb brisket and fries').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_SCRAPE_WEBSITETool to scrape HTML content from a URL using the API Ninjas Webscraper endpoint. Use when you need to retrieve website content programmatically without dealing with browser automation.
Input parameters
The website address to retrieve content from (must be a valid URL).
When enabled, extracts visible text while filtering out HTML markup and metadata. Defaults to false (returns full HTML content).
Custom User-Agent header string for the request. Use when you need to specify a particular browser or device identity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_SOLVE_SUDOKUTool to solve a Sudoku puzzle using the API Ninjas Sudoku Solver. Takes a partially filled puzzle grid and returns the complete solution if one exists. Use when you need to solve standard or custom-sized Sudoku puzzles (2x2, 3x3, or 4x4 box dimensions).
Input parameters
Width of each box in the Sudoku grid. Must be between 2 and 4. For standard 9x9 Sudoku, use width=3.
Height of each box in the Sudoku grid. Must be between 2 and 4. For standard 9x9 Sudoku, use height=3.
2D JSON array representing the Sudoku puzzle. Use 0 for empty cells. Must be passed as JSON string (e.g., '\[\[0,0,0,2,6,0,7,0,1\],\[6,8,0,0,7,0,0,9,0\],...\]').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_VALIDATE_EMAILTool to validate email address format and check deliverability. Returns validity status, domain info, MX records, disposability check, and email role categorization. Use when you need to verify if an email address is valid and deliverable before sending communications.
Input parameters
Email address to validate and check deliverability.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_VALIDATE_EU_VATTool to retrieve and validate EU VAT (Value Added Tax) rates by country code. Use when you need current or historical VAT rates for EU member states, with optional filtering by VAT type, date range, or specific categories.
Input parameters
Enumeration of VAT rate classifications.
Number of results to return. Must be between 1 and 30. Default is 5. Premium accounts only.
Number of results to skip for pagination. Default is 0. Use with limit to paginate through results. Premium accounts only.
Two-letter ISO 3166-1 alpha-2 country code for EU nations (e.g., 'FR' for France, 'DE' for Germany, 'NL' for Netherlands).
Filter results to only include VAT rates effective before this date. Must be in YYYY-MM-DD format (e.g., '2024-12-31').
Filter results to only include VAT rates effective after this date. Must be in YYYY-MM-DD format (e.g., '2020-01-01').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_VALIDATE_PHONETool to validate and format phone numbers. Returns validity status, country code, carrier information, and normalized E.164 format. Use when you need to verify phone number validity or retrieve phone metadata.
Input parameters
Phone number to validate, including country code. Should be in international format with country code prefix (e.g., +12065550100). The API accepts various formats and will normalize to E.164 standard.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_NINJAS_VALIDATE_ROUTING_NUMBERTool to validate and retrieve bank information from a routing number. Use when you need to verify a 9-digit routing number and get associated bank details including name, location, and contact information.
Input parameters
A 9-digit bank routing number to validate and look up
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 36 agents privately built on Nagent that already use API Ninjas.
Build on Nagent
Connect API Ninjas to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find API Ninjas, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, API Ninjas is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once API Ninjas is connected, you configure its 129 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop API Ninjas steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a API Ninjas event fires, the agent kicks off automatically.
Every API Ninjas action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While API Ninjas ships with 129 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching API Ninjas together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build API Ninjas-based workflows tailored to your business.