Search API Connector Documentation
What is an API URL?
What is an API URL?
As you probably already know, a URL is what you see in the address bar of your browser, e.g.
When you type that URL into your browser, you're making a request to our servers, which respond by showing you the content of our website.
An API URL is exactly the same! However, instead of sending back a website, the application server will send you back the API response.
How is an API URL structured?
An API URL is structured exactly like a "regular" website URL, but the naming conventions are a bit different, and they typically adhere to a stricter organizational logic. There are 3 parts to an API URL:
- The base URL. The base URL is the initial part of the API URL. Typically all API requests to that API will use the same base URL. For example, Stripe's base URL is
- The endpoint. The endpoint identifies which data table you want to access. For example, Stripe has endpoints for
/customers, and so on.
- Query parameters. Query parameters come after an initial question mark, and are generally used to filter or customize the API request. For example, adding
?limit=100to the request would pull in 100 records.
The full API URL will combine these 3 segments into a complete URL, e.g.
How to find API Request URLs?
To find your API request URL, you'll need to check the API documentation for your API of interest.
For example, here's the API documentation for the CryptingUp API. It shows the base URL right at the top:
Below that they clearly show the endpoints and any available parameters:
Depending on the API's complexity and the strength of its documentation, available endpoints and parameters may be more or less easy to discover, but everything you need should be right there in the docs.
How to use the API Request URL?
The API request URL is the basic building block of any modern API.
Most coding languages will have a method (or plugin) that allows you to construct API requests and input your API URL.