Fotology

Fotology is a simple way to get the urls of images via Google Image Search.

The api is very simple:

fotology(searchTerm, [options]).then();

To find pictures of cats:

var fotology = require("fotology");
fotology("cats").then(function (imageURLs) {
    for (i in imageURLs)
        console.log imageURLs[i];
});

Options

To modify behaviour, pass in an options object after the search term. For example:

let options = {
    size: "large", // large images only
    language: "fr", // French
    safe: true, // force safe search on
    color: "white" // white cats only please
}
fotology("cats", options);

Option	Description	Example value
safe	Safe search	true
size	Image seize	"large"
language	Language	"fr"
color	Image color	"white"
limit	# of Results	5

safe

By default, fotology uses moderate safe search, which is what you get on Google Images by default. It will mostly use safe search unless it thinks you do not want it.

To force safe search to be on all the time, set it as true.

safe: true

To disable it, set it as false.

You cannot set safe search to moderate because it is a boolean type. The only way to use moderate safe search is by not passing it as an option, which fotology interprets as wanting moderate safe search.

size

There are 4 possible sizes:

• small
• medium
• large
• huge

For example:

size: "small"

By default, the size is not monitored for, so any size can be used.

language

This modifies the language to use when making the search. By default, it uses English.

To modify the language, please pass it in like such:

language: "fr"

for French and

language: "de"

for German.

color

By default, the images can be of any colour.

To get images of a specific colour only, please pick from and ONE OF THESE ONLY:

• black
• blue
• brown
• gray
• green
• orange
• pink
• purple
• red
• teal
• white
• yellow

Using a colour not in here will cause Google's servers to ignore you.

limit

Return between 1 and 8 result

rights

Limit search results to given license

• cc_publicdomain
• cc_attribute
• cc_sharealike
• cc_noncommercial
• cc_nonderived