This RESTful API allows data to be retrieved remotely in either a jSON or XML format. The API includes methods for retrieving info about tracks, sound effects, etc.
Music Tacks API
This API is accessed via the edd-api end point, like so:
https://www.hooksounds.com/edd-api/
Paging Parameters
By default, the API will return 10 results per page for tracks queries.
If a query has 20 results, the first ten will be displayed by default, but then the second 10 can be accessed by adding &page=2 to the query string, like so:
Example: https://www.hooksounds.com/edd-api/products/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&page=2
You can change the number of results returned by using the number parameter. This example will return 25 results per page:
Example: https://www.hooksounds.com/edd-api/products/?key=KEY&token=TOKEN&number=25
Search
If you want to make a text search, you can use the ‘s’ parameter:
https://www.hooksounds.com/edd-api/products/?key=KEY&token=TOKEN&s=your text search
BPM filters
To filter results for a certain BPM range, you can use the ‘minBpm’ and ‘maxBpm’ parameters.
https://www.hooksounds.com/edd-api/products/?key=KEY&token=TOKEN&minBpm=80&maxBpm=120
Music Track details
If you want to retrieve info for only a specific product, you can pass a product ID via the product parameter:
Example: http://www.hooksounds.com/edd-api/products/?key=KEY&token=TOKEN&product=7500
NOTE: The ID of a particular track could be taken from the track’s unique URL. Thus, the track https://www.hooksounds.com/royalty-free-music/positive-rock/7500/ has the ID 7500.
Here is an example of a typical response which includes the music track metadata:
Sound Effects API
For accessing our sound effects API, you will need an API key and Token. Once you have it, you’ll be able to access like so:
https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN
Example: https://www.hooksounds.com/edd-api/sfx/?key=1cf0a95be875d9eeb20&token=a95be875d9eeb284fb
Paging Parameters
By default, the API will return 10 sound effects per page.
If the query has more than 10 results, the first 10 will be displayed by default, but then the second 10 can be accessed by adding the parameter &page=2 to the query string, like so:
https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&page=2
The page size can also be modified by using the number parameter.
https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&page=2&number=20
Search
If you want to make a text search, you can use the ‘s’ parameter:
https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&s=your text search
Category Filters
If you want to filter by category, you’ll be able to do it by adding the category parameter to the query string. You’ll need the category ID for that.
Example: The category ‘logging’ has the ID 41989
https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&category=41989
The parameter pages works the same way when filtering categories.
Example: https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&page=2&category=41989
Instead of the category ID, the slug can be used:
Example: https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&category=logging
You can also provide a comma separated list of categories:
Example: https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&category=41989,42061,42054
Duration Filter
If you want to filter sound effects by duration, you can use the ‘minDuration’ and ‘maxDuration’ parameters. They receive numbers (int) with an amount of seconds.
They can be used together in combination or either one alone.
Example: https://www.hooksounds.com/edd-api/sfx/?key=KEY&token=TOKEN&minDuration=10&maxDuration=18
Here is an example of a typical response which includes the sound effect metadata:
List categories
If you want to retrieve a list of sound effect categories, you can use the following endpoint:
https://www.hooksounds.com/edd-api/sfx-categories/?key=KEY&token=TOKEN
Intros API
For accessing our intros API, you will need an API key and Token. Once you have it, you’ll be able to access like so:
https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN
Example: https://www.hooksounds.com/edd-api/intros/?key=1cf0a95be875d9eeb20&token=a95be875d9eeb284fb
Paging Parameters
By default, the API will return 10 intros per page.
If the query has more than 10 results, the first 10 will be displayed by default, but then the second 10 can be accessed by adding the parameter &page=2 to the query string, like so:
https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&page=2
The page size can also be modified by using the number parameter.
https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&page=2&number=20
Search
If you want to make a text search, you can use the ‘s’ parameter:
https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&s=your text search
Tag Filters
If you want to filter by tags, you’ll be able to do it by adding the tag parameter to the query string. You’ll need the tag ID for that.
Example: The tag ‘electronic’ has the ID 47074
https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&tag=47074
The parameter pages works the same way when filtering categories.
Example: https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&page=2&tag=47074
Instead of the tag ID, the slug can be used:
Example: https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&tag=electronic
You can also provide a comma separated list of categories:
Example: https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&tag=47074,47155,47110
Duration Filter
If you want to filter intros by duration, you can use the ‘minDuration’ and ‘maxDuration’ parameters. They receive numbers (int) with an amount of seconds.
They can be used together in combination or either one alone.
Example: https://www.hooksounds.com/edd-api/intros/?key=KEY&token=TOKEN&minDuration=10&maxDuration=18
List tags
If you want to retrieve a list of intro tags, you can use the following endpoint:
https://www.hooksounds.com/edd-api/intro-tags/?key=KEY&token=TOKEN
Whitelist API
This API is accessed via the business end point, like so:
https://www.hooksounds.com/api/business/v1/whitelist?key=KEY&token=TOKEN
To create a new whitelist, make a POST request to the URL (with the key and token parameters), and a JSON body with the channel data:
{ "channel":"https://www.youtube.com/@HookSounds" }
A channel can be any of the following:
- Youtube Channel Username URL
- Youtube Channel ID URL
- Facebook profile URL
- Instagram profile URL
- Tiktok profile URL
