Shodan Credits Explained

At Shodan, the amount of access you get to data and other features of the infrastructure depend on how many credits your account has available. There are 3 types of credits available at Shodan:

  1. Export credits
  2. Query credits
  3. Scan credits

Export Credits

The export credits are used to download data from the website at the rate of:

1 export credit lets you download up to 10,000 results

They are single-use which means that once you use them they don't automatically renew at the start of the month. This is different than the query and scan credits! The other 2 credit types renew automatically at the start of every month. The export credits don't - once you use them they're gone. You can purchase additional credits from this location on the website:

https://www.shodan.io/store/credits

We advise that if you're able to use the command-line or API to instead use query credits for downloading data. Check out our article on How to Download Data with the API for more information.

The Shodan Membership includes 20 export credits.

Query Credits

Query credits are used when searching Shodan via the API and one of the following 2 conditions is met:

  1. A search filter is used
  2. Page 2 or beyond is requested

Like scan credits they renew at the start of the month and provide the following amount of data:

1 query credit lets you download 100 results

Here are a few search queries and how many query credits they consume:

  • apache: search query without any filters and 1st page of results - no query credits used
  • product:mongodb: searches for MongoDB database servers and uses 1 query credit
  • 3rd page of apache: requesting the 3rd page costs 1 query credit
  • 5th page of product:mongodb: requesting the 5th page of search results for MongoDB: 1 query credit

Scan Credits

The Shodan API lets you request network scans and the number of IPs that you're able to scan is determined by the number of scan credits available on your API plan. They renew at the start of the month and are consumed at the rate of:

1 scan credit lets you scan 1 IP

To learn more about scanning via Shodan check our On-Demand Scanning introduction.

Still need help? Get in touch!
Last updated on 28th May 2018