Usage Guidelines

Follow these guidelines to make requests to the REST API.

Base URL

All API URLs start with the following base URL:

https://api.addsearch.com

You can limit the pool of used API endpoint servers to a specific region by using region specific subdomains.

API endpoint base URL for servers within the EU region:

https://api-eu.addsearch.com

API endpoint base URL for servers within the US region:

https://api-us.addsearch.com

Note: Region specific endpoints only support Suggestions, Search and Analytics APIs. For Indexing and Crawl APIs you need to use the https://api.addsearch.com domain.

You have access to the REST API over HTTPS. All calls to HTTP return 405 Method Not Allowed.

Content-type

API endpoints consume and produce JSON:

application/json

Calls with JSON payload must include Content-Type header which you can add with curl using the following switch:

curl -H 'Content-Type:application/json' https://api...

Date Format

AddSearch REST API uses ISO-8601 standard as the date format. Example of an accepted timestamp is:

2015-01-30T11:17:22-02:00

Read more about ISO-8601 from w3.org.