Deep Social

FREE
By deepsocial
Updated 9 months ago
Advertising
-/10
Popularity Score
-
Latency
-
Success Rate

Deep Social API Documentation

Get geo, age, sex, ethnicity, audience languages, popular posts of 346,956,505 Instagram account. Get 10 free reports http://deep.social/register

View API Details
POSTSampling
POSTSearch
POSTSave users (only for Data Export plan)
POSTShow
Dictionaries
GETGEO dictionary
GETInterests dictionary
GETLanguages dictionary
GETBrands dictionary
POSTSearch

Search influencers using filters. To request access contact sales [email protected]

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
api_tokenSTRING
REQUIREDTo buy API Token register on http://deep.social/ and check our prices here http://deep.social/prices
Optional Parameters
filter[age][left_number]NUMBER
OPTIONALFilter influencers that older than specified number of years.
filter[age][right_number]NUMBER
OPTIONALFilter influencers that younger than specified number of years.
filter[audience_age][0][code]STRING
OPTIONALMulti-filter (OR) to filter influencers by audience age. Possible age ranges are: "13-17", "18-24", "25-34", "35-44", "45-64", "65-". Use with "filter[audience_age][0][weight]" - precision, can be from 0 to 1, default value is 0.25. You can specify several age ranges to filter influencers. For example: -d 'filter[audience_age][0][code]=13-17' \ -d 'filter[audience_age][1][code]=18-24' \ - this query will return influencers that have ANY of this age ranges
filter[audience_age][0][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_age][0][code]' filter, can be from 0 to 1, default value is 0.25. If you use multi-filter than be sure to match indexes of paired filters. For example 'filter[audience_age][0][weight]' have index 0, 'filter[audience_age][453][weight]' have index 453
filter[audience_brand][0][id]NUMBER
OPTIONALMulti-filter (OR) to filter influencers by audience brands. To get Brand ID use 'Brands dictionary' endpoint. Use with "filter[audience_brand][0][weight]" - precision, can be from 0 to 1, default value is 0.05 You can specify several Brand IDs to filter influencers. For example: -d 'filter[audience_brand][0][id]=65' \ -d 'filter[audience_brand][0][id]=66' \ - this query will return influencers that have ANY of this audience brands.
filter[audience_brand][0][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_brand][0][id]' filter, can be from 0 to 1, default value is 0.05. If you use multi-filter than be sure to match indexes of paired filters. For example 'filter[audience_brand][0][weight]' have index 0, 'filter[audience_brand][453][weight]' have index 453.
filter[audience_brand_category][0][id]NUMBER
OPTIONALMulti-filter (AND) to filter influencers by audience interests. To get Interest ID use 'Interests dictionary' endpoint. Use with "filter[audience_brand_category][0][weight]" - precision, can be from 0 to 1, default value is 0.1 You can specify several Interest IDs to filter influencers. For example: -d 'filter[audience_brand_category][0][id]=2' \ -d 'filter[audience_brand_category][1][id]=20' \ - this query will return influencers that have ALL of this audience interests.
filter[audience_brand_category][0][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_brand_category][0][id]' filter, can be from 0 to 1, default value is 0.1. If you use multi-filter than be sure to match indexes of paired filters. For example 'filter[audience_brand_category][0][weight]' have index 0, 'filter[audience_brand_category][453][weight]' have index 453.
filter[audience_gender][code]STRING
OPTIONALFilter influencers by audience gender (possible values MALE or FEMALE). Use with "filter[audience_gender][weight]" - precision, can be from 0 to 1, default value is 0.5
filter[audience_gender][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_gender][code]' filter, can be from 0 to 1, default value is 0.5
filter[audience_geo][0][id]NUMBER
OPTIONALMulti-filter (OR) to filter influencers by audience GEO. To get GEO ID of specific region use 'GEO dictionary' endpoint. Use with "filter[audience_geo][0][weight]" - precision, can be from 0 to 1, default value is 0.05. You can specify several GEO IDs to filter influencers. For example: -d 'filter[audience_geo][1][id]=102269' \ -d 'filter[audience_geo][1][weight]=0.1' \ -d 'filter[audience_geo][0][id]=65606' \ -d 'filter[audience_geo][0][weight]=0.1' \ - this query will return influencers that have audience in ANY of this regions
filter[audience_geo][0][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_geo][0][id]' filter, can be from 0 to 1, default value is 0.05. If you use multi-filter than be sure to match indexes of paired filters. For example 'filter[audience_geo][0][weight]' have index 0, 'filter[audience_geo][453][weight]' have index 453
filter[audience_lang][code]STRING
OPTIONALFilter influencers by audeence language (to get language code use 'Languages dictionary' endpoint). Use with "filter[audience_lang][weight]" - precision, can be from 0 to 1, default value is 0.2
filter[audience_lang][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_lang][code]' filter, can be from 0 to 1, default value is 0.2
filter[audience_race][code]STRING
OPTIONALFilter influencers by audience skin tone (possible values: Black, Asian or White). Use with "filter[audience_race][weight]" - precision, can be from 0 to 1, default value is 0.3
filter[audience_race][weight]NUMBER
OPTIONALSets precision for the 'filter[audience_race][code]' filter, can be from 0 to 1, default value is 0.3
filter[brand][0]NUMBER
OPTIONALMulti-filter (OR) to filter influencers by brands. To get Brand ID use 'Brands dictionary' endpoint. You can specify several Brand IDs to filter influencers. For example: -d 'filter[brand][0]=65' \ -d 'filter[brand][1]=66' \ - this query will return influencers that have ANY of this Brands.
filter[brand_category][0]NUMBER
OPTIONALMulti-filter (AND) to filter influencers by interests. To get Interest ID use 'Interests dictionary' endpoint. You can specify several Interest IDs to filter influencers. For example: -d 'filter[brand_category][0]=2' \ -d 'filter[brand_category][1]=20' \ - this query will return influencers that have ALL of this interests.
filter[engagements][left_number]NUMBER
OPTIONALFilter influencers that have likes of comments greater than specified number
filter[engagements][right_number]NUMBER
OPTIONALFilter influencers that have likes of comments less than specified number
filter[followers][left_number]NUMBER
OPTIONALFilter influencers that have followers greater than specified number
filter[followers][right_number]NUMBER
OPTIONALFilter influencers that have followers less than specified number
filter[gender][code]STRING
OPTIONALFilter influencers by gender (possible values MALE or FEMALE).
filter[geo][0][id]NUMBER
OPTIONALMulti-filter (OR) to filter influencers in specific GEO region. To get GEO ID of specific region use 'GEO dictionary' endpoint. You can specify several GEO IDs to filter influencers. For example: -d 'filter[geo][1][id]=102269' \ -d 'filter[geo][0][id]=65606' \ - this query will return influencers that have ANY of this regions.
filter[lang][code]STRING
OPTIONALFilter influencers by their language (to get language code use 'Languages dictionary' endpoint).
sort[direction]STRING
OPTIONALSets sorting, by default it is desc. You can specify custom sorting, possible values: 1, -1, asc, desc.
sort[field]STRING
OPTIONALSort influencers by filter type. Possible values: "followers", "engagements", "lang", "gender", "race", "geo", "audience_lang", "audience_gender", "audience_age", "audience_race", "audience_geo", "audience_brand_category", "audience_brand", "audience_gender_per_age"
filter[race][code]STRING
OPTIONALFilter influencers by skin tone (possible values: Black, Asian or White).
filter[has_email]STRING
OPTIONALAdd this filter with any value to hide users without contact info. To see contact info in response you need to have Data Export plan.
filter[known]STRING
OPTIONALAdd this filter with value 'unknown' to hide saved users. To save users use 'save-known' endpoint. Available only with Data Export plan.
paging[skip]NUMBER
OPTIONAL
paging[limit]NUMBER
OPTIONAL
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication