🎉 Try the public beta of the new docs site at algolia.com/doc-beta! 🎉
Algolia CLI / Commands

Manage your Algolia crawlers.

algolia crawler crawl

Usage
algolia crawler crawl <crawler_id> --urls <url>... [flags]

Crawl specific URLs.

Examples

1
2
3
4
5
6
7
8
9
# Crawl the URLs "https://www.example.com" and "https://www.example2.com/" for the crawler with the ID "my-crawler"
$ algolia crawler crawl my-crawler --urls https://www.example.com,https://www.example2.com/

# Crawl the URLs "https://www.example.com" and "https://www.example2.com/" for the crawler with the ID "my-crawler" and save them in the configuration
$ algolia crawler crawl my-crawler --urls https://www.example.com,https://www.example2.com/ --save

# Crawl the URLs "https://www.example.com" and "https://www.example2.com/" for the crawler with the ID "my-crawler" and don't save them in the configuration
$ algolia crawler crawl my-crawler --urls https://www.example.com,https://www.example2.com/ --save=false

Flags

-s, --save

When true, the given URLs are added to the extraUrls list of your configuration (unless already present in startUrls or sitemaps).
When false, the URLs aren’t saved in the configuration.
When unspecified, the URLs are added to the extraUrls list of your configuration, but only if they haven’t been indexed during the last reindex, and they aren’t already present in startUrls or sitemaps.
.

-u, --urls

The URLs to crawl (maximum 50).

algolia crawler create

Usage
algolia crawler create <name> -F <file> [flags]

Create a crawler.

Examples

1
2
3
4
5
6
# Create a crawler named "my-crawler" with the configuration in the file "config.json"
$ algolia crawler create my-crawler -F config.json

# Create a crawler from another crawler's configuration
$ algolia crawler get another-crawler --config-only | algolia crawler create my-crawler -F -

Flags

-F, --file

Path to the configuration file (use “-“ to read from standard input).

algolia crawler get

Usage
algolia crawler get <crawler_id> [flags]

Get a crawler.

Examples

1
2
3
4
5
6
# Get the crawler with the ID "my-crawler"
$ algolia crawler get my-crawler

# Get the crawler with the ID "my-crawler" and display only its configuration
$ algolia crawler get my-crawler --config-only

Flags

-c, --config-only

Display only the crawler configuration.

algolia crawler list

Usage
algolia crawler list [flags]

List crawlers.

Examples

1
2
3
4
5
6
7
8
9
# List all crawlers
$ algolia crawler list

# List crawlers with the name "my-crawler"
$ algolia crawler list --name my-crawler

# List crawlers with the appID "my-app-id"
$ algolia crawler list --app-id my-app-id

Flags

--app-id

Filter by appID.

--name

Filter by name.

Output formatting flags

--allow-missing-template-keys

If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.

-o, --output

Output format. One of: (json, jsonpath, jsonpath-as-json, jsonpath-file).

--template

Template string or path to template file to use when –output=jsonpath, –output=jsonpath-file.

algolia crawler pause

Usage
algolia crawler pause <crawler_id>... [flags]

Pause one or multiple crawlers.

Examples

1
2
3
4
5
6
# Pause the crawler with the ID "my-crawler"
$ algolia crawler pause my-crawler

# Pause the crawlers with the IDs "my-crawler-1" and "my-crawler-2"
$ algolia crawler pause my-crawler-1 my-crawler-2

algolia crawler reindex

Usage
algolia crawler reindex <crawler_id>... [flags]

Reindex one or multiple crawlers.

Examples

1
2
3
4
5
6
# Reindex the crawler with the ID "my-crawler"
$ algolia crawler reindex my-crawler

# Reindex the crawlers with the IDs "my-crawler-1" and "my-crawler-2"
$ algolia crawler reindex my-crawler-1 my-crawler-2

algolia crawler run

Usage
algolia crawler run <crawler_id> [flags]

Run a crawler.

Examples

1
2
3
# Run the crawler with the ID "my-crawler"
$ algolia crawler run my-crawler

algolia crawler stats

Usage
algolia crawler stats <crawler_id> [flags]

Get statistics about a crawler.

Examples

1
2
3
# Get statistics about the crawler with the ID "my-crawler"
$ algolia crawler stats my-crawler

Output formatting flags

--allow-missing-template-keys

If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.

-o, --output

Output format. One of: (json, jsonpath, jsonpath-as-json, jsonpath-file).

--template

Template string or path to template file to use when –output=jsonpath, –output=jsonpath-file.

algolia crawler test

Usage
algolia crawler test <crawler_id> --url <url> [-F <file>] [flags]

Test a URL on a crawler.

Examples

1
2
3
4
5
6
# Test the URL "https://www.example.com" against the crawler with the ID "my-crawler"
$ algolia crawler test my-crawler --url https://www.example.com

# Test the URL "https://www.example.com" against the crawler with the ID "my-crawler" and override the configuration with the file "config.json"
$ algolia crawler test my-crawler --url https://www.example.com -F config.json

Flags

-F, --config

The configuration file to use to override the crawler’s configuration. (use “-“ to read from standard input).

-u, --url

The URL to test.

algolia crawler unblock

Usage
algolia crawler unblock <crawler_id> [flags]

Unblock a crawler.

Examples

1
2
3
# Unblock the crawler with the ID "my-crawler"
$ algolia crawler unblock my-crawler

Did you find this page helpful?