# YouTube

API for receiving data about YouTube influencers

## Search Influencers

 - [POST /youtube/search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_search.md): Get a list of influencers that match your filters.
			A successful request costs 0.01 credits per search result, with a typical request totaling 0.15 credits for up to 15 results per page
			Filtering and adding match data:Expand to see additional information
			When filtering by one or more fields, it is advisable to include these same fields in the sorting process. This ensures that you can retrieve the match information associated with each result.
			By adding the filtering fields to the sorting criteria, you gain access to detailed match info for every result obtained.
			Example: If you want to filter by age you would also sort the results by age:
			
			{
				  "sort": { "direction": "desc", "field": "audience_age", "sortedValue": "18-24", "value": "18-24" },
				  "page": 0,
				  "filter": { "audience": { "age": [{"id": "18-24", "weight": 0.3}] } }
			}
			
			You will retrieve match info that will provide details on how well each result matches the filtering criteria. The match info should include two fields: 
			 -code: represents the filtering field that corresponds to the result 
			 -percentage: quantifies the degree of similarity or relevance 
			Audience filters support weights:Expand to see additional informationWeights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.
			Using multiple filters simultaneously results in a logical AND, while applying multiple objects into an array (works with location and age) are applied as a logical OR
			Example: If you want at least 30% of the audience to be at the age of 18-24, you can use the weight property of 0.3. We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter.
			Expand the filter object below to see all available options.
			

## Get Influencer report

 - [GET /youtube/profile/{userId}/report](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_report.md): Influencer contact details are not enabled by default. Contact us to unlock this data for free. 				Every successful request costs 1 credit.

## List Languages

 - [GET /youtube/languages](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_languages.md): Search the list of languages for Influencers.

## List Locations

 - [GET /youtube/locations](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_locations.md): Search the list of locations for Influencers.

## Audience overlap reports

 - [POST /youtube/reports/audience/overlap](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_influencersaudienceoverlap.md): Check audience (followers) overlap for several influencers.
		A successful request costs 1 credit.

## List Users

 - [GET /youtube/users](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_users.md): Search the list of influencers.

## List Topics

 - [GET /youtube/topics](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_topics.md): Search for topics

## List Hashtags

 - [GET /youtube/hashtags](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_hashtags.md): Search for hashtags

## Get Performance Data

 - [GET /youtube/performance-data](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_performancedata.md): Returns the performance data of a YouTube channel for the last 6, 12 and 30 videos & shorts.  				The data is computed on demand, so if it is not available from the first request, a second call should be performed after ~1 minute. 				Every successful request costs 0.25 credits. If the response code is  or there is an error on our side you will not be charged.

## Get Influencer Collaborations (deprecated)

 - [GET /youtube/collaborations/influencer](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_brandtimelineinfluencer.md): Get Brand collaborations for Influencer. This will provide posts for any platform.
			A successful request costs 1 credit, for up to 30 results per page
			
	We're currently rebuilding the Collaborations functionality based on user feedback. An improved version is already in development and will soon replace the current implementation. If you're considering using the collaboration endpoints, please contact us for more information.