API Ninjas

Returns a random piece of life advice. No parameters required. via GET /v1/advice

Returns a list of aircrafts that match the given parameters. This API only supports airplanes - for helicopter specs please use our Helicopter API . At least one of the following parameters (other than limit ) must be set. via GET /v1/aircraft

Convert between IATA and ICAO airport codes. Provide exactly one of iata , icao , or code . via GET /v1/airportconvert

Requires a paid API Ninjas plan. Calculate the great-circle distance, initial bearing, and an estimated flight time between two airports. via GET /v1/airportdistance

Returns a list of up to 10 airport results. Use the offset parameter to access more results if available. To look up a list of airport codes and names, use the /v1/airportslist endpoint. At least one of the following parameters (other than offset ) must be set: via GET /v1/airports

Requires an annual API Ninjas subscription. Returns a list of up to 100 airport codes and names in alphabetical order. Use the offset parameter to access more results via pagination. To look up detailed information about an airport, use the icao parameter in the /v1/airports endpoint. via GET /v1/airportslist

Requires a paid API Ninjas plan. Autocomplete / typeahead suggestions for airport search. Matches against IATA, ICAO, name, and city. Results are ranked by code-prefix match, airport size, and IATA availability. via GET /v1/airportsuggest

Get air quality by city or location coordinates (latitude/longitude). Returns the air quality index (AQI) and concentrations of major pollutants. Note: at least one of the following must be provided: lat and lon , or city . via GET /v1/airquality

Requires a paid API Ninjas plan. Returns a list of all cat breed names. via GET /v1/allcats

Requires a paid API Ninjas plan. Get a list of all 2-letter country codes for countries, territories and regions for which we have statistics. via GET /v1/allcountries

Requires a paid API Ninjas plan. Get flag images for all countries. Returns an list of countries and their flag URLs. via GET /v1/allcountryflags

Requires a paid API Ninjas plan. Returns a list of all dog breed names. via GET /v1/alldogs

Requires an API Ninjas Business or Professional plan. Returns a comprehensive list of exercises that target a specific muscle group. via GET /v1/allexercises

Requires an API Ninjas Business or Professional plan. Returns a list of all available stock exchanges and their details. This endpoint does not accept any parameters. via GET /v1/allstockexchanges

Returns up to 10 results matching the input name parameter. via GET /v1/animals

Returns 10 baby name results. via GET /v1/babynames

If you do not specify a year or period, the API will return the most recent balance sheet. via GET /v1/balancesheet

Requires an API Ninjas Developer plan or above. Balance Sheet via GET /v1/balancesheetavailability

Returns a list of bank holiday entries for a given country and year. Each entry contains the holiday name, date, day of the week, and country information. via GET /v1/bankholidays

Returns a barcode image binary specified by input parameters. via GET /v1/barcodegenerate

Returns the latest Bitcoin price in USD and 24-hour market data. Premium members have access to live prices, while free users only have access to 15-minute delayed data. For historical price data, see /v1/bitcoinhistorical . via GET /v1/bitcoin

Requires a paid API Ninjas plan. Returns historical price data for Bitcoin in USD. via GET /v1/bitcoinhistorical

Returns detailed information about an Australian bank branch based on its BSB number. via GET /v1/bsblookup

Requires a paid API Ninjas plan. BSB via GET /v1/bsbsearch

Returns a random bucket list idea. via GET /v1/bucketlist

Returns the calories burned per hour and total calories burned according to given parameters for given activities (up to 10 ). via GET /v1/caloriesburned

Requires a paid API Ninjas plan. Returns a list of all supported activities. via GET /v1/caloriesburnedactivities

Returns detailed information about a Canadian bank branch. Provide either a 9-digit routing number, or a transit number together with an institution number. At least one of routing_number , or both transit_number and institution_number together, must be set. via GET /v1/canadaroutingnumber

Requires a paid API Ninjas plan. Canada Routing Number via GET /v1/canadaroutingnumbersearch

If you do not specify a year or period, the API will return the most recent cash flow statement. via GET /v1/cashflow

Requires an API Ninjas Developer plan or above. Cash Flow via GET /v1/cashflowavailability

Get a list of cat breeds matching specified parameters. Returns at most 20 results. To access more than 20 results, use the offset parameter to offset results in multiple API calls. At least one of the following parameters (other than offset ) must be set: via GET /v1/cats

Returns a list of up to 30 celebrities that match the search parameters. To get more than 30 results, use the offset parameter. via GET /v1/celebrity

Returns a Chuck Norris joke. via GET /v1/chucknorris

Get city data from either a name or population range. Returns a list of cities that satisfies the parameters. At least one of the following parameters (other than limit and offset ) must be set: via GET /v1/city

Requires a paid API Ninjas plan. Find the airports nearest to a given latitude/longitude. Results are sorted by airport size (largest first), then by distance ascending within each size tier. Each result includes distance and bearing from the input coordinate. via GET /v1/closestairport

Returns up to 10 cocktail recipes matching the search parameters. At least one of the following parameters must be present: via GET /v1/cocktail

Requires an API Ninjas Business or Professional plan. Returns price information for a specific commodity contract or all contracts matching a commodity root. Either symbol or symbol_root must be provided, but not both. via GET /v1/commoditycontract

Requires an API Ninjas Business or Professional plan. Returns a list of all available commodity contracts with their symbols and commodity names. This endpoint is useful for discovering which contracts are available for querying. via GET /v1/commoditycontractlist

Requires an API Ninjas Business or Professional plan. Returns every active futures contract for the requested commodity, sorted by contract month, along with a curve-shape classification and 1-month and ~12-month percent slopes. This is the standard view for analyzing contango (upward-sloping curve) vs backwardation (downward-sloping). Reads from the same contracts feed as /v1/commoditycontract ; for a single contract or unfiltered contract list, use that endpoint or /v1/commoditycontractlist . via GET /v1/commodityforwardcurve

Returns the current price information for one or more commodities. Prices are based on rolling futures contracts and are quoted in the commodity's native unit and currency convention — see the unit and currency_unit fields below. Use the optional currency and unit parameters to convert into any supported currency or compatible mass/volume/energy unit. Premium members have access to live prices, while free users only have access to 15-minute delayed data. For all 30 commodities in one call, see /v1/commoditysnapshot . For historical prices, see /v1/commoditypricehistorical . via GET /v1/commodityprice

Requires a paid API Ninjas plan. Returns historical commodity futures price data in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first), and all prices are in USD. Each API call returns a maximum of 1,000 data points; narrow the time range or use a larger interval for queries that would otherwise exceed this limit. via GET /v1/commoditypricehistorical

Returns current price data for every supported commodity in a single response. Useful for dashboards, watchlists, and any UI that needs the full set of commodities. Premium members have access to live prices, while free users only have access to 15-minute delayed data. via GET /v1/commoditysnapshot

Converts an existing currency and amount into a new currency. Data freshness depends on your plan: free-tier accounts receive once-daily rates, while premium subscribers receive real-time rates. via GET /v1/convertcurrency

Not idempotent: this endpoint keeps a counter per API key and every call increments it. Fetch and possibly update a counter. via GET /v1/counter

Get country data from given parameters. Returns a list of country statistics that satisfy the parameters. via GET /v1/country

Get a country's flag as SVG image URLs. Both 1:1 and 4:3 aspect ratios are supported and returned in the response. via GET /v1/countryflag

Returns details for one or more counties matching the input parameters. For premium users, you can also specify the limit and offset parameters to paginate through results. At least one of the following parameters (except limit and offset ) must be set: via GET /v1/county

Returns either a time series of Covid-19 case counts/deaths for a country/region or a single-day snapshot of every country in the world (see parameters). Either date or country must be set. via GET /v1/covid19

Returns the current price and current time (in UNIX timestamp in seconds) for any cryptocurrency symbol. Premium members have access to live prices, while free users only have access to 15-minute delayed data. For historical price data, see /v1/cryptopricehistorical . Fiat quotes: Premium subscribers can quote any cryptocurrency in a supported fiat currency by appending the three-letter fiat code to the crypto symbol (e.g. BTCEUR , ETHJPY , TRXGBP ). via GET /v1/cryptoprice

Requires a paid API Ninjas plan. Returns historical price data for any cryptocurrency pair in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first). via GET /v1/cryptopricehistorical

Requires a paid API Ninjas plan. The Crypto Symbols API provides a list of all available cryptocurrency ticker symbols. It can be used in conjunction with the Crypto Price API to retrieve price data. Returns a list of available cryptocurrency symbols that have pricing information. via GET /v1/cryptosymbols

Requires a paid API Ninjas plan. Returns the latest realized (or EWMA) volatility for a currency pair over a lookback window, together with a volatility cone across standard window lengths and HV rank / percentile context. via GET /v1/currencyvolatility

Requires a paid API Ninjas plan. Returns forward-looking volatility estimates for a currency pair using EWMA (RiskMetrics) or GARCH(1,1). GARCH adds mean reversion toward a long-run volatility level; if the GARCH fit does not converge the response falls back to EWMA. These are model-based estimates, not predictions. via GET /v1/currencyvolatilityforecast

Requires a paid API Ninjas plan. Returns a daily time series of trailing rolling volatility for a currency pair over a date range, with each point tagged by its percentile rank, plus a volatility cone snapshot as of the end date. via GET /v1/currencyvolatilityhistorical

Returns one (or more) random dad jokes. Free users have access to 100 jokes - premium users have access to over 15,000 dad jokes. via GET /v1/dadjokes

Returns historical events that occurred on a specific date. If no date parameters are provided, returns events for today's date. via GET /v1/dayinhistory

Returns a string containing definitions for a given word. via GET /v1/dictionary

Returns metadata for a given email address, including whether it is from a disposable email provider. We maintain a large database of hundreds of thousands of disposable domains and check against it for every email address. via GET /v1/disposableemailchecker

Returns a list of DNS records associated with a particular domain. via GET /v1/dnslookup

Get a list of dog breeds matching specified parameters. Returns at most 20 results. To access more than 20 results, use the offset parameter to offset results in multiple API calls. At least one of the following parameters (excluding offset ) is required. via GET /v1/dogs

Returns availability, registration lifecycle, and email/hosting intelligence for a given domain name. via GET /v1/domain

Returns a list of past earnings results and upcoming earnings dates. You can query by ticker symbol to get earnings for a specific company, by a single date, or by a date range. Up to 50 earnings results are returned per request. Business-tier responses additionally include earnings intelligence derived from each report: EPS/revenue beat-or-miss, surprise history and beat streak, standardized unexpected earnings (SUE), the one-day post-earnings price move, days to next earnings, and SEC 8-K–confirmed report date/time. At least one of ticker , date , date_start , or date_end must be provided. date cannot be combined with date_start or date_end . via GET /v1/earningscalendar

Requires a paid API Ninjas plan. Returns a list of all available companies in the earnings calendar. Use it to find tickers for the /v1/earningscalendar endpoint. This endpoint does not require any parameters. via GET /v1/earningscalendarlist

Requires a paid API Ninjas plan. Returns the earnings transcript for a given company earning quarter. Developer tier includes transcripts from the most recent 5 years; the complete archive (2005 onwards) is available to Business and Professional subscribers. See pricing . Either ticker or cik must be provided. If year and quarter are not provided, the latest earnings call transcript will be returned. via GET /v1/earningstranscript

Requires a paid API Ninjas plan. Returns a list of all companies with earnings transcripts. Note: Use /v1/earningstranscriptsearch to find the list of transcripts for a given company. via GET /v1/earningstranscriptlist

Requires an API Ninjas Business or Professional plan. Returns the people who appeared on a given company's earnings calls - executives and sell-side analysts - with stats scoped to that company. Use speaker_type=executive for the management roster or speaker_type=analyst for the analysts who cover the stock. Either ticker or cik must be provided. via GET /v1/earningstranscriptparticipants

Requires a paid API Ninjas plan. Returns a list of available earnings call transcripts for a given company, date, or date range. Use ticker, CIK, a single date, or a start_date/end_date window to search. Results are paginated and sorted by call date (most recent first). At least one of ticker , cik , date , or start_date / end_date must be provided. via GET /v1/earningstranscriptsearch

Requires an API Ninjas Business or Professional plan. One endpoint with two modes. Without an id , it searches the people who appear on earnings calls (company executives and sell-side analysts) and returns a paginated list. With an id , it returns that single speaker's full profile, a per-company coverage rollup, and their paginated appearance history. via GET /v1/earningstranscriptspeaker

Get electric vehicle data from given parameters. Returns a list of electric vehicles that satisfy the parameters. At least one parameter (other than limit and offset ) is required. via GET /v1/electricvehicle

Requires an API Ninjas Business or Professional plan. Returns a list of all electric vehicle makes (manufacturers). via GET /v1/electricvehiclemakes

Requires an API Ninjas Business or Professional plan. Returns a list of all electric vehicle models for a given make (manufacturer). via GET /v1/electricvehiclemodels

Returns a list of emojis according to input parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in multiple API calls. At least one of the following parameters (other than offset ) must be set: via GET /v1/emoji

Returns comprehensive information about any ETF by its ticker. Premium members have access to live prices, while free users only have access to 15-minute delayed data. via GET /v1/etf

Requires an API Ninjas Business or Professional plan. Returns ETF ticker symbols supported by the ETF API, paginated up to 1000 per call. Useful for discovering which tickers can be passed to /v1/etf or /v1/etfsearch . Increment the offset parameter by 1000 until fewer than 1000 results are returned to walk the entire list. via GET /v1/etflist

Requires an API Ninjas Business or Professional plan. Search for ETFs matching a combination of filters. Results are sorted by assets under management (descending) and capped at 50 per page. Use the offset parameter to paginate. At least one filter parameter is required. At least one of the following parameters must be provided. via GET /v1/etfsearch

EV Charger via GET /v1/evcharger

Returns the exchange rate for a given currency pair. Data freshness depends on your plan: free-tier accounts receive once-daily exchange rates, while premium subscribers receive real-time rates. via GET /v1/exchangerate

Requires a paid API Ninjas plan. Returns daily historical exchange rates for a given currency pair. Data is available back to January 1, 1999 for most currency pairs. via GET /v1/exchangeratehistorical

Look up a company by ticker , cik , or company name . Each response covers one fiscal year — the latest by default, or a specific year . The free tier returns the CEO's total for the latest year; premium plans unlock the full per-component breakdown, all named executives, historical years, and Pay Versus Performance. via GET /v1/executivecompensation

Returns up to 5 exercises that satisfy the given parameters. via GET /v1/exercises

Returns a single fact for the current day. The same fact is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No parameters are available for this endpoint to ensure everyone sees the same fact of the day. via GET /v1/factoftheday

Returns one (or more) random facts. Free users have access to 100 facts - premium users have access to over 500,000 facts. via GET /v1/facts

Shares that did not settle on the contractual settlement date, published semi-monthly by the SEC. Persistent, large fails are the closest public signal to naked shorting. Note: a security is listed only on dates it actually had a settlement failure, so an absent date means no material fails rather than no data. via GET /v1/failstodeliver

Get GDP data from given parameters. Returns GDP statistics that satisfy the parameters. At least one of the following parameters must be set: country , year via GET /v1/gdp

Get current city coordinates by city and country name. At least one of the following parameters must be set: via GET /v1/geocoding

Requires a paid API Ninjas plan. Returns the current gold futures price in USD. Premium members have access to live prices, while free users only have access to 15-minute delayed data. For historical gold futures prices, see /v1/goldpricehistorical . via GET /v1/goldprice

Requires a paid API Ninjas plan. Returns historical gold futures price data in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first), and all prices are in USD. via GET /v1/goldpricehistorical

Get helicopter technical specifications that match the given parameters. via GET /v1/helicopter

Returns a list of up to 10 events that match the search parameters. Use the offset parameter to paginate through more results. via GET /v1/historicalevents

Returns a list of up to 10 people that match the search parameters. via GET /v1/historicalfigures

Returns a random hobby and a Wikipedia link detailing the hobby. via GET /v1/hobbies

Returns the daily horoscope for a specific zodiac sign. Optionally, you can provide a date parameter to get historical horoscopes. via GET /v1/horoscope

Get hospital data based on given parameters. Returns a list of hospitals that match the specified criteria. At least one parameter (other than offset ) must be provided. Free users are limited to 5 results per request. Premium users can use the limit parameter to get up to 100 results per request and can use the offset parameter to paginate through more results. via GET /v1/hospitals

Returns detailed information on a given IBAN. via GET /v1/iban

If you do not specify a year or period, the API will return the most recent income statement. via GET /v1/incomestatement

Requires an API Ninjas Developer plan or above. Income Statement via GET /v1/incomestatementavailability

Returns comprehensive annual tax calculations including federal, state/provincial, and FICA taxes where applicable. via GET /v1/incometaxcalculator

Requires a paid API Ninjas plan. Returns current monthly and annual inflation percentages. List of Supported countries ▶ via GET /v1/inflation

Requires a paid API Ninjas plan. Returns historical inflation rates for a given country and (optionally) time range. The maximum number of data points returned per API call is 100 . via GET /v1/inflationhistorical

Requires a paid API Ninjas plan. Returns detailed transaction information for a given insider with optional filtering by company. via GET /v1/insiderdetails

Requires a paid API Ninjas plan. Returns a list of all insiders for a given company (via ticker or CIK). For each insider, returns their name, position, and current share holdings based on their most recent filing. via GET /v1/insiderslist

Returns a list of insider trading transactions that match the specified filters. All parameters are optional and can be combined for advanced filtering. via GET /v1/insidertransactions

Returns the portfolio of a 13F filer for a quarter — one record per holding. Identify the manager with cik or manager_name ; defaults to the most recent reported quarter. via GET /v1/institutionalholdings

Requires a paid API Ninjas plan. Directory and filing history of 13F institutions — the lookup that resolves a manager name to a CIK before you call /v1/institutionalholdings . The parameter you pass selects the mode; with no parameters it returns the most recent quarter's filings. via GET /v1/institutionalinvestors

Requires an API Ninjas Business or Professional plan. The biggest institutional moves of a quarter — a market-wide leaderboard, or (with cik ) the largest moves within a single institution. via GET /v1/institutionalmovers

Institutional ownership of a stock — every 13F manager holding a given security for a quarter. With summary=true it returns a single ownership-concentration aggregate instead of the holder list. Free tier is limited to the most recent quarter. via GET /v1/institutionalownership

Returns the location of the IP address specified. The response contains both the geographical coordinates (latitude/longitude) as well as the city and country. via GET /v1/iplookup

Returns a list of IPO records matching your filters. With no parameters, returns the current IPO calendar — companies in registration plus IPOs listed in the last 90 days, most recent first. Up to 50 records are returned per request by default (configurable via limit , max 1000). All parameters are optional. via GET /v1/ipocalendar

Returns whether a given date is a bank holiday for a given country. via GET /v1/isbankholiday

Returns a list of all holidays that fall on a given date. If no country is specified, holidays from all countries matching the date are returned. via GET /v1/isholiday

Returns whether a given date is a public holiday for a given country. via GET /v1/ispublicholiday

Returns whether a given date is a working day for a given country. via GET /v1/isworkingday

Returns a single joke for the current day. The same joke is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No parameters are available for this endpoint to ensure everyone sees the same joke of the day. via GET /v1/jokeoftheday

Returns one (or more) random funny jokes. Free users have access to 100 jokes - premium users have access to over 20,000 jokes. via GET /v1/jokes

Requires a paid API Ninjas plan. Returns historical LIBOR rates for a specified tenor. You can specify a time range to retrieve data from. The maximum number of data points returned per API call is 100 . via GET /v1/liborhistorical

Get a list of company names, ticker symbols, and logo image URLs matching the input parameters. Returns at most 10 results. via GET /v1/logo

Returns one or more paragraphs of lorem ipsum placeholder text. via GET /v1/loremipsum

Returns the current market cap data for any given company ticker. Premium members have access to live prices, while free users only have access to 15-minute delayed data. via GET /v1/marketcap

Returns monthly payment, annual payment, and interest rate information based on given mortgage parameters. via GET /v1/mortgagecalculator

Canonical carrier profile. Provide exactly one of dot or mc . via GET /v1/motorcarrier

Requires an API Ninjas Business or Professional plan. Policy-level insurance filings for a carrier: form code, insurer, policy number, coverage amount, and effective and cancellation dates. Requires a Business or higher subscription . via GET /v1/motorcarrierinsurance

Requires an API Ninjas Business or Professional plan. Other carriers that share a physical address, telephone number, email domain or company officer with the carrier you asked about, flagged when any of them holds revoked or suspended authority. Requires a Business or higher subscription . via GET /v1/motorcarrierlinks

Crash counts by severity, inspection and out-of-service rates measured against the national average, and public BASIC results from FMCSA's Safety Measurement System. via GET /v1/motorcarriersafety

Find carriers by name or location, or reverse-look-up a phone number or email address. At least one parameter is required. via GET /v1/motorcarriersearch

Requires an API Ninjas Business or Professional plan. Returns a list of all motorcycle makes (manufacturers). via GET /v1/motorcyclemakes

Requires an API Ninjas Business or Professional plan. Returns a list of all motorcycle models for a given make (manufacturer). via GET /v1/motorcyclemodels

Returns up to 30 motorcycle results matching the input name parameters. For searches that yield more than 30 results, please use the offset parameter. via GET /v1/motorcycles

Returns comprehensive information about any Mutual Fund by its ticker. via GET /v1/mutualfund

Returns a list of MX records associated with a particular domain. Free users receive only data from the first MX record, while premium users get access to all MX records. via GET /v1/mxlookup

Returns the official title, description, full hierarchy, children, index terms and cross-reference rules for a NAICS 2022 code. Pass crosswalk_to to also map the code to an earlier NAICS revision. via GET /v1/naics

Requires an API Ninjas Business or Professional plan. Assigns one primary NAICS code to a free-text business description by applying NAICS’s own rules: the primary-activity test, the cross-reference exclusions, and establishment scope. Classification is powered by a language model tuned for this task and constrained to the official Census index, so it is fast and never returns a code outside the published taxonomy. The deciding rule and the official index term that matched are both returned, so the classification can be justified during an audit. via GET /v1/naicsclassify

Requires an API Ninjas Business or Professional plan. Returns an industry-level KYB and underwriting risk profile for a NAICS code. This describes an industry, never a specific business. It is API Ninjas analysis derived from public FinCEN and FFIEC guidance and published card-network restricted-business lists, and it is not a compliance determination or a consumer report. via GET /v1/naicsrisk

Returns ranked candidate codes for a keyword or phrase, scored against the 20,373 official Census index terms plus titles and descriptions. Every result names the index term that matched, so you can see why it ranked. No classification rules are applied — use /v1/naicsclassify when you need one decided answer. via GET /v1/naicssearch

Requires an API Ninjas Developer plan or above. Returns the SBA small-business size standard for a NAICS code, taken from 13 CFR 121.201 . Supply revenue or employees and the response adds an eligibility verdict with remaining headroom. This is informational and is not an SBA size determination. via GET /v1/naicssizestandard

This endpoint uses AI to automatically read any text and extract every food item it contains, along with the right portion for each. It can process multiple food items at once — simply copy and paste any text, such as a recipe or your food journal, directly, and it will return the nutrition data for every food item found. Items without a specified amount default to a 100g serving. If this isn't what you're looking for and you'd prefer to input items traditionally — a single food item with a specific quantity to get the nutrition for just that item — use the /v1/nutritionitem endpoint instead. via GET /v1/nutrition

Requires an API Ninjas Business or Professional plan. Search branded and packaged foods by product name , brand , or UPC/EAN barcode to get nutrition information, allergens, and ingredients. This endpoint is powered by a comprehensive database of foods. A barcode lookup returns a single product; a name or brand search returns a ranked list of matching products. Provide at least one of upc , name , or brand . via GET /v1/nutritionbranded

Returns nutrition information for a single food item with a specific quantity. This endpoint supports various units of measurements for the quantity parameter. via GET /v1/nutritionitem

Returns the current price for an oil or energy benchmark. Free accounts receive the daily closing price for WTI and Brent; premium members get real-time prices for all benchmarks. For historical prices, see /v1/oilpricehistorical . via GET /v1/oilprice

Requires a paid API Ninjas plan. Returns historical oil price data in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first). via GET /v1/oilpricehistorical

Returns a random password string adhering to the specified parameters. via GET /v1/passwordgenerator

Requires a paid API Ninjas plan. Returns per-paycheck federal withholding, FICA (Social Security, Medicare, Additional Medicare), and optional state withholding given gross pay and W-4 inputs. Federal withholding uses IRS Publication 15-T percentage method tables for both the 2020-or-later and pre-2020 W-4 forms. via GET /v1/paycheckwithholding

Returns carrier, line type, and network metadata for a given phone number. via GET /v1/phonelookup

Get a list of planets matching specified parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in multiple API calls. At least one of the following parameters (other than offset ) must be set: via GET /v1/planets

Get population data from given parameters. Returns a list of up to 5 country population statistics that satisfy the parameters. For more results use the offset parameter. At least one of the following parameters must be set: country , min_population , max_population via GET /v1/population

Returns a list of postal code details matching the input parameters. Formatting is flexible. Spaces, hyphens and country prefixes are normalized, so 1011AB and 1011 AB both resolve, as do L-4968 and 4968 . At least one of postal_code , city or region must be set: via GET /v1/postalcode

Returns the censored version (bad words replaced with asterisks) of any given text and whether the text contains profanity. via GET /v1/profanityfilter

Returns a list of regions and corresponding 25th, 50th (median), and 75th percentile effective property tax rates. The region is mostly zipcode-based, but sometimes a single zipcode can contain multiple regions due to local tax laws. The maximum number of results returned is 100. At least one of the following parameters must be set: city , county , zip . via GET /v1/propertytax

Returns a list of public holidays for a given country and year. To look up whether a given date is a public holiday, use the /v1/ispublicholiday endpoint instead. via GET /v1/publicholidays

Returns a QRCode image binary specified by input parameters. via GET /v1/qrcode

Returns a random image in JPEG format. via GET /v1/randomimage

Returns a list of cities that contain a given latitude and longitude. via GET /v1/reversegeocoding

Returns a list of rhyming words for any given word. via GET /v1/rhyme

Returns one or more random riddles. Plan Available Riddles Free 100 riddles Premium only More than 10,000 riddles via GET /v1/riddles

Returns detailed information about a bank based on its routing number. via GET /v1/routingnumber

Requires a paid API Ninjas plan. Routing Number via GET /v1/routingnumbersearch

Returns one or more sales tax breakdowns by ZIP code according to the specified parameters. Each breakdown includes the state sales tax (if any), county sales tax (if any), city sales tax (if any), and any additional special sales taxes. All tax values are presented in decimals (e.g. 0.1 means 10% tax). Exactly one of the following must be set: zip_code or ( city + state ) via GET /v1/salestax

Calculates sales tax for a given amount and location. Returns a detailed breakdown including state, county, city, and special district taxes, along with the calculated tax amount and total amount after tax. amount is required, and exactly one of the following must be set: zip_code or ( city + state ) via GET /v1/salestaxcalculator

Requires a paid API Ninjas plan. Returns US sales tax economic nexus thresholds, and optionally determines whether a seller has crossed them. Call it with no sales figures to use it as a reference lookup of each state's rules, or supply your sales figures to get a determination. Omit state to evaluate all 50 states and DC in a single request. Every nexus or no_nexus answer is provable from the figures you supply. Where your inputs cannot settle the question, the endpoint returns indeterminate together with a required_input array naming exactly which parameter would resolve it, rather than guessing. This matters because states measure different quantities: taxable sales are a subset of retail sales, which are a subset of gross sales, so Florida (which measures taxable sales) and Michigan (which measures gross sales including exempt ones) can reach opposite conclusions on the same seller. This endpoint evaluates economic nexus only . Physical presence — inventory, employees, offices, contractors, trade shows — can create nexus at any sales volume and is not considered. It is reference data, not tax advice. This endpoint is available to premium subscribers only. Requests on the free tier return an error. All parameters are optional. With none set, the endpoint returns the threshold rules for every jurisdiction. via GET /v1/salestaxnexus

Returns ranked sanctions matches for the supplied name with confidence scores from 0 to 100. List coverage by subscription tier: Free — OFAC SDN only, individuals only, limited response fields. Developer — adds the EU Consolidated Financial Sanctions List and entity screening. Business and above — adds UK, UN, and Australian DFAT lists; vessel and aircraft screening; phonetic and transliteration matching; full per-source list_versions and stale_data_warning on every response. See pricing for a complete feature comparison. via GET /v1/sanctionsscreening

Returns a list of SEC filing information (including the submission URL) corresponding to the given search parameters. via GET /v1/sec

Returns sentiment analysis score and overall sentiment for a given block of text. via GET /v1/sentiment

Returns the latest bi-weekly short interest for a security, plus history. Free plans get the latest settlement date including the exact short_percent_outstanding ; premium plans add percent of float, dollar notional short, the two-year percentile, split-adjusted history and the full archive back to December 2017. via GET /v1/shortinterest

Settlement dates, member reporting deadlines and FINRA publication dates. Short interest changes only 24 times a year, so this lets you schedule refreshes instead of polling. Available on every plan, including free. via GET /v1/shortinterestcalendar

Requires an API Ninjas Business or Professional plan. Ranks the entire US equity universe for a settlement date — this is how you find the most shorted stocks. Sort by percent of float, percent of outstanding, days to cover, two-week change, dollar notional short or the two-year percentile, and narrow by sector, exchange, price or size. Because short percent of float is derived rather than reported, add exclude_capped_float=true and max_float_price_gap_days=7 to restrict a ranking to floats that were actually measured. via GET /v1/shortinterestscreener

Daily Reg SHO short sale volume — the portion of a day's off-exchange volume flagged as short sales. Updated every trading day, so it moves between the bi-weekly short interest readings. This is not short interest, and not a percent of total market volume. FINRA covers only trades reported to its Trade Reporting Facilities, roughly 35–52% of consolidated volume. A ratio near 50% is normal: it mostly reflects wholesalers filling retail buy orders from inventory, which books as a short sale. via GET /v1/shortvolume

Returns detailed information about a UK bank branch based on its sort code. via GET /v1/sortcode

Requires a paid API Ninjas plan. Sort Code via GET /v1/sortcodesearch

Returns spelling corrections and suggestions for any given text. via GET /v1/spellcheck

Get a list of stars matching specified parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in multiple API calls. At least one of the following parameters (other than offset ) is required. via GET /v1/stars

Returns detailed information about stock exchanges matching the specified criteria. At least one parameter is required. To get a list of all available stock exchanges, use the /v1/allstockexchanges endpoint. via GET /v1/stockexchange

Requires an API Ninjas Business or Professional plan. Returns holiday calendars for stock exchanges, including full closures and early close days. If no parameters are specified, returns holidays for all exchanges. Only confirmed future holidays are included — additional holidays will be added as they are officially confirmed by each exchange. via GET /v1/stockexchangeholidays

Requires an API Ninjas Business or Professional plan. Check if stock exchanges are open on a specific date or at a specific point in time. Returns trading hours (adjusted for early closures and holidays) and open/closed status. via GET /v1/stockexchangehours

Requires a paid API Ninjas plan. Returns up to 50 of the most recent stock-market news headlines, sorted most recent first. Use the optional ticker parameter to filter by one or more symbols. This endpoint is available to premium subscribers only. via GET /v1/stocknews

Returns price information for any given ticker symbol. Premium members have access to live prices, while free users only have access to 15-minute delayed data. via GET /v1/stockprice

Requires a paid API Ninjas plan. Returns historical price data in OHLCV (Open, High, Low, Close, Volume) format for any given ticker symbol. To get the 'price' for a particular period, use the close value from the response. The most recent 5 years of data are available on all paid tiers. Access to the full archive (older than 5 years, back to IPO) requires a Business, Professional, Enterprise, or annual subscription. See pricing . via GET /v1/stockpricehistorical

Requires a paid API Ninjas plan. Returns a list of all available companies and their ticker symbols. Supports pagination to retrieve results in batches. via GET /v1/stockpricelist

Returns a list of stock split records matching your filters. With no parameters, returns splits dated between 30 days ago and 30 days from now (recent and upcoming). Up to 50 records are returned per request by default (configurable via limit , max 1000). All parameters are optional. via GET /v1/stocksplit

Generate a new Sudoku puzzle with specified parameters. via GET /v1/sudokugenerate

Solve an existing Sudoku puzzle. via GET /v1/sudokusolve

Returns a list of bank information (including SWIFT/BIC Code) that match the input parameter. Returns at most 100 results. For more results, use the offset parameter. At least one of the parameters below must be set. via GET /v1/swiftcode

Returns the language name and 2-letter ISO language code for a given block of text string. via GET /v1/textlanguage

Returns a list of synonyms and a list of antonyms for a given word. via GET /v1/thesaurus

Returns comprehensive company profile information including company name, CEO, address, financial data, exchange information, identifiers (CIK, CUSIP, ISIN), and latest earnings information when available. via GET /v1/ticker

Requires a paid API Ninjas plan. Returns a list of at most 100 ticker symbols matching a given company name. Results are sorted by exchange size (largest exchanges first) to prioritize the most common listings. via GET /v1/tickersearch

Get timezone info by city/state/country or location coordinates (latitude/longitude). Returns the timezone name of the specified input location and the time offset in seconds. Note: at least one of the following must be provided: timezone , lat and lon , or city . via GET /v1/timezone

Returns the latest yield curve for the requested type . The current curve is free; a specific historical date and the combined type=all response require a premium subscription. via GET /v1/treasuryyield

Requires a paid API Ninjas plan. Returns a historical time series for a single maturity . Omit maturity to get the full curve per date. This endpoint requires a premium subscription. via GET /v1/treasuryyieldhistorical

Returns a random trivia question and answer. Free users have access to 100 trivia questions - premium users have access to over 100,000 trivia questions. via GET /v1/trivia

Returns a single trivia question and answer for the current day. The same question is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No filtering parameters are available for this endpoint to ensure everyone sees the same trivia of the day. via GET /v1/triviaoftheday

Get unemployment data for a given country. Returns historical, current and forecast unemployment statistics. At least one of the following parameters must be set: country , year via GET /v1/unemployment

Returns conversions between different units of the same measurement type. via GET /v1/unitconversion

Returns information about universities matching the provided filters. At least one filter parameter is required. Free users can use name or country - all other filters are premium-only . via GET /v1/university

Requires a paid API Ninjas plan. Returns a list of upcoming earnings dates with filtering capabilities. You can filter by date range, single date, exchange, or ticker symbol. Results are limited to dates from today onwards. All parameters are optional. If no parameters are provided, returns upcoming earnings from today onwards (up to 100 results). via GET /v1/upcomingearnings

Returns the location of the IP address hosting the URL domain. The response contains both the geographical coordinates (latitude/longitude) as well as the city and country. via GET /v1/urllookup

Generates a realistic user agent string based on optional parameters. via GET /v1/useragentgenerate

Returns metadata (including whether it is valid) for a given email address. This API will check the formatting of the email and the existence of DNS records for the domain to make sure it is a valid email address. via GET /v1/validateemail

Returns metadata (including whether it is valid) for a given phone number. via GET /v1/validatephone

Returns VAT rates for a specified EU country. Results include standard rate, reduced rates, super-reduced rates, and any special categories. Standard rates are available to all users. Rate values for all other rate types (reduced, super-reduced, exempted, parking) are available to premium subscribers only — free accounts still see these entries, but the rate field contains a premium-only notice instead of the numeric rate. By default up to 5 results are returned. Use the limit and offset parameters to paginate through results. via GET /v1/vat

Validates a VAT number from any of the 27 EU member states or Northern Ireland ( XI ). Format and checksum validation, registry status, and cached answers are available to all users. To obtain a consultation_number — the official EU record proving you checked a customer, required as audit evidence when zero-rating intra-EU B2B sales — pass your own company's VAT number in the requester_vat parameter. via GET /v1/vatvalidation

Returns key vehicle information including manufacturer, country of origin, and model year for a given VIN. via GET /v1/vinlookup

Get current weather, wind speed and direction, humidity, and temperature data by city, ZIP code, or geolocation coordinates (latitude/longitude). One of the following parameter combinations must be provided: lat and lon city , state (optional), and country (optional) via GET /v1/weather

Returns a 5-day weather forecast in 3-hour intervals for a given city. One of the following parameter combinations must be provided: via GET /v1/weatherforecast

Returns the URL information and web page metadata from a given URL. via GET /v1/webpage

Returns the HTML or plaintext data scraped from a given URL. Maximum size of data returned is 2MB . via GET /v1/webscraper

Returns domain registration details (e.g. registrar, contact information, expiration date, name servers) for a given domain name. via GET /v1/whois

Returns a list of working days and non-working days for a given country and year/month. To check if a specific date is a working day, use the /v1/isworkingday endpoint instead. via GET /v1/workingdays

Get the current date and time by city/state/country, location coordinates (latitude/longitude), or timezone. One of the following parameter combinations must be provided: timezone lat and lon city (optionally with state and/or country ) via GET /v1/worldtime

Returns a list of ZIP Code details matching the input parameters. At least one of the following parameters must be set: via GET /v1/zipcode

Returns detailed information about a bank based on the BIN number provided. via GET /v2/bin

Returns the available values and counts for each dimension, narrowed by whatever is already selected. Available on every plan, including Free. This builds every dependent dropdown in one request rather than one request per level: ask for the facets you need, and pass the user's current selection to narrow the rest. via GET /v2/carfacets

Requires an API Ninjas Business or Professional plan. Lists the generations of a model. Useful when you want to browse by generation or chassis code — but optional, since /v2/cars accepts generation and chassis_code directly. One generation often covers several chassis codes. BMW's 2004–2010 3 Series is E90 (saloon), E91 (Touring), E92 (coupé) and E93 (convertible) — one generation, four codes. So chassis_codes lists them all, and passing chassis_code=E91 finds the generation that contains it. via GET /v2/cargenerations

Requires a paid API Ninjas plan. Lists vehicle manufacturers. via GET /v2/carmakes

Requires a paid API Ninjas plan. Lists the models of one manufacturer. Pass the make as a word — bmw , BMW and Bmw all resolve, as do 3 Series , 3-series and 3series . via GET /v2/carmodels

Requires a paid API Ninjas plan. The main endpoint. Search all 84,177 cars by any combination of filters, or fetch cars you already know by id . Either way every car comes back with its full specification sheet attached , so there is never a second call to make. There is no hierarchy to walk first — ?body=Wagon&fuel=diesel&min_power_hp=150 works on its own. At least one filter, or an id , is required. The total number of matches comes back in the X-Total-Count response header. via GET /v2/cars

Returns a JSON array of detailed earnings reports, each with comprehensive financial statements and key performance metrics. Query a single company by ticker or cik , or query every company that filed within a date range using date or date_start / date_end . Results are paginated 50 per page via offset . Q1, Q2, and Q3 earnings data are sourced from the 10-Q filings. Q4 earnings data is sourced from the 10-K filings by subtracting the Q1, Q2, and Q3 earnings from the 10-K earnings for income statement fields. Query by company — pass a ticker or cik — or query every company by filing date using date , or date_start / date_end for a range, with no ticker required. With only a ticker (no year or period), all of that company's filings are returned, most recent first. Results are paginated 50 per page — use offset to page through them. via GET /v2/earnings

Returns a list of holiday entries for a given country and year. Each entry in the response contains the holiday name, date, day of the week, and the type of holiday. via GET /v2/holidays

Returns comprehensive income tax information including tax brackets and rates at both federal and state/provincial levels (where applicable). via GET /v2/incometax

Get a specific interest rate by name. Returns the rate value, name, and last updated timestamp. via GET /v2/interestrate

Returns historical interest rates for specific central banks or benchmark rates using a single rate parameter. You can specify a time range to retrieve data from. Data points are returned oldest first, and the maximum number returned per API call is 100 . When more data is available the response includes a next cursor — pass it back as the page parameter to retrieve the following page. History depth varies by publisher: the US and Canadian prime rates go back to 1990, Japan to 1989 and Brazil to 2011, while South Africa, China and Malaysia start from when we began collecting them, since their publishers only serve current values. via GET /v2/interestratehistorical

Returns the daily 30-year and 15-year fixed-rate mortgage (FRM) data. If no parameters are set, the mortgage rate data for the most recent day is returned. via GET /v2/mortgagerate

Requires an annual API Ninjas subscription. Returns a list of authors who have at least 2 aphoristic quotes in the database. Authors are sorted by the number of quotes (descending) and then alphabetically by name. Default returns 100 authors (maximum 500 per request). via GET /v2/quoteauthors

Returns a single aphoristic quote for the current day. The same pre-vetted, high-quality quote is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No filtering parameters are available for this endpoint to ensure everyone sees the same quote of the day. via GET /v2/quoteoftheday

Returns high-quality quotes with advanced filtering by categories (include/exclude), author, work, and pagination support. Returns quotes in deterministic order. For random quotes, use /v2/randomquotes or /v2/quoteoftheday . The following categories are available: wisdom philosophy life truth inspirational relationships love faith humor success courage happiness art writing fear nature time freedom death leadership via GET /v2/quotes

Returns random high-quality quotes with advanced filtering by categories (include/exclude), author, and work. Each request returns different random quotes. The categories available are the same as for /v2/quotes . via GET /v2/randomquotes

Returns fake random user profiles. Supports customizable fields, filtering, and localization. via GET /v2/randomuser

Returns a random word. via GET /v2/randomword

Parses a user agent string to extract device, operating system, and browser information. All response fields are top-level. Invalid or unrecognized user agents return HTTP 200 with is_valid: false and invalid_reason set; data fields are null in that case. via GET /v2/useragentparse

Get a list of recipes for a given recipe name or ingredient(s). Returns a list of recipes. To access more results, use the limit parameter to limit the number of results and the offset parameter to offset results for pagination in multiple API calls. Either title or ingredients parameter must be provided. via GET /v3/recipe

Returns a 768-dimensional vector as an array that encodes the meaning of any given input text. via POST /v1/embeddings

Returns a similarity score between 0 and 1 (1 is similar and 0 is dissimilar) of two given texts. via POST /v1/textsimilarity