{"info":{"_postman_id":"0cd22703-5cb8-4c3c-b51e-18bab7846b5d","name":"Storyblocks API Reference","description":"

The Storyblocks API provides access to our entire library of media and related utilities. It is currently running on version 2.0.

\n

API Domains

\n

All content types and endpoints are available on a single domain: https://api.storyblocks.com

\n

Authentication

\n

The StoryBlocks API uses a keyed-hash message authentication code (HMAC) to validate API requests. Each client is assigned a public key and a secret key.

\n

Each API request requires three additional url parameters:

\n
    \n

  1. APIKEY​: The client's public key.

    \n
    2. \n

  2. EXPIRES​: An expiration time in seconds since the Unix epoch (January 1,1970). For more information, visit https://www.epochconverter.com/.

    \n\n
    3. \n

  3. HMAC​: Authentication code.

    \n\n
    4. \n
\n

Authentication Errors

\n

If an error is encountered, the status code will be 40x and the response will include information about what went wrong.

\n

Example Authentication

\n

Example code is provided here to aid you in generating an HMAC.

\n

Obtaining Keys

\n

Test keys are restricted to internal use, solely for testing purposes, and will have lower limits than full access keys.

\n

To obtain free test keys, visit https://developer.storyblocks.com/register

\n

Visit https://www.storyblocks.com/business-solution/api for more information. Get a quote from the same page or contact API Sales at enterprise@storyblocks.com if you're interested in obtaining full access keys.

\n

Limits

\n

API calls are limited at the endpoint level, and can vary for each client as they are formulated in the agreement with Storyblocks. For example, requests made to the search endpoint will have a different limit than those made to the download endpoint. In both cases, these limits will be lower for test keys than for full access keys.

\n

Required Query Parameters

\n

We require a user_id and project_id for all search and download requests. If your use case conflicts with this requirement, contact us.

\n

user_id - A unique user identifier in your system. This can be an id or an alphanumeric string. Please do not use names or emails.

\n

project_id - A unique identifier of the project in your system. This can be an id or an alphanumeric string.

\n

Why provide user_id and project_id?

\n
    \n

  1. Better search results: This information helps us tie downloads to specific searches so we know what content your users liked best.

    \n
    2. \n

  2. Better technical support: If one of your customer's is having an issue, our team can replay exactly what happened for this specific user by matching up the ids.

    \n
    3. \n

  3. It helps us pay artists fairly: In 2018 we launched a revenue sharing program to pay our content contributors, and we use this information to weight downloads equally no matter how many times they were re-downloaded.

    \n
    4. \n
\n

Notes

\n\n

Quick Links

\n\n

Contact Us

\n

enterprise@storyblocks.com

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"10518637","collectionId":"0cd22703-5cb8-4c3c-b51e-18bab7846b5d","publishedId":"SztG3m1i","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-11-20T12:31:49.000Z"},"item":[{"name":"Search","item":[{"name":"/api/v2/videos/search","id":"51b6b1b7-c95c-450c-b61d-c323a5b7c472","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/search?project_id=&user_id=&keywords=&content_type=&quality=&min_duration=&max_duration=&has_talent_released=&has_property_released=&has_alpha=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&safe_search=&frame_rates=&extended=&is_vr_360=&orientation=","description":"

Search for video stock items. Filter the results using any of available query parameters listed below. Note that there is a limit of 10k search results returned for any search.

\n","urlObject":{"protocol":"https","path":["api","v2","videos","search"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""},{"description":{"content":"

Search for content matching these keywords. Multiple values can be separated with a comma.

\n","type":"text/plain"},"key":"keywords","value":""},{"description":{"content":"

Filter by general content type. Multiple can be provided as a comma separated list. Possible values include footage, motionbackgrounds, templates, and all. Defaults to all.

\n","type":"text/plain"},"key":"content_type","value":""},{"description":{"content":"

Filter videos by quality available. Possible values include HD, 4K, and ALL. Defaults to ALL.

\n","type":"text/plain"},"key":"quality","value":""},{"description":{"content":"

Search for content with a duration of at least this value in seconds.

\n","type":"text/plain"},"key":"min_duration","value":""},{"description":{"content":"

Search for content with a duration of at most this value in seconds.

\n","type":"text/plain"},"key":"max_duration","value":""},{"description":{"content":"

Search for content that explicitly has or does not have a Talent Release form on file.

\n","type":"text/plain"},"key":"has_talent_released","value":""},{"description":{"content":"

Search for content that explicitly has or does not have a Property Release form on file.

\n","type":"text/plain"},"key":"has_property_released","value":""},{"description":{"content":"

Search for content that has an alpha layer.

\n","type":"text/plain"},"key":"has_alpha","value":""},{"description":{"content":"

Search for content that has been been flagged for editorial use.

\n","type":"text/plain"},"key":"is_editorial","value":""},{"description":{"content":"

Search for content belonging to these comma separated category ids. The category ids can be found using the Categories endpoint. Be sure to pass the apporpriate content_type for these categories as returned by the Categories endpoint.

\n","type":"text/plain"},"key":"categories","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"

Receive this many stock items in one page of results. Defaults to 20. Note that results_per_page cannot exceed 250 and page * results_per_page cannot exceed 10,000.

\n","type":"text/plain"},"key":"results_per_page","value":""},{"description":{"content":"

Sort results by internal metrics. Possible values include most_relevant, most_downloaded, most_recent, trending_now, and undiscovered. Defaults to most_relevant.

\n","type":"text/plain"},"key":"sort_by","value":""},{"description":{"content":"

Change the order of results you receive. Possible values include ASC and DESC.

\n","type":"text/plain"},"key":"sort_order","value":""},{"description":{"content":"

Content must match all of these comma separated keywords.

\n","type":"text/plain"},"key":"required_keywords","value":""},{"description":{"content":"

Content must not match any of these comman separated keywords.

\n","type":"text/plain"},"key":"filtered_keywords","value":""},{"description":{"content":"

Search for SAFE_FOR_WORK content only.

\n","type":"text/plain"},"key":"safe_search","value":""},{"description":{"content":"

Filter by frame rate. Multiple can be provided as a comma separated list. Possible values include 24, 25, 30, 50, 60.

\n","type":"text/plain"},"key":"frame_rates","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, categories, description, isEditorial, isStereo, hasTalentReleased, hasPropertyReleased, hasAudio, hasAlpha, maxResolution, aspectRatio, dateAdded, and durationMs.

\n","type":"text/plain"},"key":"extended","value":""},{"description":{"content":"

Search for VR/360° content or exclude it from search results.

\n","type":"text/plain"},"key":"is_vr_360","value":""},{"description":{"content":"

Filter by orientation. Possible values include: horizontal, vertical, all.

\n","type":"text/plain"},"key":"orientation","value":""}],"variable":[]}},"response":[{"id":"7c4b7d83-4d2e-44ae-ae4e-5b8d2e9aaca1","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&quality=&min_duration=&max_duration=&has_talent_released=&has_property_released=&has_alpha=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=&orientation=","protocol":"https","host":["api","storyblocks","com"],"path":["api","v2","videos","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"quality","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"has_alpha","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""},{"key":"orientation","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1,\n\t\"results\": [\n\t\t{\n\t\t\t\"id\": 11851,\n\t\t\t\"title\": \"Slow Motion Falling Money\",\n\t\t\t\"type\": \"footage\",\n \"contentClass\": \"video\",\n \"is_new\": false,\n\t\t\t\"thumbnail_url\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/thumbnail/slow-motion-falling-money_-jjatxweb__S0000.jpg\",\n\t\t\t\"preview_urls\": {\n\t\t\t\t\"_180p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\t\"_360p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\t\"_480p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\t\"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n\t\t\t},\n\t\t\t\"duration\": 21,\n \"durationMs\": 20670,\n \"orientation\": \"horizontal\"\n\t\t}\n\t]\n}"},{"id":"8c4fdbb9-c3b7-4a84-bf8b-a867f2d74ab0","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&quality=&min_duration=&max_duration=&has_talent_released=&has_property_released=&has_alpha=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"quality","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"has_alpha","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"95bce948-0e53-4609-ac0d-ba152a70a678","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&quality=&min_duration=&max_duration=&has_talent_released=&has_property_released=&has_alpha=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"quality","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"has_alpha","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"51b6b1b7-c95c-450c-b61d-c323a5b7c472"},{"name":"/api/v2/audio/search","id":"e4fbb5b0-0864-4e2a-8281-6c12b50f9a3e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/search?project_id=&user_id=&keywords=&content_type=&min_duration=&max_duration=&min_bpm=&max_bpm=&has_vocals=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&safe_search=&extended=","description":"

Search for many audio stock items. Filter the results using any of available query parameters listed below. Note that there is a limit of 10k search results returned for any search.

\n","urlObject":{"protocol":"https","path":["api","v2","audio","search"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""},{"description":{"content":"

Search for content matching these keywords. Multiple values can be separated with a comma.

\n","type":"text/plain"},"key":"keywords","value":""},{"description":{"content":"

Filter by general content type. Multiple can be provided as a comma separated list. Possible values include music, sfx, and all. Defaults to all.

\n","type":"text/plain"},"key":"content_type","value":""},{"description":{"content":"

Search for content with a duration of at least this value in seconds.

\n","type":"text/plain"},"key":"min_duration","value":""},{"description":{"content":"

Search for content with a duration of at most this value in seconds.

\n","type":"text/plain"},"key":"max_duration","value":""},{"description":{"content":"

Search for content with a bpm (beats per minute) of at least this value. Only applies if the content_type is music.

\n","type":"text/plain"},"key":"min_bpm","value":""},{"description":{"content":"

Search for content with a bpm (beats per minute) of at most this value. Only applies if the content_type is music.

\n","type":"text/plain"},"key":"max_bpm","value":""},{"description":{"content":"

Search for content that has a vocal aspect.

\n","type":"text/plain"},"key":"has_vocals","value":""},{"description":{"content":"

Search for content belonging to these comma separated category ids. The category ids can be found using the Categories endpoint. Be sure to pass the apporpriate content_type for these categories as returned by the Categories endpoint.

\n","type":"text/plain"},"key":"categories","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"

Receive this many stock items in one page of results. Defaults to 20. Note that results_per_page cannot exceed 250 and page * results_per_page cannot exceed 10,000.

\n","type":"text/plain"},"key":"results_per_page","value":""},{"description":{"content":"

Sort results by internal metrics. Possible values include most_relevant, most_downloaded, most_recent, trending_now, and undiscovered. Defaults to most_relevant.

\n","type":"text/plain"},"key":"sort_by","value":""},{"description":{"content":"

Change the order of results you receive. Possible values include ASC and DESC.

\n","type":"text/plain"},"key":"sort_order","value":""},{"description":{"content":"

Content must match all of these comma separated keywords.

\n","type":"text/plain"},"key":"required_keywords","value":""},{"description":{"content":"

Content must not match any of these comman separated keywords.

\n","type":"text/plain"},"key":"filtered_keywords","value":""},{"description":{"content":"

Search for SAFE_FOR_WORK content only.

\n","type":"text/plain"},"key":"safe_search","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, bpm, moods, genres, instruments, soundEffects, hasTalentReleased, hasPropertyReleased, durationMs, topTags, dateAdded, artists, pro, publisher and publisherPro.

\n","type":"text/plain"},"key":"extended","value":""}],"variable":[]}},"response":[{"id":"40963586-a506-4fce-86b0-0e1556c95bde","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&min_duration=&max_duration=&min_bpm=&max_bpm=&has_vocals=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"min_bpm","value":""},{"key":"max_bpm","value":""},{"key":"has_vocals","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1,\n\t\"results\": [\n\t\t{\n\t\t\t\"id\": 148396,\n\t\t\t\"title\": \"Inspiring Soft Background\",\n\t\t\t\"type\": \"music\",\n \"contentClass\": \"audio\",\n \"is_new\": false,\n\t\t\t\"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music/thumbs/BsTwCwBHBjzwub4i4/sw-1117-inspiring-soft-background-47.png\",\n \"waveform_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music/thumbs/BsTwCwBHBjzwub4i4/sw-1117-inspiring-soft-background-47.json\",\n\t\t\t\"preview_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music...\",\n\t\t\t\"duration\": 140,\n \"durationMs\": 140000,\n\t\t\t\"bpm\": 114\n\t\t}\n\t]\n}"},{"id":"4d7e124d-fb8d-419f-814b-9923fa95574b","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&min_duration=&max_duration=&min_bpm=&max_bpm=&has_vocals=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"min_bpm","value":""},{"key":"max_bpm","value":""},{"key":"has_vocals","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"c3e783ed-b23e-4f7a-a063-35eb7f71f975","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&min_duration=&max_duration=&min_bpm=&max_bpm=&has_vocals=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"min_duration","value":""},{"key":"max_duration","value":""},{"key":"min_bpm","value":""},{"key":"max_bpm","value":""},{"key":"has_vocals","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"e4fbb5b0-0864-4e2a-8281-6c12b50f9a3e"},{"name":"/api/v2/images/search","id":"ae3e53a1-a9f5-45ef-afc7-9a0f9b33f228","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/search?project_id=&user_id=&keywords=&content_type=&orientation=&color=&has_transparency=&has_talent_released=&has_property_released=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&safe_search=&extended=","description":"

Search for many image stock items. Filter the results using any of available query parameters listed below. Note that there is a limit of 10k search results returned for any search.

\n","urlObject":{"protocol":"https","path":["api","v2","images","search"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""},{"description":{"content":"

Search for content matching these keywords. Multiple values can be separated with a comma.

\n","type":"text/plain"},"key":"keywords","value":""},{"description":{"content":"

Filter by general content type. Multiple can be provided as a comma separated list. Possible values include photos, illustrations, vectors, snapshots, and all. Defaults to all.

\n","type":"text/plain"},"key":"content_type","value":""},{"description":{"content":"

Filter by image orientation. Possible values include portrait, square, landscape, and all. Defaults to all.

\n","type":"text/plain"},"key":"orientation","value":""},{"description":{"content":"

A 6 character hexadecimal value of a color (e.g.​ ​#BADA55)​. When provided, only content that has the provided color will be included.

\n","type":"text/plain"},"key":"color","value":""},{"description":{"content":"

Search for content that explicitly does or does not have an alpha channel. Content with an alpha channel is considered to have transparency.

\n","type":"text/plain"},"key":"has_transparency","value":""},{"description":{"content":"

Search for content that explicitly has or does not have a Talent Release form on file.

\n","type":"text/plain"},"key":"has_talent_released","value":""},{"description":{"content":"

Search for content that explicitly has or does not have a Property Release form on file.

\n","type":"text/plain"},"key":"has_property_released","value":""},{"description":{"content":"

Search for content that has been been flagged for editorial use.

\n","type":"text/plain"},"key":"is_editorial","value":""},{"description":{"content":"

Search for content belonging to these comma separated category ids. The category ids can be found using the Categories endpoint. Be sure to pass the apporpriate content_type for these categories as returned by the Categories endpoint.

\n","type":"text/plain"},"key":"categories","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"

Receive this many stock items in one page of results. Defaults to 20. Note that results_per_page cannot exceed 250 and page * results_per_page cannot exceed 10,000.

\n","type":"text/plain"},"key":"results_per_page","value":""},{"description":{"content":"

Sort results by internal metrics. Possible values include most_relevant, most_downloaded, most_recent, trending_now, and undiscovered. Defaults to most_relevant.

\n","type":"text/plain"},"key":"sort_by","value":""},{"description":{"content":"

Change the order of results you receive. Possible values include ASC and DESC.

\n","type":"text/plain"},"key":"sort_order","value":""},{"description":{"content":"

Content must match all of these comma separated keywords.

\n","type":"text/plain"},"key":"required_keywords","value":""},{"description":{"content":"

Content must not match any of these comman separated keywords.

\n","type":"text/plain"},"key":"filtered_keywords","value":""},{"description":{"content":"

Search for SAFE_FOR_WORK content only.

\n","type":"text/plain"},"key":"safe_search","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, hasTalentReleased, hasPropertyReleased, categories, description, isEditorial, aspectRatio, dateAdded, and colors.

\n","type":"text/plain"},"key":"extended","value":""}],"variable":[]}},"response":[{"id":"be8991f7-4714-4143-81cf-f953d03c292b","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&orientation=&color=&has_transparency=&has_talent_released=&has_property_released=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"orientation","value":""},{"key":"color","value":""},{"key":"has_transparency","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1,\n\t\"results\": [\n\t\t{\n\t\t\t\"id\": 800953,\n\t\t\t\"title\": \"Deep space background with nebulae\",\n\t\t\t\"type\": \"photo\",\n \"contentClass\": \"image\",\n \"is_new\": false,\n\t\t\t\"thumbnail_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/thumbnail/rDtN98Qoishumwih/deep-space-background-with-nebulae_r7NpVyflR_thumb.jpg\",\n\t\t\t\"preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\"\n\t\t}\n\t]\n}"},{"id":"3a89d7f7-6b71-4707-b756-dbac5f28c7c1","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&orientation=&color=&has_transparency=&has_talent_released=&has_property_released=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"orientation","value":""},{"key":"color","value":""},{"key":"has_transparency","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"a98983c8-5813-4a83-a0e9-87f804dd997f","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/search?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=&keywords=&content_type=&orientation=&color=&has_transparency=&has_talent_released=&has_property_released=&is_editorial=&categories=&page=&results_per_page=&sort_by=&sort_order=&required_keywords=&filtered_keywords=&contributor_id=&safe_search=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","search"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""},{"key":"keywords","value":""},{"key":"content_type","value":""},{"key":"orientation","value":""},{"key":"color","value":""},{"key":"has_transparency","value":""},{"key":"has_talent_released","value":""},{"key":"has_property_released","value":""},{"key":"is_editorial","value":""},{"key":"categories","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""},{"key":"sort_by","value":""},{"key":"sort_order","value":""},{"key":"required_keywords","value":""},{"key":"filtered_keywords","value":""},{"key":"contributor_id","value":""},{"key":"safe_search","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"ae3e53a1-a9f5-45ef-afc7-9a0f9b33f228"}],"id":"27d385c5-9249-428c-bc98-a6a61c2a9e2f","description":"

Search for stock assets from our library. Filter by using the dozens of query parameters listed below to narrow your results.

\n","_postman_id":"27d385c5-9249-428c-bc98-a6a61c2a9e2f"},{"name":"Details","item":[{"name":"/api/v2/videos/stock-item/details/:stock_item_id","id":"e4d549f5-711b-4a2a-a97d-50d1f487b433","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/stock-item/details/:stock_item_id","description":"

Get details about a specific video stock item

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","details",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"973c7670-2c91-465e-8fb8-1cfec5d077db","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api","storyblocks","com"],"path":["api","v2","videos","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"project_id","value":""},{"key":"","value":"","disabled":true}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"id\": 11851,\n\t\"title\": \"Email Animation Background\",\n\t\"type\": \"Motion BG\",\n \"contentClass\": \"video\",\n \"is_new\": false,\n\t\"thumbnail_url\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/thumbnail/BKaAXTX/email-animation-background_7jotd3b__S04.jpg\",\n \"preview_urls\": {\n \"_180p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_360p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_480p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n },\n\t\"download_formats\": {\n\t\t\"MP4\": {\n\t\t\t\"_1080p\": {\n\t\t\t\t\"format_name\": \"HDMP4 - potentially a point of confusion that this is 'format_name' and the key for this object is called the same\",\n\t\t\t\t\"file_size_bytes\": 40663693,\n\t\t\t\t\"height\": 1080,\n\t\t\t\t\"width\": 1920,\n\t\t\t\t\"bitrate_kbps\": 31736,\n\t\t\t\t\"frame_rate\": 29.97,\n\t\t\t\t\"video_codec\": \"h264\",\n\t\t\t\t\"resolution\": 1080\n\t\t\t}\n\t\t}\n\t},\n\t\"categories\": [\n\t\t\"business\",\n\t\t\"motion-backgrounds\"\n\t],\n\t\"keywords\": [\n\t\t\"business\",\n\t\t\"electronic\",\n\t\t\"computer\"\n\t],\n \"duration\": 11,\n \"durationMs\": 10944,\n \"orientation\": \"vertical\",\n \"description\": null,\n \"expiration_date\": null,\n \"content_id\": 71090305,\n \"url_id\": \"closeup-timelapse-83n0xez\",\n \"asset_id\": \"SBV-71090305\",\n \"has_alpha\": null,\n \"contributor\": {\n \"username\": \"Storyblocks Video\"\n },\n \"is_editorial\": false,\n \"has_talent_released\": false,\n \"has_property_released\": false\n}"},{"id":"589b3ba7-fd15-437d-8052-e9cb8b7d3bfc","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"aff9b13c-0931-44a7-9c50-2d4a62039afc","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"e6e33063-72ea-458c-b142-23c763328b41","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"e4d549f5-711b-4a2a-a97d-50d1f487b433"},{"name":"/api/v2/audio/stock-item/details/:stock_item_id","id":"b401c4b9-c0a6-4751-97c7-5a33c57c73c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/stock-item/details/:stock_item_id","description":"

Get details about a specific audio stock item

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","details",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"dfadb75b-1fbe-4d32-b948-12f3f0d0b24f","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"id\": 44020,\n\t\"title\": \"Water Bottle Lid Twist Off\",\n\t\"type\": \"sfx\",\n \"contentClass\": \"audio\",\n \"is_new\": false,\n \"preview_url\": \"https://dv7auk4chfeq0.cloudfront.net/audio/sfx/mp3preview/BsTwCw.mp3\",\n\t\"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/sfx/thumbs/BsTwCw.png\",\n \"waveform_url\": \"https://d1490khl9dq1ow.cloudfront.net/thumbnails/audio/BsTwCw.json\",\n\t\"duration\": 2,\n \"durationMs\": 2000,\n\t\"bpm\": 92,\n\t\"download_formats\": {\n\t\t\"MP3\": {\n\t\t\t\"format_name\": \"MP3\",\n\t\t\t\"file_size_bytes\": 96279\n\t\t}\n\t},\n\t\"categories\": [\n\t\t\"sfx:foley\"\n\t],\n\t\"keywords\": [\n\t\t\"air\",\n\t\t\"sfx\",\n\t\t\"box\"\n\t],\n \"description\": \"Water Bottle Lid Twist Off\",\n \"expiration_date\": null,\n \"content_id\": 3000093,\n \"url_id\": \"water-bottle-lid-twist-off-rtoecafbirk0ebi2sg\",\n \"asset_id\": \"SBA-3000093\",\n \"artists\": [],\n \"topTags\": [\n {\n \"tag_id\": 107,\n \"tag_name\": \"Foley\",\n \"tag_url_id\": \"foley\",\n \"tag_position\": 1,\n \"tag_type\": 4,\n \"tag_value\": \"0.026315789669752\"\n }\n ]\n}"},{"id":"16b50781-1a7e-4cf7-80bf-2b8338aa05c8","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"322bb1e9-020c-4df5-90c9-5286fe8bf7eb","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"a008d0ba-0e87-4bed-bddb-3b413dc8f5c0","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"b401c4b9-c0a6-4751-97c7-5a33c57c73c3"},{"name":"/api/v2/images/stock-item/details/:stock_item_id","id":"76c876e7-cced-434c-b7a9-43454e8c5221","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/stock-item/details/:stock_item_id","description":"

Get details about a specific image stock item

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","details",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"c5c0423e-8a4c-42f1-aeab-21b5197fd07d","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"id\": 100,\n\t\"title\": \"Vector Price Tags\",\n\t\"type\": \"Vector\",\n \"contentClass\": \"image\",\n \"is_new\": false,\n\t\"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/sfx/thumbs/BsTwCwBHBjzwub4i4/water-bottle-lid-twist-off.png\",\n\t\"preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n\t\"small_preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n\t\"download_formats\": {\n\t\t\"JPG\": {\n\t\t\t\"format_name\": \"JPG\",\n\t\t\t\"file_size_bytes\": 1385263,\n\t\t\t\"height\": 2239,\n\t\t\t\"width\": 3000\n\t\t}\n\t},\n\t\"categories\": [\n\t\t\"business\"\n\t],\n\t\"keywords\": [\n\t\t\"art\",\n\t\t\"barcode\",\n\t\t\"sale\"\n\t],\n \"description\": \"Vector Price Tags. Four Elegant Vector Price Tags With Sample Barcodes (red, Blue And Black Tags) Two With Red Bow. Download File: Pdf Vector\",\n \"expiration_date\": null,\n \"content_id\": 3000949,\n \"url_id\": \"vector-price-tags-hgfyeqo-jlv8\",\n \"asset_id\": \"SBI-3000949\",\n \"aspect_ratio\": 1.38748,\n \"is_editorial\": false,\n \"has_talent_released\": false,\n \"has_property_released\": false\n}"},{"id":"12f195ca-06f0-4ec2-8875-44080762fa3d","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"840de70a-a0b4-4d3b-900c-2aa3a5fefe1e","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"d8c46d74-ddb6-43bd-a303-347b714ef605","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"76c876e7-cced-434c-b7a9-43454e8c5221"},{"name":"/api/v2/videos/stock-item/details","id":"4d8e0807-6885-4467-92b6-dbb184b41fb5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.storyblocks.com/api/v2/videos/stock-item/details","description":"

Get details for video stock items in batch

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","details"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"disabled":true,"description":{"content":"

Receive this many stock items in one page of results. Defaults to 10

\n","type":"text/plain"},"key":"results_per_page","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[]}},"response":[{"id":"fde849df-414d-49b8-adcb-0f74f48a7b2f","name":"Successful response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=&results_per_page=","protocol":"https","host":["api","storyblocks","com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"project_id","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"total_results\": 50,\n \"total_pages\": 3,\n \"results\": {\n \"invalid_stock_ids\": [\n \"abc\"\n ],\n \"stock_ids_not_found\": [\n 15,\n 17\n ],\n \"stock_items\": [\n {\n \"id\": 11851,\n \"title\": \"Email Animation Background\",\n \"type\": \"Footage\",\n \"contentClass\": \"video\",\n \"is_new\": false,\n \"thumbnail_url\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/thumbnail/BKaAXTX/email-animation-background_7jotd3b__S04.jpg\",\n \"preview_urls\": {\n \"_180p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_360p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_480p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n \"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n },\n \"download_formats\": {\n \"MP4\": {\n \"_1080p\": {\n \"format_name\": \"HDMP4 - potentially a point of confusion that this is 'format_name' and the key for this object is called the same\",\n \"file_size_bytes\": 40663693,\n \"height\": 1080,\n \"width\": 1920,\n \"bitrate_kbps\": 31736,\n \"frame_rate\": 29.97,\n \"video_codec\": \"h264\",\n \"resolution\": 1080\n }\n }\n },\n \"categories\": [\n \"business\",\n \"motion-backgrounds\"\n ],\n \"keywords\": [\n \"business\",\n \"electronic\",\n \"computer\"\n ],\n \"duration\": 11,\n \"durationMs\": 10944,\n \"orientation\": \"horizontal\",\n \"description\": null,\n \"expiration_date\": null,\n \"content_id\": 71090305,\n \"url_id\": \"closeup-timelapse-83n0xez\",\n \"asset_id\": \"SBV-71090305\",\n \"has_alpha\": null,\n \"contributor\": {\n \"username\": \"Storyblocks Video\"\n },\n \"is_editorial\": false,\n \"has_talent_released\": false,\n \"has_property_released\": false\n }\n ]\n }\n}"},{"id":"8690fa7d-cbda-4204-80c9-0da45c79f477","name":"Invalid authentication","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,161,79,80]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details?APIKEY=&EXPIRES=&HMAC=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details"],"query":[{"key":"APIKEY","value":"","description":"(Required) Your public key should be used for this parameter"},{"key":"EXPIRES","value":"","description":"(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?"},{"key":"HMAC","value":"","description":"(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal."},{"key":"page","value":"","description":"Request a specific page of content in a large set of results. Defaults to 1."},{"key":"results_per_page","value":"","description":"Receive this many stock items in one page of results. Defaults to 10"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"d32aae24-da0f-40b8-989f-4f61a15e23d8","name":"Invalid query parameters provided","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,161,79,80]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"4d8e0807-6885-4467-92b6-dbb184b41fb5"},{"name":"/api/v2/audio/stock-item/details","id":"d6dd1e21-0d0c-4c39-b520-dead83f28e0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.storyblocks.com/api/v2/audio/stock-item/details","description":"

Get details for audio stock items in batch

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","details"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"disabled":true,"description":{"content":"

Receive this many stock items in one page of results. Defaults to 10

\n","type":"text/plain"},"key":"results_per_page","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[]}},"response":[{"id":"5f0a8228-33fe-4052-bc22-f009ca3efef5","name":"Successful response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"total_results\": 50,\n \"total_pages\": 5,\n \"results\": {\n \"invalid_stock_ids\": [],\n \"stock_ids_not_found\": [],\n \"stock_items\": [\n {\n \"id\": 44020,\n \"title\": \"Water Bottle Lid Twist Off\",\n \"type\": \"music\",\n \"contentClass\": \"audio\",\n \"is_new\": false,\n \"preview_url\": \"https://dv7auk4chfeq0.cloudfront.net/audio/sfx/mp3preview/BsTwCw.mp3\",\n \"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/sfx/thumbs/BsTwCw.png\",\n \"waveform_url\": \"https://d1490khl9dq1ow.cloudfront.net/thumbnails/audio/BsTwCw.json\",\n \"duration\": 2,\n \"durationMs\": 2000,\n \"bpm\": 92,\n \"download_formats\": {\n \"MP3\": {\n \"format_name\": \"MP3\",\n \"file_size_bytes\": 96279\n }\n },\n \"categories\": [\n \"sfx:foley\"\n ],\n \"keywords\": [\n \"air\",\n \"sfx\",\n \"box\"\n ],\n \"description\": \"Water Bottle Lid Twist Off\",\n \"expiration_date\": null,\n \"content_id\": 3000093,\n \"url_id\": \"water-bottle-lid-twist-off-rtoecafbirk0ebi2sg\",\n \"asset_id\": \"SBA-3000093\",\n \"artists\": [],\n \"topTags\": [\n {\n \"tag_id\": 107,\n \"tag_name\": \"Foley\",\n \"tag_url_id\": \"foley\",\n \"tag_position\": 1,\n \"tag_type\": 4,\n \"tag_value\": \"0.026315789669752\"\n }\n ]\n }\n ]\n }\n}"},{"id":"81d1e88e-9604-4d73-ae91-bd4dde9d9cb4","name":"Invalid authentication","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/details?APIKEY=&EXPIRES=&HMAC=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","details"],"query":[{"key":"APIKEY","value":"","description":"(Required) Your public key should be used for this parameter"},{"key":"EXPIRES","value":"","description":"(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?"},{"key":"HMAC","value":"","description":"(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal."},{"key":"page","value":"","description":"Request a specific page of content in a large set of results. Defaults to 1."},{"key":"results_per_page","value":"","description":"Receive this many stock items in one page of results. Defaults to 10"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"07d42add-e926-45bd-ab53-7138c375395a","name":"Invalid query parameters provided","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"d6dd1e21-0d0c-4c39-b520-dead83f28e0c"},{"name":"/api/v2/images/stock-item/details","id":"598e3fdf-5fb0-42b4-8f0d-45a9c27f4618","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.storyblocks.com/api/v2/images/stock-item/details","description":"

Get details for image stock items in batch

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","details"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"disabled":true,"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""},{"disabled":true,"description":{"content":"

Receive this many stock items in one page of results. Defaults to 10

\n","type":"text/plain"},"key":"results_per_page","value":""},{"disabled":true,"description":{"content":"

List of content statuses to filter by, specified as a comma separated string. Defaults to \"active,inactive\" if not specified.

\n","type":"text/plain"},"key":"content_statuses","value":""}],"variable":[]}},"response":[{"id":"d047b410-6c82-4a5b-afed-3de0f617e5c0","name":"Successful response","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"total_results\": 50,\n \"total_pages\": 5,\n \"results\": {\n \"invalid_stock_ids\": [],\n \"stock_ids_not_found\": [],\n \"stock_items\": [\n {\n \"id\": 100,\n \"title\": \"Vector Price Tags\",\n \"type\": \"Vector\",\n \"contentClass\": \"image\",\n \"is_new\": false,\n \"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/sfx/thumbs/BsTwCwBHBjzwub4i4/water-bottle-lid-twist-off.png\",\n \"preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n \"small_preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n \"download_formats\": {\n \"JPG\": {\n \"format_name\": \"JPG\",\n \"file_size_bytes\": 1385263,\n \"height\": 2239,\n \"width\": 3000\n }\n },\n \"categories\": [\n \"business\"\n ],\n \"keywords\": [\n \"art\",\n \"barcode\",\n \"sale\"\n ],\n \"description\": \"Vector Price Tags. Four Elegant Vector Price Tags With Sample Barcodes (red, Blue And Black Tags) Two With Red Bow. Download File: Pdf Vector\",\n \"expiration_date\": null,\n \"content_id\": 3000949,\n \"url_id\": \"vector-price-tags-hgfyeqo-jlv8\",\n \"asset_id\": \"SBI-3000949\",\n \"aspect_ratio\": 1.38748,\n \"is_editorial\": false,\n \"has_talent_released\": false,\n \"has_property_released\": false\n }\n ]\n }\n}"},{"id":"2244ebce-162a-4415-a436-73e8a863a246","name":"Invalid authentication","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=&page=&results_per_page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""},{"key":"results_per_page","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"2c5ffb5d-c5d6-466c-b700-4be4eb08983e","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"stockItemIds\": \n [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,\"abc\",19,20,\"def\",\"22ac\",23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/details?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","details"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"598e3fdf-5fb0-42b4-8f0d-45a9c27f4618"}],"id":"854e3341-4d2c-4ae3-b90e-e035969cfd48","description":"

For a specific asset, get detailed information specific to its media type along with its available download options.

\n","_postman_id":"854e3341-4d2c-4ae3-b90e-e035969cfd48"},{"name":"Download","item":[{"name":"/api/v2/videos/stock-item/download/:stock_item_id","id":"430e0ff6-7e8d-4e92-be79-6a7a8a18c9dc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/stock-item/download/:stock_item_id?project_id=&user_id=","description":"

Get full size download links for a specific video stock item

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","download",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"64727daf-6725-4b60-aeab-d23f3f09cc4d","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"MOV\": {\n\t\t\"_1080p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n\t},\n\t\"MP4\": {\n\t\t\"_1080p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n\t}\n}"},{"id":"042e0f71-4b0b-4989-9629-af6e2a66e1ad","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"07008bfd-efb6-41c9-8a63-624782e45fea","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"aa9fb98f-de44-4334-a1bb-af69191a2367","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"430e0ff6-7e8d-4e92-be79-6a7a8a18c9dc"},{"name":"/api/v2/audio/stock-item/download/:stock_item_id","id":"191f9e61-a96c-4bde-8e71-7ba0d662baaf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/stock-item/download/:stock_item_id?project_id=&user_id=","description":"

Get full size download links for a specific audio stock item

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","download",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"b3c3279f-cdba-4ea1-9551-7927c7953efa","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"MP3\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music...\",\n\t\"WAV\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music...\"\n}"},{"id":"5e14c01b-c2c5-462a-b858-938f050ea0ac","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"62561264-5586-4cc2-96c3-cc49adc37919","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"8d0132be-17d7-456b-91bb-2bcda5384d7d","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"191f9e61-a96c-4bde-8e71-7ba0d662baaf"},{"name":"/api/v2/images/stock-item/download/:stock_item_id","id":"0a127140-2572-47f7-9023-7b0d1fd63d3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/stock-item/download/:stock_item_id?project_id=&user_id=","description":"

Get full size download links for a specific image stock item

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","download",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the project within which this request is initiated

\n","type":"text/plain"},"key":"project_id","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"a3fa1108-6f41-4c47-9bad-92bbbce65482","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"EPS\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n\t\"JPG\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n\t\"PDF\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\",\n\t\"PSD\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\"\n}"},{"id":"194116ee-6ea5-495f-8e30-5f0d16cad7f3","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"3064f354-ce68-4597-8256-3d51811929f3","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"32131158-eeab-4f7e-9e6b-6666bf74b132","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/download/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&project_id=&user_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","download",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"project_id","value":""},{"key":"user_id","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"}],"_postman_id":"0a127140-2572-47f7-9023-7b0d1fd63d3c"}],"id":"aacba6f4-358b-4b61-897b-28e4129a7c4a","description":"

For a specific asset, get links to each available high quality format.

\n","_postman_id":"aacba6f4-358b-4b61-897b-28e4129a7c4a"},{"name":"Categories","item":[{"name":"/api/v2/videos/stock-item/categories","id":"c4aecae5-579f-4be8-b093-6b424635bc27","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/stock-item/categories","description":"

Get a list of video categories. Categories are returned as an array of Category objects.

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","categories"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"e316e995-d6a0-4d85-93de-a887463e1e5e","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 10,\n\t\t\"name\": \"Aerial\",\n\t\t\"content_type\": \"footage\"\n\t}\n]"},{"id":"891bab13-3780-4676-918b-bfd010d1ea91","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"95d6015b-8b7e-4d8c-a7b6-a82c1b2e9fe3","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"c4aecae5-579f-4be8-b093-6b424635bc27"},{"name":"/api/v2/audio/stock-item/categories","id":"fec2f320-b587-443f-9a97-d839f311c429","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/stock-item/categories","description":"

Get a list of audio categories

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","categories"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"db44c585-ce48-4f1f-bce1-631a5bb9e5eb","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/categories?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 10,\n\t\t\"name\": \"Aerial\",\n\t\t\"content_type\": \"music\",\n\t\t\"category_group\": \"mood\"\n\t}\n]"},{"id":"0df28c4d-4632-4307-a299-bf0e65309d7e","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"6b9b24bd-175d-45d6-a60d-dd2158e6dd2c","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"fec2f320-b587-443f-9a97-d839f311c429"},{"name":"/api/v2/images/stock-item/categories","id":"740a3c73-f88e-476b-9d48-51f40ddadb83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/stock-item/categories","description":"

Get a list of image categories

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","categories"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"f38a6abf-4334-47bb-96ac-fe0d37dc7598","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/categories?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 6,\n\t\t\"name\": \"People\",\n\t\t\"content_type\": \"illustration\"\n\t}\n]"},{"id":"c7f92483-93e2-4285-8977-3a62591d6130","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"ee91c801-5f10-4c2f-859d-7aaa3f5d6b11","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/categories?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","categories"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"740a3c73-f88e-476b-9d48-51f40ddadb83"}],"id":"95517f46-78c5-4f64-a315-61cccfe94f4f","description":"

Get a list of categories for each media type. Categories can help you or your end-users easily browse through and filter search results.

\n","_postman_id":"95517f46-78c5-4f64-a315-61cccfe94f4f"},{"name":"Collections","item":[{"name":"/api/v2/videos/collections","id":"1debad1c-2135-4163-8a1c-73e662ce3a2b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/collections","description":"

Get a list of video collections

\n","urlObject":{"protocol":"https","path":["api","v2","videos","collections"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"6b0bf3e3-4809-4140-857d-4516b248fc7d","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 51392,\n\t\t\"name\": \"Everyday Heroes\",\n\t\t\"description\": \"\",\n\t\t\"num_items\": 6,\n\t\t\"date_added\": \"2018-11-10 16:33:30\",\n\t\t\"date_updated\": \"2018-11-10 16:41:23\"\n\t}\n]"},{"id":"372701a9-ba1f-4822-9269-3ae0eff385c2","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"fa7be73e-1776-4138-8cd5-b74adc2ab11f","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"1debad1c-2135-4163-8a1c-73e662ce3a2b"},{"name":"/api/v2/videos/collections/:collection_id","id":"f60c7ed5-4c16-4c06-a992-04883c2838ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/collections/:collection_id?page=","description":"

Get the list of stock items in a video collection

\n","urlObject":{"protocol":"https","path":["api","v2","videos","collections",":collection_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of items from the collection. The page size is 100, and the page number defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the collection

\n","type":"text/plain"},"type":"string","value":"","key":"collection_id"}]}},"response":[{"id":"995edd03-0114-456a-a4be-80809f8f0ecb","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"collection_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 1,\n\t\t\"title\": \"HD Las Vegas Bellagio\",\n\t\t\"thumbnail_url\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/thumbnail/hd-las-vegas-mov_S01.jpg\",\n\t\t\"type\": \"footage\",\n \"contentClass\": \"video\",\n \"is_new\": false,\n\t\t\"preview_urls\": {\n\t\t\t\"_180p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/preview/hd-las-vegas...\",\n\t\t\t\"_360p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/preview/hd-las-vegas...\",\n\t\t\t\"_480p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/preview/hd-las-vegas...\",\n\t\t\t\"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/preview/hd-las-vegas...\"\n\t\t},\n \"duration\": 5,\n \"durationMs\": 4879\n\t}\n]"},{"id":"0b6e6fff-39bc-441f-ada2-c4b44a0b8d0a","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"9faa27eb-c6e9-4477-87fa-ce18d395a25a","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"f60c7ed5-4c16-4c06-a992-04883c2838ba"},{"name":"/api/v2/audio/collections","id":"98493935-a86e-426b-8165-c78197373059","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/collections","description":"

Get a list of audio collections

\n","urlObject":{"protocol":"https","path":["api","v2","audio","collections"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"91aa2064-637c-4597-b339-f3784f1070ee","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 51392,\n\t\t\"name\": \"Everyday Heroes\",\n\t\t\"description\": \"\",\n\t\t\"num_items\": 6,\n\t\t\"date_added\": \"2018-11-10 16:33:30\",\n\t\t\"date_updated\": \"2018-11-10 16:41:23\"\n\t}\n]"},{"id":"1e8319a7-f660-445c-8325-a14a1a334464","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"399f985c-86ac-4f1e-82fc-d6993f4ad3b9","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"98493935-a86e-426b-8165-c78197373059"},{"name":"/api/v2/audio/collections/:collection_id","id":"4d2905f5-cafd-461a-881a-e0702bfc7cb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/collections/:collection_id?page=","description":"

Get the list of stock items in an audio collection

\n","urlObject":{"protocol":"https","path":["api","v2","audio","collections",":collection_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of items from the collection. The page size is 100, and the page number defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the collection

\n","type":"text/plain"},"type":"string","value":"","key":"collection_id"}]}},"response":[{"id":"1891c10a-fffb-431e-8890-91cbd99b88b2","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"project_id","value":""}],"variable":[{"key":"collection_id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 10,\n\t\t\"title\": \"Bounce Transition\",\n\t\t\"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/music/thumbs/bounce-transition_GywONeN_.png\",\n\t\t\"type\": \"music\",\n \"contentClass\": \"audio\",\n \"is_new\": false,\n \"preview_url\": \"https://dv7auk4chfeq0.cloudfront.net/audio/sfx/mp3preview/BsTwCw.mp3\",\n \"waveform_url\": \"https://dv7auk4chfeq0.cloudfront.net/audio/sfx/thumbs/BsTwCw.json\",\n\t\t\"duration\": 8,\n \"durationMs\": 8000,\n\t\t\"bpm\": 84\n\t}\n]"},{"id":"2ad23e3c-3ab5-4b58-bd8b-1f52f0f61151","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&collection_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"collection_id","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"afed367f-59ae-497c-abae-a74f95543d9d","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&collection_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"collection_id","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"4d2905f5-cafd-461a-881a-e0702bfc7cb2"},{"name":"/api/v2/images/collections","id":"c20768cb-8441-468d-a0ee-218572e63be4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/collections","description":"

Get a list of image collections

\n","urlObject":{"protocol":"https","path":["api","v2","images","collections"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"454960ae-0134-411a-8fff-dbf7a38bc744","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 51392,\n\t\t\"name\": \"Everyday Heroes\",\n\t\t\"description\": \"\",\n\t\t\"num_items\": 6,\n\t\t\"date_added\": \"2018-11-10 16:33:30\",\n\t\t\"date_updated\": \"2018-11-10 16:41:23\"\n\t}\n]"},{"id":"693952c1-649a-4a45-ad4a-541658fe9bb5","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"de2f5ffc-586d-42a1-b62c-d054aecad560","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"c20768cb-8441-468d-a0ee-218572e63be4"},{"name":"/api/v2/images/collections/:collection_id","id":"5c36db33-6487-4940-8421-9784b23b96e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/collections/:collection_id?page=","description":"

Get the list of stock items in an image collection

\n","urlObject":{"protocol":"https","path":["api","v2","images","collections",":collection_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of items from the collection. The page size is 100, and the page number defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the collection

\n","type":"text/plain"},"type":"string","value":"","key":"collection_id"}]}},"response":[{"id":"efc1980b-ab92-41f5-aeca-c5fcc1aa2120","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"collection_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 10,\n\t\t\"title\": \"Fresh Mushrooms\",\n\t\t\"thumbnail_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/rDtN98Qoishumwih/fresh-mushrooms_zJOa_vHO_SB_PS.jpg\",\n\t\t\"preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...jpg\",\n\t\t\"type\": \"illustration\",\n \"contentClass\": \"image\",\n \"is_new\": false\n\t}\n]"},{"id":"66e26697-62e3-4ed2-a434-3198a07b6e67","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&collection_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"collection_id","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"b0555eeb-d45a-4136-86e3-3c5cfc55b893","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/collections/:collection_id?APIKEY=&EXPIRES=&HMAC=&collection_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","collections",":collection_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"collection_id","value":""}],"variable":[{"key":"collection_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"5c36db33-6487-4940-8421-9784b23b96e4"}],"id":"f889c2aa-59b9-4c2c-a002-4a80ed1a3b7f","description":"

Our content experts hand-curate collections and playlists to make finding content easy for end-users. For each media type, use the two associated endpoints to deliver these collections to end-users. The first endpoint returns a list of available collections. The second endpoint returns the assets within a specific collection.

\n","_postman_id":"f889c2aa-59b9-4c2c-a002-4a80ed1a3b7f"},{"name":"YouTube Audio Claims","item":[{"name":"/api/v2/audio/whitelist/youtube","id":"c773558d-6fd8-42d8-b584-76660b9c914d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"url":"https://api.storyblocks.com/api/v2/audio/whitelist/youtube?user_id=&youtube_channel_id=","description":"

Update your YouTube Channel ID and we should be able to remove most claims automatically in less than 30 minutes with no further action required by you! Need help finding your YouTube channel ID? Please click here.

\n","urlObject":{"protocol":"https","path":["api","v2","audio","whitelist","youtube"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) A unique identifier for the end user initiating this request

\n","type":"text/plain"},"key":"user_id","value":""},{"description":{"content":"

(Required) Channel id to allowlist

\n","type":"text/plain"},"key":"youtube_channel_id","value":""}],"variable":[]}},"response":[{"id":"6116f28c-8999-405d-a985-9c9632d10dfa","name":"Successful response","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/whitelist/youtube?APIKEY=&EXPIRES=&HMAC=&user_id=&youtube_channel_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","whitelist","youtube"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"youtube_channel_id","value":""}]}},"status":"Created","code":201,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"6f6a67fe-b86d-4e61-80c6-d20c8d4466d2","name":"Invalid authentication","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/whitelist/youtube?APIKEY=&EXPIRES=&HMAC=&user_id=&youtube_channel_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","whitelist","youtube"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"youtube_channel_id","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"a9b108d2-3ce7-48cc-a6a0-0a4c05386aed","name":"Invalid query parameters provided","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/whitelist/youtube?APIKEY=&EXPIRES=&HMAC=&user_id=&youtube_channel_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","whitelist","youtube"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":""},{"key":"youtube_channel_id","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"c773558d-6fd8-42d8-b584-76660b9c914d"},{"name":"/api/v2/audio/dispute","id":"b84e727e-6cfe-4593-b834-cc705ba86fac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"url":"https://api.storyblocks.com/api/v2/audio/dispute?disputer_name=&disputed_url=&disputer_email=&claimant_name=&stock_item_id=&is_test=","description":"

If your YouTube channel ID is up to date and your claim was not automatically resolved in less than 30 minutes, we can still help you! By filing a dispute form we are able to remove 95% of outstanding copyright claims in less than 72 hours.

\n","urlObject":{"protocol":"https","path":["api","v2","audio","dispute"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

(Required) The name of the user who is filing the dispute.

\n","type":"text/plain"},"key":"disputer_name","value":""},{"description":{"content":"

(Required) The full url of the disputed video. The url must begin with 'https://www.youtube.com/watch?'.

\n","type":"text/plain"},"key":"disputed_url","value":""},{"description":{"content":"

(Required) The email of the user who is filing the dispute.

\n","type":"text/plain"},"key":"disputer_email","value":""},{"description":{"content":"

(Required) The name of the claimant filing the copyright claim. The most up-to-date-list of valid claimants can be retrived via the /audio/dispute/valid-claimaints endpoint described below. If the name of the claimant you want to provide is not in the list, please email your account manager.

\n

Possible values include AdRev, AdRev for a 3rd party, AdRev for Rights Holder, AdRev Publishing, AdShare, AdShare for a 3rd party, AdShare MG, AdShare TV, APM, Audiam, Audio Machine, AudioSparx, Believe Digital, Bicycle Music co., Big Band, Bongo BD, BraveBison.io, Catch 22, Chicago Music Library, Clanger Digital, Clanger Rights, Clanger Rights (clanger Digital), Colonize Media, Dance all Day, Danmark Music Group, Daredo GmbH digedo, DigiSay, EMPIRE, Frederator, Gene Michael Productions, \"GMA Network, Inc.\", HAAWK, HDMN, HorusMusic, IdiomMusic, IDOL Distribution [Merlin], IndieTracks, InDMusic/Live Nation, INgrooves, Intermède Music, IODA Music, John Hobart, Just Entertainment (justente), Kontor New Media, Label Worx, Live Nation Video Network, Merlin, Muserk, Naxos of America, NeilCross, ONErpm, Position Music, Renderyard, Repost by Soundcloud (repost network yly), ROBA music Publishing, Rock Ridge Music, Royal Supreme, Rumblefish, ScaleLab, Shemaroo, SmashTrax, SME (Sony Music Entertainment), Songtradr, Soundreef LTD, Soundscape, Source Audio, Spinnin’ Records, STEM, Tango Multimedia Productions, The Orchard, Thoughtful Media, Triple Scoop Music, TRT Muzik, TuneCore, Tunesat, UMG, Warner Chappell (WMG).

\n","type":"text/plain"},"key":"claimant_name","value":""},{"description":{"content":"

(Required) The id of the audio stock item which is the subject of the copyright claim.

\n","type":"text/plain"},"key":"stock_item_id","value":""},{"description":{"content":"

(Optional) Set this value to 1 when testing this endpoint to avoid opening a dispute.

\n","type":"text/plain"},"key":"is_test","value":""}],"variable":[]}},"response":[{"id":"565695dd-000e-49ea-a20f-4838f3e52fdc","name":"Successful response","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute?APIKEY=&EXPIRES=&HMAC=&disputer_name=&disputed_url=&disputer_email=&claimant_name=&stock_item_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"disputer_name","value":""},{"key":"disputed_url","value":""},{"key":"disputer_email","value":""},{"key":"claimant_name","value":""},{"key":"stock_item_id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"07cf9e81-6b3e-41b0-b976-a766e44f525e","name":"Invalid authentication","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute?APIKEY=&EXPIRES=&HMAC=&disputer_name=&disputed_url=&disputer_email=&claimant_name=&stock_item_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"disputer_name","value":""},{"key":"disputed_url","value":""},{"key":"disputer_email","value":""},{"key":"claimant_name","value":""},{"key":"stock_item_id","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"2de4932f-14b8-4efa-864c-94e168cbb128","name":"Invalid query parameters provided","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute?APIKEY=&EXPIRES=&HMAC=&disputer_name=&disputed_url=&disputer_email=&claimant_name=&stock_item_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"disputer_name","value":""},{"key":"disputed_url","value":""},{"key":"disputer_email","value":""},{"key":"claimant_name","value":""},{"key":"stock_item_id","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"b84e727e-6cfe-4593-b834-cc705ba86fac"},{"name":"/api/v2/audio/dispute/valid-claimants","id":"a6f6c27a-427b-4e0c-8736-8e7f88029d9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/dispute/valid-claimants","description":"

Get the list of valid claimants

\n","urlObject":{"protocol":"https","path":["api","v2","audio","dispute","valid-claimants"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""}],"variable":[]}},"response":[{"id":"c396b6a7-c43b-4c94-9472-69de33e7e516","name":"Successful response","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute/valid-claimants?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute","valid-claimants"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n \"Storyblocks\"\n]"},{"id":"20b9b5da-e61a-4c4f-b59b-60412e41fc02","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute/valid-claimants?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute","valid-claimants"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"315e4365-c5f7-4c02-8047-bfd45fb4f92e","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/dispute/valid-claimants?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","dispute","valid-claimants"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"a6f6c27a-427b-4e0c-8736-8e7f88029d9e"}],"id":"d042ef47-c474-40d8-bf9b-e5566f0d3e68","description":"

Our audio content is 100% royalty-free and can be used safely in YouTube videos. It is still possible for our content to be mistakenly flagged as wrongful use of copyrighted content. We provide 2 endpoints to solve this problem.

\n
    \n
  1. The Whitelist endpoint prevents channels from receiving claims. This is great to incorporate in onboarding to prevent claims in the first place.
    2. \n
  2. The Dispute endpoint allows end-users to dispute a claim manually.
    3. \n
  3. The Valid Claimants endpoint allows returns a list of claimants whose disputes can be automatically resolved via the Dispute endpoint.
    4. \n
\n","_postman_id":"d042ef47-c474-40d8-bf9b-e5566f0d3e68"},{"name":"Expiring Content","item":[{"name":"/api/v2/videos/stock-item/expiring-content","id":"2e073115-efe2-4ff7-82b1-16cbc1adcf86","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/stock-item/expiring-content?page=","description":"

This endpoint returns all video stock items that will be expiring within the next 12 months. Once expired, this content is no longer available for download. This endpoint returns stock items in batches of 1000. If the response you receive indicates more items exist, the page parameter can be used to fetch the next set of 1000.

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","expiring-content"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[]}},"response":[{"id":"6e959b80-8aef-4842-be43-a6a94983cca6","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"},{"key":"page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1001,\n\t\"results_per_page\": 1,\n \"total_pages\": 2,\n\t\"expiring_items\": [\n\t\t{\n\t\t\t\"id\": 148396,\n\t\t\t\"expiration_date\": \"2020-09-01T00:00:00.000\"\n\t\t}\n\t]\n}"},{"id":"097f4f9a-2c15-4438-9006-1b94c5988d1f","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"d78786e2-54f2-40c7-88b8-6c4254e6ffc6","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"}],"_postman_id":"2e073115-efe2-4ff7-82b1-16cbc1adcf86"},{"name":"/api/v2/audio/stock-item/expiring-content","id":"e26d1898-40e2-4d55-b40e-e352159393a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/stock-item/expiring-content?page=","description":"

This endpoint returns all audio stock items that will be expiring within the next 12 months. Once expired, this content is no longer available for download. This endpoint returns stock items in batches of 1000. If the response you receive indicates more items exist, the page parameter can be used to fetch the next set of 1000.

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","expiring-content"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[]}},"response":[{"id":"8b682a23-bbdd-4e91-8a3a-f47017d21465","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"},{"key":"page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1001,\n\t\"results_per_page\": 1,\n \"total_pages\": 2,\n\t\"expiring_items\": [\n\t\t{\n\t\t\t\"id\": 148396,\n\t\t\t\"expiration_date\": \"2020-09-01T00:00:00.000\"\n\t\t}\n\t]\n}"},{"id":"99aad575-4fa1-453f-909e-0a1fbbe7192d","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"be79c9a2-ead8-4730-afb0-f024f9ce5f04","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"e26d1898-40e2-4d55-b40e-e352159393a1"},{"name":"/api/v2/images/stock-item/expiring-content","id":"b498af4d-7bca-476b-a27d-e981a1a77077","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/stock-item/expiring-content?page=","description":"

This endpoint returns all image stock items that will be expiring within the next 12 months. Once expired, this content is no longer available for download. This endpoint returns stock items in batches of 1000. If the response you receive indicates more items exist, the page parameter can be used to fetch the next set of 1000.

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","expiring-content"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

Request a specific page of content in a large set of results. Defaults to 1.

\n","type":"text/plain"},"key":"page","value":""}],"variable":[]}},"response":[{"id":"d5d564b6-34ad-410f-97ae-79ac53ce3b43","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"},{"key":"page","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"total_results\": 1001,\n\t\"results_per_page\": 1,\n \"total_pages\": 2,\n\t\"expiring_items\": [\n\t\t{\n\t\t\t\"id\": 148396,\n\t\t\t\"expiration_date\": \"2020-09-01T00:00:00.000\"\n\t\t}\n\t]\n}"},{"id":"38cbf92b-329d-41ad-90d4-16eab6308463","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"c86ac205-7bd6-4b17-a71a-409abfa6c34d","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/expiring-content?APIKEY=&EXPIRES=&HMAC=&page=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","expiring-content"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"page","value":""}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"b498af4d-7bca-476b-a27d-e981a1a77077"}],"id":"1f03ca15-b5ad-4905-b992-062fe59d2abc","description":"

There are instances where content is removed by our library (e.g. contributing artist decides to remove it). As a courtesy to our partners, we allow that content to be downloaded for 12 months following the removal date. This allows users who already have the removed content in a project to retain access to download quality assets until the project is exported.

\n","_postman_id":"1f03ca15-b5ad-4905-b992-062fe59d2abc"},{"name":"Similar Search","item":[{"name":"/api/v2/videos/stock-item/similar/:stock_item_id","id":"b29d52d2-c230-4167-8fb2-a9d307f746e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/videos/stock-item/similar/:stock_item_id?limit=&extended=","description":"

Get a list of videos that are similar to the provided stock item

\n","urlObject":{"protocol":"https","path":["api","v2","videos","stock-item","similar",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

The maximum number of items you want returned. Defaults to 8 and has a max value of 500

\n","type":"text/plain"},"key":"limit","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, categories, description, isEditorial, isStereo, hasAudio, hasAlpha, maxResolution, aspectRatio, and durationMs.

\n","type":"text/plain"},"key":"extended","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"a694499a-dc00-47d8-b14c-be5b215a84bc","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 11851,\n\t\t\"title\": \"Slow Motion Falling Money\",\n\t\t\"type\": \"footage\",\n \"contentClass\": \"video\",\n \"is_new\": false,\n\t\t\"thumbnail_url\": \"https://d2v9y0dukr6mq2.cloudfront.net/video/thumbnail/slow-motion-falling-money_-jjatxweb__S0000.jpg\",\n\t\t\"preview_urls\": {\n\t\t\t\"_180p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\"_360p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\"_480p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\",\n\t\t\t\"_720p\": \"https://d2v9y0dukr6mq2.cloudfront.net/video...\"\n\t\t},\n\t\t\"duration\": 20,\n \"durationMs\": 20153\n\t}\n]"},{"id":"00ad3a3b-3338-4247-903d-0f300479dd43","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"1df969ca-9884-4279-bfb5-ca822a11fde2","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"7c594a39-8983-4a67-9ccb-747b80d76deb","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/videos/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","videos","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"}],"_postman_id":"b29d52d2-c230-4167-8fb2-a9d307f746e9"},{"name":"/api/v2/audio/stock-item/similar/:stock_item_id","id":"44a1b6bc-0634-47fc-8f87-cf3ba0cc2216","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/audio/stock-item/similar/:stock_item_id?limit=&extended=","description":"

Get audio content that is similar to the provided stock item

\n","urlObject":{"protocol":"https","path":["api","v2","audio","stock-item","similar",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

The maximum number of items you want returned. Defaults to 8 and has a max value of 500

\n","type":"text/plain"},"key":"limit","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, bpm, moods, genres, instruments, soundEffects, and durationMs.

\n","type":"text/plain"},"key":"extended","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"527531ee-5c53-46d9-b725-fcc9f847d429","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 148396,\n\t\t\"title\": \"Inspiring Soft Background\",\n\t\t\"type\": \"music\",\n \"contentClass\": \"audio\",\n \"is_new\": false,\n\t\t\"thumbnail_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music/thumbs/BsTwCwBHBjzwub4i4/sw-1117-inspiring-soft-background-47.png\",\n \"waveform_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music/thumbs/BsTwCwBHBjzwub4i4/sw-1117-inspiring-soft-background-47.json\",\n\t\t\"preview_url\": \"https://d1490khl9dq1ow.cloudfront.net/audio/music...\",\n\t\t\"duration\": 140,\n \"durationMs\": 140000,\n\t\t\"bpm\": 114\n\t}\n]"},{"id":"0aacb940-fd03-40fb-bc90-2069d1768420","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"738253f2-f346-415a-993d-8fe7641b55a7","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"},{"id":"9e7657cb-ae1f-40da-a44d-0c43e34fc11d","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/audio/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","audio","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"}],"_postman_id":"44a1b6bc-0634-47fc-8f87-cf3ba0cc2216"},{"name":"/api/v2/images/stock-item/similar/:stock_item_id","id":"609e9101-5d66-494d-81ba-d95099e9ba91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.storyblocks.com/api/v2/images/stock-item/similar/:stock_item_id?limit=&extended=","description":"

Get a list of images that are similar to the provided stock item

\n","urlObject":{"protocol":"https","path":["api","v2","images","stock-item","similar",":stock_item_id"],"host":["api.storyblocks.com"],"query":[{"disabled":true,"description":{"content":"

(Required) Your public key should be used for this parameter

\n","type":"text/plain"},"key":"APIKEY","value":""},{"disabled":true,"description":{"content":"

(Required) An expiration time in seconds since the Unix epoch (January 1,1970). Need help?

\n","type":"text/plain"},"key":"EXPIRES","value":""},{"disabled":true,"description":{"content":"

(Required) Your authentication code generated using the SHA-256 hmac algorithm with your private key and expires timestamp as the key and the requested resource as the data. HMAC should be provided in hexadecimal.

\n","type":"text/plain"},"key":"HMAC","value":""},{"description":{"content":"

The maximum number of items you want returned. Defaults to 8 and has a max value of 500

\n","type":"text/plain"},"key":"limit","value":""},{"description":{"content":"

Get additional attributes for each stock item in your search results. Multiple can be provided as a comma separated list. Possible values include download_formats, keywords, isSensitiveContent, categories, description, isEditorial, aspectRatio, and colors.

\n","type":"text/plain"},"key":"extended","value":""}],"variable":[{"description":{"content":"

(Required) Unique identifier for the stock item

\n","type":"text/plain"},"type":"string","value":"","key":"stock_item_id"}]}},"response":[{"id":"5c1251ee-b9c3-48e5-bedf-8ff6f331850b","name":"Successful response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=&user_id=&project_id=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""},{"key":"user_id","value":"","type":"text"},{"key":"project_id","value":"","type":"text"}],"variable":[{"key":"stock_item_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n\t{\n\t\t\"id\": 800953,\n\t\t\"title\": \"Deep space background with nebulae\",\n\t\t\"type\": \"photo\",\n \"contentClass\": \"image\",\n \"is_new\": false,\n\t\t\"thumbnail_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/thumbnail/rDtN98Qoishumwih/deep-space-background-with-nebulae_r7NpVyflR_thumb.jpg\",\n\t\t\"preview_url\": \"https://d1yn1kh78jj1rr.cloudfront.net/image/preview/...\"\n\t}\n]"},{"id":"05033912-d2fb-43eb-87e7-018026ee8cc1","name":"Invalid query parameters provided","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the missing or incorrect query parameter\"\n}"},{"id":"19bb8be5-5f33-403d-be2a-e2fdaec8e793","name":"Not found exception","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details about which entity is not found\"\n}"},{"id":"b9f96736-62ce-4314-9416-dc6df185a9a5","name":"Invalid authentication","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.storyblocks.com/api/v2/images/stock-item/similar/:stock_item_id?APIKEY=&EXPIRES=&HMAC=","protocol":"https","host":["api.storyblocks.com"],"path":["api","v2","images","stock-item","similar",":stock_item_id"],"query":[{"key":"APIKEY","value":""},{"key":"EXPIRES","value":""},{"key":"HMAC","value":""}],"variable":[{"key":"stock_item_id"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"errors\": \"This message will provide details of the failed authentication\"\n}"}],"_postman_id":"609e9101-5d66-494d-81ba-d95099e9ba91"}],"id":"114d9cf3-c06a-444b-9254-46948b7f6f72","description":"

Have you found a stock item that's almost a perfect fit? Find more assets that have been used for similar purposes.

\n","_postman_id":"114d9cf3-c06a-444b-9254-46948b7f6f72"},{"name":"Authentication Examples","item":[],"id":"5738b305-5445-4606-94cf-8c2ed43b9611","description":"

Javascript

\n
const crypto = require('crypto');\n// Provided by Storyblocks\nconst publicKey = '{your public key}';\nconst privateKey = '{your private key}';\n// url info\nconst baseUrl = 'https://api.storyblocks.com';\nconst resource = '/api/v2/videos/search';\nconst urlWithoutQueryParams = baseUrl + resource;\n// HMAC generation\nconst expires = Math.floor(Date.now() / 1000) + 100;\nconst hmacBuilder = crypto.createHmac('sha256', privateKey + expires);\nhmacBuilder.update(resource);\nconst hmac = hmacBuilder.digest('hex');\n\n

PHP

\n
  // Provided by Storyblocks\n  $publicKey = \"{your public key}\";\n  $privateKey = \"{your private key}\";\n  // url info\n  $baseUrl = \"https://api.storyblocks.com\";\n  $resource = \"/api/v2/videos/search\";\n  // HMAC generation\n  $expires = time() + 100; // Note, this returns current Unix timestamp in seconds\n  $hmac = hash_hmac(\"sha256\", $resource, $privateKey . $expires);\n?>\n\n

Python

\n
# required modules\nimport time\nimport hmac\nimport hashlib\n# Provided by Storyblocks\npublicKey = \"{your_public_key}\"\nprivateKey = \"{your_private_key}\"\n# url info\nbaseUrl = \"https://api.storyblocks.com\"\nresource = \"/api/v2/videos/search\"\n# HMAC generation\nexpires = str(int(time.time()))\nhmacBuilder = hmac.new(bytearray(privateKey + expires, 'utf-8'), resource.encode('utf-8'), hashlib.sha256)\nhmacHex = hmacBuilder.hexdigest()\n\n

Bash

\n
# Provided by Storyblocks\npublicKey=\"{your public key}\"\nprivateKey=\"{your private key}\"\n# url info\nbaseUrl=\"https://api.storyblocks.com\"\nresource=\"/api/v2/videos/search\"\n# HMAC generation\nexpires=$(date +%s)\nhmac=$(printf %s \"$resource\" | openssl dgst -sha256 -hmac \"$privateKey$expires\")\nhmac=${hmac/(stdin)\\= /''}\n\n

Ruby

\n
require 'openssl'\n# Provided by Storyblocks\npublicKey = '{your public key}'\nprivateKey = '{your private key}'\n# url info\nresource = '/api/v2/videos/search'\nvideoBlocksUrl = 'https://api.storyblocks.com' + resource\n# HMAC generation\nexpires = Time.now.to_i.floor.to_s\nhmac = OpenSSL::HMAC.new(privateKey + expires, OpenSSL::Digest.new('sha256'))\nhmac.update(resource)\nhmacString = hmac.hexdigest\n\n
","_postman_id":"5738b305-5445-4606-94cf-8c2ed43b9611"}],"event":[{"listen":"prerequest","script":{"id":"e8db5ad1-7d51-4104-aaab-b2e4206d7dfb","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"1cc37a65-c9bf-4e4e-a919-3c4dd080563b","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"/","type":"string"},{"key":"sb-host","value":"api.storyblocks.com","type":"string"}]}