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.

Was this helpful?

Need more help?

We’re always happy to help with code or other questions you might have. Search our documentation, contact support, or connect with our sales team.