{"items":[{"type":"link","label":"Overview","link":"/products/discovery_api/openapi_doc/discovery","routeSlug":"/products/discovery_api/openapi_doc/discovery","content":{"contentType":"overview","meta":{"name":"Overview"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"discovery.json","url":"/_bundle/products/discovery_api/openapi_doc/discovery.json?download"},{"kind":"download","label":"discovery.yaml","url":"/_bundle/products/discovery_api/openapi_doc/discovery.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://www.modash.io","url":"https://www.modash.io"},{"kind":"email","title":"API Support","email":"hello@modash.io","label":"hello@modash.io","withCopyButton":true,"copyContent":"hello@modash.io"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.modash.io/legal/terms-of-service"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.modash.io/v1"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Overview","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Discovery API provides powerful products for different use cases. Let us provide a brief overview:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search allows you to build comprehensive search experience to find creators. Use filters, lookalikes and our dictionaries and lists to create stunning user interfaces."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reports provide in depth analytics that include audience demographics, performance metrics, sponsored posts and much more."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Our collaborations products enable you to create overviews of past brand partnerships between creators and brands."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"There is more: Search by Email allows you to lookup which creator accounts are associated with an emails and audience overlap identifies the uniqueness of an audience with ease."},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery"}],"sectionId":"/products/discovery_api/openapi_doc/discovery"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/testing-the-api"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Testing the API"},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/testing-the-api/search"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can test out the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Instagram/paths/~1instagram~1search/post"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instagram Search API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for free by leaving the filter object empty. Your request body should look similar to this."},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"> POST https://api.modash.io/v1/instagram/search\n{\n\t\"sort\": {\n\t\t\"field\": \"followers\",\n\t\t\"direction\": \"desc\"\n\t},\n\t\"filter\": {\n\t}\n}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"> POST https://api.modash.io/v1/instagram/search\n{\n\t\"sort\": {\n\t\t\"field\": \"followers\",\n\t\t\"direction\": \"desc\"\n\t},\n\t\"filter\": {\n\t}\n}\n"},"children":[]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/search"}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/search"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/testing-the-api/reports"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reports"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To test out the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Instagram/paths/~1instagram~1profile~1%7BuserId%7D~1report/get"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instagram Reports API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for free you can set the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"userId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instagram"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your request should look like this."},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"> GET https://api.modash.io/v1/instagram/profile/instagram/report\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"> GET https://api.modash.io/v1/instagram/profile/instagram/report\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We recommend always using the report route and caching the result if necessary. Everything that is included in the overview is also in a report."},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/reports"}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/reports"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/pagination"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When using the Search API, each response has in total 15 influencers. If you wish to query more influencers for the same query you need to increment the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter in the request body."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/pagination"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/dictionaries"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dictionaries"},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/dictionaries"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/dictionaries/interests-locations-and-brands"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Interests, Locations and brands"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When finding influencers by interests, locations or brands you need to search by their respective ID. To list all interests, locations or brands you need to call the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.modash.io/v1/instagram/interests"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.modash.io/v1/instagram/locations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.modash.io/v1/instagram/brands"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" route."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can specify the list of interests, locations or brands returned by using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter and limit the amount of list items returned by using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"20"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". You can query all list items by setting the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/interests-locations-and-brands"}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/interests-locations-and-brands"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/dictionaries/languages"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Languages"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Similar to interests, locations and brands, you first need to find the correct language code to search by. This can be done by calling the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.modash.io/v1/instagram/languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" route."},"children":[]}]}]}]}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/languages"}],"sectionId":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/languages"}]}]}},{"type":"group","label":"Testing the API","link":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api","items":[{"type":"link","label":"Search","link":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/search","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/search","content":null},{"type":"link","label":"Reports","link":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/reports","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/testing-the-api/reports","content":null}],"content":null},{"type":"link","label":"Pagination","link":"/products/discovery_api/openapi_doc/discovery/section/pagination","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/pagination","content":null},{"type":"group","label":"Dictionaries","link":"/products/discovery_api/openapi_doc/discovery/section/dictionaries","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/dictionaries","items":[{"type":"link","label":"Interests, Locations and brands","link":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/interests-locations-and-brands","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/interests-locations-and-brands","content":null},{"type":"link","label":"Languages","link":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/languages","routeSlug":"/products/discovery_api/openapi_doc/discovery/section/dictionaries/languages","content":null}],"content":null},{"label":"Search by Email","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/other/multiplatformcontroller_emailsearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/other/multiplatformcontroller_emailsearch","metadata":{"seo":{"title":"Search by Email","description":"For each email provided, identify one or more social media accounts on Instagram, YouTube, or TikTok that have listed this email in their bio or as their contact information.A successful request costs 0.02 credits per matched email. To execute this request, the account must have a minimum of 0.02 credits multiplied by the number of provided emails, otherwise a not_enough_credits error will be returned.We do not store the email addresses that you send us."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"MultiPlatformController_emailSearch","name":"Search by Email","isWebhook":false,"pointer":"/paths/~1email-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search by Email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For each email provided, identify one or more social media accounts on Instagram, YouTube, or TikTok that have listed this email in their bio or as their contact information."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0.02 credits per matched email"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". To execute this request, the account must have a minimum of 0.02 credits multiplied by the number of provided emails, otherwise a "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not_enough_credits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" error will be returned."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We do not store the email addresses that you send us."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailsSearchBody"}},"schemaId":"components/schemas/EmailsSearchBody","pointer":"/paths/~1email-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/email-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/EmailsSearchBody"}},"responseCodes":["200"],"pointer":"/email-search","href":"other/multiplatformcontroller_emailsearch","openApiOperationId":"MultiPlatformController_emailSearch","summary":"Search by Email"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/EmailsSearchBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailsSearchBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmailsSearchResponse"}},"schemaId":"components/schemas/EmailsSearchResponse"}],"pointer":"/paths/~1email-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EmailsSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmailsSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/other/multiplatformcontroller_emailsearch"}],"panels":[]}]},"httpPath":"/email-search"},{"type":"group","label":"YouTube","link":"/products/discovery_api/openapi_doc/discovery/youtube","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube","items":[{"label":"Search Influencers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_search","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_search","metadata":{"seo":{"title":"Search Influencers","description":"Get a list of influencers that match your filters.\n\t\t\tA successful request costs 0.01 credits per search result, with a typical request totaling 0.15 credits for up to 15 results per page"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_search","name":"Search Influencers","isWebhook":false,"pointer":"/paths/~1youtube~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search Influencers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"p","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Get a list of influencers that match your filters.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.01 credits per search result"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", with a typical request totaling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.15 credits"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" for up to "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"15 results per page"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"u","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Audience filters support weights:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"details","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"summary","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand to see additional information"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Weights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Using multiple filters simultaneously results in a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"AND"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", while applying multiple objects into an array (works with location and age) are applied as a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OR"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Example:"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" If you want at least "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"30%"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" of the audience to be at the age of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"18-24"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", you can use the weight property of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.3"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":". We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand the filter object below to see all available options."},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/YouTubeSearchBody"}},"schemaId":"components/schemas/YouTubeSearchBody","pointer":"/paths/~1youtube~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/youtube/search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/YouTubeSearchBody"}},"responseCodes":["200"],"pointer":"/youtube/search","href":"youtube/youtubecontroller_search","openApiOperationId":"YouTubeController_search","summary":"Search Influencers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/YouTubeSearchBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/YouTubeSearchBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YoutubeSearchResponse"}},"schemaId":"components/schemas/YoutubeSearchResponse"}],"pointer":"/paths/~1youtube~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YoutubeSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YoutubeSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_search"}],"panels":[]}]},"httpPath":"/youtube/search"},{"label":"Get Influencer report","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_report","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_report","metadata":{"seo":{"title":"Get Influencer report","description":"Every successful request costs 1 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_report","name":"Get Influencer report","isWebhook":false,"pointer":"/paths/~1youtube~1profile~1{userId}~1report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Influencer report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"userId","in":"path","schemaId":"schema_69","description":"User's YouTube handle or user ID from YouTube","required":true}],"pointer":"/paths/~1youtube~1profile~1{userId}~1report/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"calculationMethod","in":"query","schemaId":"schema_70","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc."}],"pointer":"/paths/~1youtube~1profile~1{userId}~1report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/profile/{userId}/report","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"userId","in":"path","required":true,"example":"@MrBeast","schemaId":"schema_69"}],"query":[{"name":"calculationMethod","in":"query","required":false,"schemaId":"schema_70"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/profile/{userId}/report","href":"youtube/youtubecontroller_report","openApiOperationId":"YouTubeController_report","summary":"Get Influencer report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YouTubeReport"}},"schemaId":"components/schemas/YouTubeReport"}],"pointer":"/paths/~1youtube~1profile~1{userId}~1report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YouTubeReport","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YouTubeReport"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_report"}],"panels":[]}]},"httpPath":"/youtube/profile/{userId}/report"},{"label":"List Languages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_languages","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_languages","metadata":{"seo":{"title":"List Languages","description":"Search the list of languages for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_languages","name":"List Languages","isWebhook":false,"pointer":"/paths/~1youtube~1languages/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Languages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of languages for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1youtube~1languages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/languages","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/languages","href":"youtube/youtubecontroller_languages","openApiOperationId":"YouTubeController_languages","summary":"List Languages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}},"schemaId":"components/schemas/ListLanguagesResponse"}],"pointer":"/paths/~1youtube~1languages/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLanguagesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_languages"}],"panels":[]}]},"httpPath":"/youtube/languages"},{"label":"List Locations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_locations","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_locations","metadata":{"seo":{"title":"List Locations","description":"Search the list of locations for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_locations","name":"List Locations","isWebhook":false,"pointer":"/paths/~1youtube~1locations/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Locations","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of locations for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1youtube~1locations/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/locations","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/locations","href":"youtube/youtubecontroller_locations","openApiOperationId":"YouTubeController_locations","summary":"List Locations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}},"schemaId":"components/schemas/ListLocationsResponse"}],"pointer":"/paths/~1youtube~1locations/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLocationsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_locations"}],"panels":[]}]},"httpPath":"/youtube/locations"},{"label":"Audience overlap reports","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_influencersaudienceoverlap","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_influencersaudienceoverlap","metadata":{"seo":{"title":"Audience overlap reports","description":"Check audience (followers) overlap for several influencers.A successful request costs 1 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_influencersAudienceOverlap","name":"Audience overlap reports","isWebhook":false,"pointer":"/paths/~1youtube~1reports~1audience~1overlap/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Audience overlap reports","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check audience (followers) overlap for several influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"schemaId":"components/schemas/AudiencerOverlapBody","pointer":"/paths/~1youtube~1reports~1audience~1overlap/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/youtube/reports/audience/overlap","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"responseCodes":["200"],"pointer":"/youtube/reports/audience/overlap","href":"youtube/youtubecontroller_influencersaudienceoverlap","openApiOperationId":"YouTubeController_influencersAudienceOverlap","summary":"Audience overlap reports"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/AudiencerOverlapBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AudienceOverlapResponse"}},"schemaId":"components/schemas/AudienceOverlapResponse"}],"pointer":"/paths/~1youtube~1reports~1audience~1overlap/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AudienceOverlapResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AudienceOverlapResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_influencersaudienceoverlap"}],"panels":[]}]},"httpPath":"/youtube/reports/audience/overlap"},{"label":"List Users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_users","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_users","metadata":{"seo":{"title":"List Users","description":"Search the list of influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_users","name":"List Users","isWebhook":false,"pointer":"/paths/~1youtube~1users/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_73","description":"String to search by"}],"pointer":"/paths/~1youtube~1users/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/users","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"mrbeast","schemaId":"schema_73"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/users","href":"youtube/youtubecontroller_users","openApiOperationId":"YouTubeController_users","summary":"List Users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YoutubeListUsersResponse"}},"schemaId":"components/schemas/YoutubeListUsersResponse"}],"pointer":"/paths/~1youtube~1users/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YoutubeListUsersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YoutubeListUsersResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_users"}],"panels":[]}]},"httpPath":"/youtube/users"},{"label":"List Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_topics","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_topics","metadata":{"seo":{"title":"List Topics","description":"Search for topics.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_topics","name":"List Topics","isWebhook":false,"pointer":"/paths/~1youtube~1topics/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for topics."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1youtube~1topics/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/topics","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/topics","href":"youtube/youtubecontroller_topics","openApiOperationId":"YouTubeController_topics","summary":"List Topics"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1youtube~1topics/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_topics"}],"panels":[]}]},"httpPath":"/youtube/topics"},{"label":"List Hashtags","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_hashtags","routeSlug":"/products/discovery_api/openapi_doc/discovery/youtube/youtubecontroller_hashtags","metadata":{"seo":{"title":"List Hashtags","description":"Search for hashtags.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"YouTubeController_hashtags","name":"List Hashtags","isWebhook":false,"pointer":"/paths/~1youtube~1hashtags/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Hashtags","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for hashtags."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1youtube~1hashtags/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/youtube/hashtags","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/youtube/hashtags","href":"youtube/youtubecontroller_hashtags","openApiOperationId":"YouTubeController_hashtags","summary":"List Hashtags"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1youtube~1hashtags/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/youtube/youtubecontroller_hashtags"}],"panels":[]}]},"httpPath":"/youtube/hashtags"}],"content":{"contentType":"group","meta":{"name":"YouTube"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"YouTube","showPageActions":true},{"nodeType":"markdoc","content":"API for receiving data about YouTube influencers"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/youtube/search","summary":"Search Influencers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/youtube/youtubecontroller_search","deprecated":false},{"title":"/youtube/profile/{userId}/report","summary":"Get Influencer report","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_report","deprecated":false},{"title":"/youtube/languages","summary":"List Languages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_languages","deprecated":false},{"title":"/youtube/locations","summary":"List Locations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_locations","deprecated":false},{"title":"/youtube/reports/audience/overlap","summary":"Audience overlap reports","prefix":{"name":"post","color":"post"},"badges":[],"link":"/youtube/youtubecontroller_influencersaudienceoverlap","deprecated":false},{"title":"/youtube/users","summary":"List Users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_users","deprecated":false},{"title":"/youtube/topics","summary":"List Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_topics","deprecated":false},{"title":"/youtube/hashtags","summary":"List Hashtags","prefix":{"name":"get","color":"get"},"badges":[],"link":"/youtube/youtubecontroller_hashtags","deprecated":false}]}]}]}]}},{"type":"group","label":"TikTok","link":"/products/discovery_api/openapi_doc/discovery/tiktok","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok","items":[{"label":"Search Influencers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_search","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_search","metadata":{"seo":{"title":"Search Influencers","description":"Get a list of influencers that match your filters.\n\t\t\tA successful request costs 0.01 credits per search result, with a typical request totaling 0.15 credits for up to 15 results per page"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_search","name":"Search Influencers","isWebhook":false,"pointer":"/paths/~1tiktok~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search Influencers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"p","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Get a list of influencers that match your filters.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.01 credits per search result"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", with a typical request totaling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.15 credits"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" for up to "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"15 results per page"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"u","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Audience filters support weights:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"details","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"summary","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand to see additional information"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Weights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Using multiple filters simultaneously results in a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"AND"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", while applying multiple objects into an array (works with location and age) are applied as a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OR"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Example:"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" If you want at least "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"30%"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" of the audience to be at the age of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"18-24"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", you can use the weight property of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.3"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":". We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand the filter object below to see all available options."},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TikTokSearchBody"}},"schemaId":"components/schemas/TikTokSearchBody","pointer":"/paths/~1tiktok~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/tiktok/search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TikTokSearchBody"}},"responseCodes":["200"],"pointer":"/tiktok/search","href":"tiktok/tiktokcontroller_search","openApiOperationId":"TikTokController_search","summary":"Search Influencers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/TikTokSearchBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TikTokSearchBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}},"schemaId":"components/schemas/SearchResponse"}],"pointer":"/paths/~1tiktok~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_search"}],"panels":[]}]},"httpPath":"/tiktok/search"},{"label":"Get Influencer report","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_report","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_report","metadata":{"seo":{"title":"Get Influencer report","description":"Every successful request costs 1 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_report","name":"Get Influencer report","isWebhook":false,"pointer":"/paths/~1tiktok~1profile~1{userId}~1report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Influencer report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"userId","in":"path","schemaId":"schema_75","description":"User's TikTok handle or user ID from TikTok","required":true}],"pointer":"/paths/~1tiktok~1profile~1{userId}~1report/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"calculationMethod","in":"query","schemaId":"schema_70","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc."}],"pointer":"/paths/~1tiktok~1profile~1{userId}~1report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/profile/{userId}/report","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"userId","in":"path","required":true,"example":"@claudinelanglois","schemaId":"schema_75"}],"query":[{"name":"calculationMethod","in":"query","required":false,"schemaId":"schema_70"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/profile/{userId}/report","href":"tiktok/tiktokcontroller_report","openApiOperationId":"TikTokController_report","summary":"Get Influencer report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TikTokReport"}},"schemaId":"components/schemas/TikTokReport"}],"pointer":"/paths/~1tiktok~1profile~1{userId}~1report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TikTokReport","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TikTokReport"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_report"}],"panels":[]}]},"httpPath":"/tiktok/profile/{userId}/report"},{"label":"List Languages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_languages","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_languages","metadata":{"seo":{"title":"List Languages","description":"Search the list of languages for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_languages","name":"List Languages","isWebhook":false,"pointer":"/paths/~1tiktok~1languages/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Languages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of languages for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1tiktok~1languages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/languages","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/languages","href":"tiktok/tiktokcontroller_languages","openApiOperationId":"TikTokController_languages","summary":"List Languages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}},"schemaId":"components/schemas/ListLanguagesResponse"}],"pointer":"/paths/~1tiktok~1languages/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLanguagesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_languages"}],"panels":[]}]},"httpPath":"/tiktok/languages"},{"label":"List Locations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_locations","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_locations","metadata":{"seo":{"title":"List Locations","description":"Search the list of locations for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_locations","name":"List Locations","isWebhook":false,"pointer":"/paths/~1tiktok~1locations/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Locations","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of locations for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1tiktok~1locations/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/locations","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/locations","href":"tiktok/tiktokcontroller_locations","openApiOperationId":"TikTokController_locations","summary":"List Locations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}},"schemaId":"components/schemas/ListLocationsResponse"}],"pointer":"/paths/~1tiktok~1locations/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLocationsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_locations"}],"panels":[]}]},"httpPath":"/tiktok/locations"},{"label":"List Users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_users","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_users","metadata":{"seo":{"title":"List Users","description":"Search the list of influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_users","name":"List Users","isWebhook":false,"pointer":"/paths/~1tiktok~1users/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_73","description":"String to search by"}],"pointer":"/paths/~1tiktok~1users/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/users","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"mrbeast","schemaId":"schema_73"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/users","href":"tiktok/tiktokcontroller_users","openApiOperationId":"TikTokController_users","summary":"List Users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListUsersResponse"}},"schemaId":"components/schemas/ListUsersResponse"}],"pointer":"/paths/~1tiktok~1users/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListUsersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListUsersResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_users"}],"panels":[]}]},"httpPath":"/tiktok/users"},{"label":"List Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_topics","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_topics","metadata":{"seo":{"title":"List Topics","description":"Search for topics.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_topics","name":"List Topics","isWebhook":false,"pointer":"/paths/~1tiktok~1topics/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for topics."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1tiktok~1topics/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/topics","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/topics","href":"tiktok/tiktokcontroller_topics","openApiOperationId":"TikTokController_topics","summary":"List Topics"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1tiktok~1topics/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_topics"}],"panels":[]}]},"httpPath":"/tiktok/topics"},{"label":"List Hashtags","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_hashtags","routeSlug":"/products/discovery_api/openapi_doc/discovery/tiktok/tiktokcontroller_hashtags","metadata":{"seo":{"title":"List Hashtags","description":"Search for hashtags.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TikTokController_hashtags","name":"List Hashtags","isWebhook":false,"pointer":"/paths/~1tiktok~1hashtags/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Hashtags","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for hashtags."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1tiktok~1hashtags/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tiktok/hashtags","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tiktok/hashtags","href":"tiktok/tiktokcontroller_hashtags","openApiOperationId":"TikTokController_hashtags","summary":"List Hashtags"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1tiktok~1hashtags/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/tiktok/tiktokcontroller_hashtags"}],"panels":[]}]},"httpPath":"/tiktok/hashtags"}],"content":{"contentType":"group","meta":{"name":"TikTok"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"TikTok","showPageActions":true},{"nodeType":"markdoc","content":"API for receiving data about TikTok influencers"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/tiktok/search","summary":"Search Influencers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/tiktok/tiktokcontroller_search","deprecated":false},{"title":"/tiktok/profile/{userId}/report","summary":"Get Influencer report","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_report","deprecated":false},{"title":"/tiktok/languages","summary":"List Languages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_languages","deprecated":false},{"title":"/tiktok/locations","summary":"List Locations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_locations","deprecated":false},{"title":"/tiktok/users","summary":"List Users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_users","deprecated":false},{"title":"/tiktok/topics","summary":"List Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_topics","deprecated":false},{"title":"/tiktok/hashtags","summary":"List Hashtags","prefix":{"name":"get","color":"get"},"badges":[],"link":"/tiktok/tiktokcontroller_hashtags","deprecated":false}]}]}]}]}},{"type":"group","label":"Instagram","link":"/products/discovery_api/openapi_doc/discovery/instagram","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram","items":[{"label":"Search Influencers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_search","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_search","metadata":{"seo":{"title":"Search Influencers","description":"Get a list of influencers that match your filters.\n\t\t\tA successful request costs 0.01 credits per search result, with a typical request totaling 0.15 credits for up to 15 results per page"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_search","name":"Search Influencers","isWebhook":false,"pointer":"/paths/~1instagram~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search Influencers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"p","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Get a list of influencers that match your filters.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.01 credits per search result"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", with a typical request totaling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.15 credits"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" for up to "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"15 results per page"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"u","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Audience filters support weights:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"details","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"summary","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand to see additional information"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Weights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.\n\t\t\t"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","attributes":{"content":"Using multiple filters simultaneously results in a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"AND"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", while applying multiple objects into an array (works with interests, location and age) are applied as a logical "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OR"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Example:"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" If you want at least "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"30%"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":" of the audience to be at the age of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"18-24"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":", you can use the weight property of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"0.3"},"children":[]}]},{"$$mdtype":"Node","type":"text","attributes":{"content":". We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Expand the filter object below to see all available options."},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InstagramSearchBody"}},"schemaId":"components/schemas/InstagramSearchBody","pointer":"/paths/~1instagram~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/instagram/search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/InstagramSearchBody"}},"responseCodes":["200"],"pointer":"/instagram/search","href":"instagram/instagramcontroller_search","openApiOperationId":"InstagramController_search","summary":"Search Influencers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/InstagramSearchBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/InstagramSearchBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}},"schemaId":"components/schemas/SearchResponse"}],"pointer":"/paths/~1instagram~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_search"}],"panels":[]}]},"httpPath":"/instagram/search"},{"label":"Get Influencer Report","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_report","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_report","metadata":{"seo":{"title":"Get Influencer Report","description":"Every successful request costs 1 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_report","name":"Get Influencer Report","isWebhook":false,"pointer":"/paths/~1instagram~1profile~1{userId}~1report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Influencer Report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"userId","in":"path","schemaId":"schema_73","description":"User's Instagram handle or user ID from Instagram","required":true}],"pointer":"/paths/~1instagram~1profile~1{userId}~1report/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"calculationMethod","in":"query","schemaId":"schema_70","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc."}],"pointer":"/paths/~1instagram~1profile~1{userId}~1report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/profile/{userId}/report","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"userId","in":"path","required":true,"example":"mrbeast","schemaId":"schema_73"}],"query":[{"name":"calculationMethod","in":"query","required":false,"schemaId":"schema_70"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/profile/{userId}/report","href":"instagram/instagramcontroller_report","openApiOperationId":"InstagramController_report","summary":"Get Influencer Report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InstagramReport"}},"schemaId":"components/schemas/InstagramReport"}],"pointer":"/paths/~1instagram~1profile~1{userId}~1report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/InstagramReport","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InstagramReport"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_report"}],"panels":[]}]},"httpPath":"/instagram/profile/{userId}/report"},{"label":"Audience overlap reports","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_influencersaudienceoverlap","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_influencersaudienceoverlap","metadata":{"seo":{"title":"Audience overlap reports","description":"Check audience (followers) overlap for several influencers.A successful request costs 1 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_influencersAudienceOverlap","name":"Audience overlap reports","isWebhook":false,"pointer":"/paths/~1instagram~1reports~1audience~1overlap/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Audience overlap reports","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check audience (followers) overlap for several influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"schemaId":"components/schemas/AudiencerOverlapBody","pointer":"/paths/~1instagram~1reports~1audience~1overlap/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/instagram/reports/audience/overlap","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"responseCodes":["200"],"pointer":"/instagram/reports/audience/overlap","href":"instagram/instagramcontroller_influencersaudienceoverlap","openApiOperationId":"InstagramController_influencersAudienceOverlap","summary":"Audience overlap reports"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/AudiencerOverlapBody","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AudiencerOverlapBody"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AudienceOverlapResponse"}},"schemaId":"components/schemas/AudienceOverlapResponse"}],"pointer":"/paths/~1instagram~1reports~1audience~1overlap/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AudienceOverlapResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AudienceOverlapResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_influencersaudienceoverlap"}],"panels":[]}]},"httpPath":"/instagram/reports/audience/overlap"},{"label":"List Partnerships (brands)","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_brands","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_brands","metadata":{"seo":{"title":"List Partnerships (brands)","description":"Search the list of Partnerships (brands) that have worked with the influencer.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_brands","name":"List Partnerships (brands)","isWebhook":false,"pointer":"/paths/~1instagram~1brands/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Partnerships (brands)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of Partnerships (brands) that have worked with the influencer."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1instagram~1brands/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/brands","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/brands","href":"instagram/instagramcontroller_brands","openApiOperationId":"InstagramController_brands","summary":"List Partnerships (brands)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBrandsResponse"}},"schemaId":"components/schemas/ListBrandsResponse"}],"pointer":"/paths/~1instagram~1brands/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListBrandsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBrandsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_brands"}],"panels":[]}]},"httpPath":"/instagram/brands"},{"label":"List Interests","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_interests","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_interests","metadata":{"seo":{"title":"List Interests","description":"Search the list of interests.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_interests","name":"List Interests","isWebhook":false,"pointer":"/paths/~1instagram~1interests/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Interests","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of interests."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1instagram~1interests/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/interests","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/interests","href":"instagram/instagramcontroller_interests","openApiOperationId":"InstagramController_interests","summary":"List Interests"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListInterestsResponse"}},"schemaId":"components/schemas/ListInterestsResponse"}],"pointer":"/paths/~1instagram~1interests/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListInterestsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListInterestsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_interests"}],"panels":[]}]},"httpPath":"/instagram/interests"},{"label":"List Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_topics","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_topics","metadata":{"seo":{"title":"List Topics","description":"Search for topics.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_topics","name":"List Topics","isWebhook":false,"pointer":"/paths/~1instagram~1topics/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for topics."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1instagram~1topics/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/topics","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/topics","href":"instagram/instagramcontroller_topics","openApiOperationId":"InstagramController_topics","summary":"List Topics"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1instagram~1topics/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_topics"}],"panels":[]}]},"httpPath":"/instagram/topics"},{"label":"List Languages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_languages","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_languages","metadata":{"seo":{"title":"List Languages","description":"Search the list of languages for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_languages","name":"List Languages","isWebhook":false,"pointer":"/paths/~1instagram~1languages/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Languages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of languages for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1instagram~1languages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/languages","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/languages","href":"instagram/instagramcontroller_languages","openApiOperationId":"InstagramController_languages","summary":"List Languages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}},"schemaId":"components/schemas/ListLanguagesResponse"}],"pointer":"/paths/~1instagram~1languages/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLanguagesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLanguagesResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_languages"}],"panels":[]}]},"httpPath":"/instagram/languages"},{"label":"List Locations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_locations","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_locations","metadata":{"seo":{"title":"List Locations","description":"Search the list of locations for Influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_locations","name":"List Locations","isWebhook":false,"pointer":"/paths/~1instagram~1locations/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Locations","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of locations for Influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_72","description":"String to search by"}],"pointer":"/paths/~1instagram~1locations/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/locations","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"ita","schemaId":"schema_72"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/locations","href":"instagram/instagramcontroller_locations","openApiOperationId":"InstagramController_locations","summary":"List Locations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}},"schemaId":"components/schemas/ListLocationsResponse"}],"pointer":"/paths/~1instagram~1locations/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListLocationsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListLocationsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_locations"}],"panels":[]}]},"httpPath":"/instagram/locations"},{"label":"List Users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_users","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_users","metadata":{"seo":{"title":"List Users","description":"Search the list of influencers.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_users","name":"List Users","isWebhook":false,"pointer":"/paths/~1instagram~1users/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search the list of influencers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_73","description":"String to search by"}],"pointer":"/paths/~1instagram~1users/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/users","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":false,"example":"mrbeast","schemaId":"schema_73"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/users","href":"instagram/instagramcontroller_users","openApiOperationId":"InstagramController_users","summary":"List Users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListUsersResponse"}},"schemaId":"components/schemas/ListUsersResponse"}],"pointer":"/paths/~1instagram~1users/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListUsersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListUsersResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_users"}],"panels":[]}]},"httpPath":"/instagram/users"},{"label":"List Hashtags","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_hashtags","routeSlug":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_hashtags","metadata":{"seo":{"title":"List Hashtags","description":"Search for hashtags.A successful request costs 0 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"InstagramController_hashtags","name":"List Hashtags","isWebhook":false,"pointer":"/paths/~1instagram~1hashtags/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Hashtags","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for hashtags."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful request costs 0 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_71","description":"Max items to get"},{"name":"query","in":"query","schemaId":"schema_74","description":"String to search by","required":true}],"pointer":"/paths/~1instagram~1hashtags/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/instagram/hashtags","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"example":1000,"schemaId":"schema_71"},{"name":"query","in":"query","required":true,"example":"travel","schemaId":"schema_74"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/instagram/hashtags","href":"instagram/instagramcontroller_hashtags","openApiOperationId":"InstagramController_hashtags","summary":"List Hashtags"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}},"schemaId":"components/schemas/HashtagsResponse"}],"pointer":"/paths/~1instagram~1hashtags/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/HashtagsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HashtagsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instagram/instagramcontroller_hashtags"}],"panels":[]}]},"httpPath":"/instagram/hashtags"}],"content":{"contentType":"group","meta":{"name":"Instagram"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram","showPageActions":true},{"nodeType":"markdoc","content":"API for receiving data about Instagram influencers"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/instagram/search","summary":"Search Influencers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/instagram/instagramcontroller_search","deprecated":false},{"title":"/instagram/profile/{userId}/report","summary":"Get Influencer Report","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_report","deprecated":false},{"title":"/instagram/reports/audience/overlap","summary":"Audience overlap reports","prefix":{"name":"post","color":"post"},"badges":[],"link":"/instagram/instagramcontroller_influencersaudienceoverlap","deprecated":false},{"title":"/instagram/brands","summary":"List Partnerships (brands)","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_brands","deprecated":false},{"title":"/instagram/interests","summary":"List Interests","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_interests","deprecated":false},{"title":"/instagram/topics","summary":"List Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_topics","deprecated":false},{"title":"/instagram/languages","summary":"List Languages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_languages","deprecated":false},{"title":"/instagram/locations","summary":"List Locations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_locations","deprecated":false},{"title":"/instagram/users","summary":"List Users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_users","deprecated":false},{"title":"/instagram/hashtags","summary":"List Hashtags","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instagram/instagramcontroller_hashtags","deprecated":false}]}]}]}]}},{"type":"group","label":"AI Search","link":"/products/discovery_api/openapi_doc/discovery/ai-search","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search","items":[{"label":"Instagram Text-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igtextsearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igtextsearch","metadata":{"seo":{"title":"Instagram Text-based AI Search","description":"Find influencers whose posts semantically (what appears in photos and videos) match the text query. Put language, locations, and similar criteria in filters. query does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_igTextSearch","name":"Instagram Text-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1instagram~1text-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram Text-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Find influencers whose posts semantically (what appears in photos and videos) match the text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Put language, locations, and similar criteria in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"schemaId":"components/schemas/IGTextAiSearchRequest","pointer":"/paths/~1ai~1instagram~1text-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/instagram/text-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/instagram/text-search","href":"ai-search/aisearchcontroller_igtextsearch","openApiOperationId":"AISearchController_igTextSearch","summary":"Instagram Text-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/IGTextAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}},"schemaId":"components/schemas/AiSearchResponse"}],"pointer":"/paths/~1ai~1instagram~1text-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_igtextsearch"}],"panels":[]}]},"httpPath":"/ai/instagram/text-search"},{"label":"Instagram Image-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igimagesearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igimagesearch","metadata":{"seo":{"title":"Instagram Image-based AI Search","description":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_igImageSearch","name":"Instagram Image-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1instagram~1image-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram Image-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"schemaId":"components/schemas/IGImageAiSearchRequest","pointer":"/paths/~1ai~1instagram~1image-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/instagram/image-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/instagram/image-search","href":"ai-search/aisearchcontroller_igimagesearch","openApiOperationId":"AISearchController_igImageSearch","summary":"Instagram Image-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/IGImageAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}},"schemaId":"components/schemas/AiSearchResponse"}],"pointer":"/paths/~1ai~1instagram~1image-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_igimagesearch"}],"panels":[]}]},"httpPath":"/ai/instagram/image-search"},{"label":"TikTok Text-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_tttextsearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_tttextsearch","metadata":{"seo":{"title":"TikTok Text-based AI Search","description":"Find influencers whose posts semantically (what appears in photos and videos) match the text query. Put language, locations, and similar criteria in filters. query does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ttTextSearch","name":"TikTok Text-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1tiktok~1text-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"TikTok Text-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Find influencers whose posts semantically (what appears in photos and videos) match the text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Put language, locations, and similar criteria in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"schemaId":"components/schemas/TextAiSearchRequest","pointer":"/paths/~1ai~1tiktok~1text-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/tiktok/text-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/tiktok/text-search","href":"ai-search/aisearchcontroller_tttextsearch","openApiOperationId":"AISearchController_ttTextSearch","summary":"TikTok Text-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/TextAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTAiSearchResponse"}},"schemaId":"components/schemas/TTAiSearchResponse"}],"pointer":"/paths/~1ai~1tiktok~1text-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TTAiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTAiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_tttextsearch"}],"panels":[]}]},"httpPath":"/ai/tiktok/text-search"},{"label":"TikTok Image-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttimagesearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttimagesearch","metadata":{"seo":{"title":"TikTok Image-based AI Search","description":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ttImageSearch","name":"TikTok Image-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1tiktok~1image-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"TikTok Image-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"schemaId":"components/schemas/ImageAiSearchRequest","pointer":"/paths/~1ai~1tiktok~1image-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/tiktok/image-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/tiktok/image-search","href":"ai-search/aisearchcontroller_ttimagesearch","openApiOperationId":"AISearchController_ttImageSearch","summary":"TikTok Image-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/ImageAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTAiSearchResponse"}},"schemaId":"components/schemas/TTAiSearchResponse"}],"pointer":"/paths/~1ai~1tiktok~1image-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TTAiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTAiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_ttimagesearch"}],"panels":[]}]},"httpPath":"/ai/tiktok/image-search"},{"label":"YouTube Text-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_yttextsearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_yttextsearch","metadata":{"seo":{"title":"YouTube Text-based AI Search","description":"Find influencers whose posts semantically (what appears in photos and videos) match the text query. Put language, locations, and similar criteria in filters. query does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ytTextSearch","name":"YouTube Text-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1youtube~1text-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"YouTube Text-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Find influencers whose posts semantically (what appears in photos and videos) match the text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Put language, locations, and similar criteria in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"schemaId":"components/schemas/TextAiSearchRequest","pointer":"/paths/~1ai~1youtube~1text-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/youtube/text-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/youtube/text-search","href":"ai-search/aisearchcontroller_yttextsearch","openApiOperationId":"AISearchController_ytTextSearch","summary":"YouTube Text-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/TextAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TextAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTAiSearchResponse"}},"schemaId":"components/schemas/YTAiSearchResponse"}],"pointer":"/paths/~1ai~1youtube~1text-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YTAiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTAiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_yttextsearch"}],"panels":[]}]},"httpPath":"/ai/youtube/text-search"},{"label":"YouTube Image-based AI Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytimagesearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytimagesearch","metadata":{"seo":{"title":"YouTube Image-based AI Search","description":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. The image is matched against video and short thumbnails. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ytImageSearch","name":"YouTube Image-based AI Search","isWebhook":false,"pointer":"/paths/~1ai~1youtube~1image-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"YouTube Image-based AI Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. The image is matched against video and short thumbnails. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"schemaId":"components/schemas/ImageAiSearchRequest","pointer":"/paths/~1ai~1youtube~1image-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/youtube/image-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/youtube/image-search","href":"ai-search/aisearchcontroller_ytimagesearch","openApiOperationId":"AISearchController_ytImageSearch","summary":"YouTube Image-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/ImageAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ImageAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTAiSearchResponse"}},"schemaId":"components/schemas/YTAiSearchResponse"}],"pointer":"/paths/~1ai~1youtube~1image-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YTAiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTAiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_ytimagesearch"}],"panels":[]}]},"httpPath":"/ai/youtube/image-search"},{"label":"Instagram Creator Lookalikes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_iglookalikes","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_iglookalikes","metadata":{"seo":{"title":"Instagram Creator Lookalikes","description":"Find creators similar to one or more Instagram creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_igLookalikes","name":"Instagram Creator Lookalikes","isWebhook":false,"pointer":"/paths/~1ai~1instagram~1lookalikes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram Creator Lookalikes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Find creators similar to one or more Instagram creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_76"}},"schemaId":"schema_76","pointer":"/paths/~1ai~1instagram~1lookalikes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/instagram/lookalikes","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_76"}},"responseCodes":["200"],"pointer":"/ai/instagram/lookalikes","href":"ai-search/aisearchcontroller_iglookalikes","openApiOperationId":"AISearchController_igLookalikes","summary":"Instagram Creator Lookalikes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"schema_76","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_76"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IGLookalikeResponse"}},"schemaId":"components/schemas/IGLookalikeResponse"}],"pointer":"/paths/~1ai~1instagram~1lookalikes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/IGLookalikeResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IGLookalikeResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_iglookalikes"}],"panels":[]}]},"httpPath":"/ai/instagram/lookalikes"},{"label":"TikTok Creator Lookalikes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttlookalikes","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttlookalikes","metadata":{"seo":{"title":"TikTok Creator Lookalikes","description":"Find creators similar to one or more TikTok creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ttLookalikes","name":"TikTok Creator Lookalikes","isWebhook":false,"pointer":"/paths/~1ai~1tiktok~1lookalikes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"TikTok Creator Lookalikes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Find creators similar to one or more TikTok creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_77"}},"schemaId":"schema_77","pointer":"/paths/~1ai~1tiktok~1lookalikes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/tiktok/lookalikes","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_77"}},"responseCodes":["200"],"pointer":"/ai/tiktok/lookalikes","href":"ai-search/aisearchcontroller_ttlookalikes","openApiOperationId":"AISearchController_ttLookalikes","summary":"TikTok Creator Lookalikes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"schema_77","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_77"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTLookalikeResponse"}},"schemaId":"components/schemas/TTLookalikeResponse"}],"pointer":"/paths/~1ai~1tiktok~1lookalikes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TTLookalikeResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TTLookalikeResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_ttlookalikes"}],"panels":[]}]},"httpPath":"/ai/tiktok/lookalikes"},{"label":"YouTube Creator Lookalikes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytlookalikes","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytlookalikes","metadata":{"seo":{"title":"YouTube Creator Lookalikes","description":"Find creators similar to one or more YouTube creators on any platform. Provide 1 to 5 source creator channel IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_ytLookalikes","name":"YouTube Creator Lookalikes","isWebhook":false,"pointer":"/paths/~1ai~1youtube~1lookalikes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"YouTube Creator Lookalikes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Find creators similar to one or more YouTube creators on any platform. Provide 1 to 5 source creator channel IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_78"}},"schemaId":"schema_78","pointer":"/paths/~1ai~1youtube~1lookalikes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/youtube/lookalikes","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_78"}},"responseCodes":["200"],"pointer":"/ai/youtube/lookalikes","href":"ai-search/aisearchcontroller_ytlookalikes","openApiOperationId":"AISearchController_ytLookalikes","summary":"YouTube Creator Lookalikes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"schema_78","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_78"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTLookalikeResponse"}},"schemaId":"components/schemas/YTLookalikeResponse"}],"pointer":"/paths/~1ai~1youtube~1lookalikes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/YTLookalikeResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/YTLookalikeResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_ytlookalikes"}],"panels":[]}]},"httpPath":"/ai/youtube/lookalikes"},{"label":"Brands Dictionary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary","metadata":{"seo":{"title":"Brands Dictionary","description":"Get a list of brands that match the search query. Results from this endpoint are only valid for AI Search filters. Just like other dictionary endpoints, this endpoints costs nothing and there are no strict rate limits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_brandsDictionary","name":"Brands Dictionary","isWebhook":false,"pointer":"/paths/~1ai~1brands/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Brands Dictionary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a list of brands that match the search query. Results from this endpoint are only valid for AI Search filters. Just like other dictionary endpoints, this endpoints costs nothing and there are no strict rate limits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"query","in":"query","schemaId":"schema_79","description":"Fuzzy search based on brand's name"},{"name":"domain","in":"query","schemaId":"schema_80","description":"Exact match based on brand's domain"},{"name":"platform","in":"query","schemaId":"schema_81","description":"Platform (specify if you want to filter the results by platform)"},{"name":"userId","in":"query","schemaId":"schema_80","description":"Exact match based on brand's user ID (Instagram,Tiktok,Youtube) or domain"},{"name":"brandId","in":"query","schemaId":"schema_80","description":"Exact match based on brand ID (brand identity hash)"}],"pointer":"/paths/~1ai~1brands/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/brands","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"query","in":"query","required":false,"example":"coca cola","schemaId":"schema_79"},{"name":"domain","in":"query","required":false,"schemaId":"schema_80"},{"name":"platform","in":"query","required":false,"example":"instagram","schemaId":"schema_81"},{"name":"userId","in":"query","required":false,"schemaId":"schema_80"},{"name":"brandId","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/ai/brands","href":"ai-search/aisearchcontroller_brandsdictionary","openApiOperationId":"AISearchController_brandsDictionary","summary":"Brands Dictionary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandsDictionaryResponse"}},"schemaId":"components/schemas/BrandsDictionaryResponse"}],"pointer":"/paths/~1ai~1brands/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandsDictionaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandsDictionaryResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_brandsdictionary"}],"panels":[]}]},"httpPath":"/ai/brands"},{"label":"Hashtags Dictionary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_hashtagsdictionary","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_hashtagsdictionary","metadata":{"seo":{"title":"Hashtags Dictionary","description":"Get popular hashtags matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). This endpoint costs nothing and there are no strict rate limits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_hashtagsDictionary","name":"Hashtags Dictionary","isWebhook":false,"pointer":"/paths/~1ai~1hashtags/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Hashtags Dictionary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get popular hashtags matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). This endpoint costs nothing and there are no strict rate limits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"query","in":"query","schemaId":"schema_82","description":"Prefix to search for (e.g. \"cars\" will match \"carsofinstagram\", \"carshow\", etc.)"},{"name":"platform","in":"query","schemaId":"schema_83","description":"Platform to search in","required":true}],"pointer":"/paths/~1ai~1hashtags/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/hashtags","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"query","in":"query","required":false,"schemaId":"schema_82"},{"name":"platform","in":"query","required":true,"schemaId":"schema_83"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/ai/hashtags","href":"ai-search/aisearchcontroller_hashtagsdictionary","openApiOperationId":"AISearchController_hashtagsDictionary","summary":"Hashtags Dictionary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TextTagsDictionaryResponse"}},"schemaId":"components/schemas/TextTagsDictionaryResponse"}],"pointer":"/paths/~1ai~1hashtags/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TextTagsDictionaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TextTagsDictionaryResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_hashtagsdictionary"}],"panels":[]}]},"httpPath":"/ai/hashtags"},{"label":"Mentions Dictionary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_mentionsdictionary","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_mentionsdictionary","metadata":{"seo":{"title":"Mentions Dictionary","description":"Get popular mentions matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). YouTube is not supported. This endpoint costs nothing and there are no strict rate limits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_mentionsDictionary","name":"Mentions Dictionary","isWebhook":false,"pointer":"/paths/~1ai~1mentions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mentions Dictionary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get popular mentions matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). YouTube is not supported. This endpoint costs nothing and there are no strict rate limits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"query","in":"query","schemaId":"schema_82","description":"Prefix to search for (e.g. \"cars\" will match \"carsofinstagram\", \"carshow\", etc.)"},{"name":"platform","in":"query","schemaId":"schema_83","description":"Platform to search in","required":true}],"pointer":"/paths/~1ai~1mentions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/mentions","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"query","in":"query","required":false,"schemaId":"schema_82"},{"name":"platform","in":"query","required":true,"schemaId":"schema_83"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/ai/mentions","href":"ai-search/aisearchcontroller_mentionsdictionary","openApiOperationId":"AISearchController_mentionsDictionary","summary":"Mentions Dictionary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TextTagsDictionaryResponse"}},"schemaId":"components/schemas/TextTagsDictionaryResponse"}],"pointer":"/paths/~1ai~1mentions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TextTagsDictionaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TextTagsDictionaryResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_mentionsdictionary"}],"panels":[]}]},"httpPath":"/ai/mentions"},{"label":"Create AI Search list","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_createlist","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_createlist","metadata":{"seo":{"title":"Create AI Search list","description":"Create an empty list for include/exclude filtering in AI Search. Platform is immutable after create. Each account can have up to 20,000 active lists. If you have a reasonable need for a higher limit, reach out to our Success team.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_createList","name":"Create AI Search list","isWebhook":false,"pointer":"/paths/~1ai~1lists/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create AI Search list","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an empty list for include/exclude filtering in AI Search. Platform is immutable after create. Each account can have up to 20,000 active lists. If you have a reasonable need for a higher limit, reach out to our Success team."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateAiSearchListRequest"}},"schemaId":"components/schemas/CreateAiSearchListRequest","pointer":"/paths/~1ai~1lists/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/lists","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateAiSearchListRequest"}},"responseCodes":["201","409"],"pointer":"/ai/lists","href":"ai-search/aisearchlistscontroller_createlist","openApiOperationId":"AISearchListsController_createList","summary":"Create AI Search list"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/CreateAiSearchListRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateAiSearchListRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListSummary"}},"schemaId":"components/schemas/AiSearchListSummary"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LIST_LIMIT_EXCEEDED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — account already has 20,000 active lists"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/AiSearchListSummary","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListSummary"}}},{"code":"409","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_createlist"}],"panels":[]}]},"httpPath":"/ai/lists"},{"label":"List AI Search lists","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlists","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlists","metadata":{"seo":{"title":"List AI Search lists","description":"Return metadata for the caller's AI Search lists.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_getLists","name":"List AI Search lists","isWebhook":false,"pointer":"/paths/~1ai~1lists/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List AI Search lists","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return metadata for the caller's AI Search lists."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_84","description":"Page size"},{"name":"cursor","in":"query","schemaId":"schema_82","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination cursor from a previous response ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nextCursor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}]}],"pointer":"/paths/~1ai~1lists/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/lists","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_84"},{"name":"cursor","in":"query","required":false,"schemaId":"schema_82"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/ai/lists","href":"ai-search/aisearchlistscontroller_getlists","openApiOperationId":"AISearchListsController_getLists","summary":"List AI Search lists"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAiSearchListsResponse"}},"schemaId":"components/schemas/GetAiSearchListsResponse"}],"pointer":"/paths/~1ai~1lists/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetAiSearchListsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAiSearchListsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_getlists"}],"panels":[]}]},"httpPath":"/ai/lists"},{"label":"Get AI Search list metadata","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlist","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlist","metadata":{"seo":{"title":"Get AI Search list metadata","description":"Return strongly consistent metadata for a list you own.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_getList","name":"Get AI Search list metadata","isWebhook":false,"pointer":"/paths/~1ai~1lists~1{listId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get AI Search list metadata","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return strongly consistent metadata for a list you own."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"listId","in":"path","schemaId":"schema_82","description":"List id (32-char hex)","required":true}],"pointer":"/paths/~1ai~1lists~1{listId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/lists/{listId}","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"listId","in":"path","required":true,"schemaId":"schema_82"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/ai/lists/{listId}","href":"ai-search/aisearchlistscontroller_getlist","openApiOperationId":"AISearchListsController_getList","summary":"Get AI Search list metadata"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListSummary"}},"schemaId":"components/schemas/AiSearchListSummary"},{"code":"404","description":"List not found, already deleted, or not owned by the caller","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists~1{listId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AiSearchListSummary","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListSummary"}}},{"code":"404","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_getlist"}],"panels":[]}]},"httpPath":"/ai/lists/{listId}"},{"label":"Delete AI Search list","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_deletelist","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_deletelist","metadata":{"seo":{"title":"Delete AI Search list","description":"Hard-delete a list and its members.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_deleteList","name":"Delete AI Search list","isWebhook":false,"pointer":"/paths/~1ai~1lists~1{listId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete AI Search list","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Hard-delete a list and its members."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"listId","in":"path","schemaId":"schema_82","description":"List id (32-char hex)","required":true}],"pointer":"/paths/~1ai~1lists~1{listId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/ai/lists/{listId}","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"listId","in":"path","required":true,"schemaId":"schema_82"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/ai/lists/{listId}","href":"ai-search/aisearchlistscontroller_deletelist","openApiOperationId":"AISearchListsController_deleteList","summary":"Delete AI Search list"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204"},{"code":"404","description":"List not found, already deleted, or not owned by the caller","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists~1{listId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_deletelist"}],"panels":[]}]},"httpPath":"/ai/lists/{listId}"},{"label":"List AI Search list members","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getmembers","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getmembers","metadata":{"seo":{"title":"List AI Search list members","description":"Paginated platform user IDs in the list. Use this when you need an exact member set or exact count (sum pages); approximateMemberCount on metadata is only a fast estimate. Default page size 1000, max 5000. Eventually consistent: concurrent adds/removes while you paginate may cause missed members or resurfaced deletes.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_getMembers","name":"List AI Search list members","isWebhook":false,"pointer":"/paths/~1ai~1lists~1{listId}~1members/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List AI Search list members","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paginated platform user IDs in the list. Use this when you need an exact member set or exact count (sum pages); "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approximateMemberCount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on metadata is only a fast estimate. Default page size 1000, max 5000. Eventually consistent: concurrent adds/removes while you paginate may cause missed members or resurfaced deletes."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"listId","in":"path","schemaId":"schema_82","description":"List id (32-char hex)","required":true}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_85","description":"Page size"},{"name":"cursor","in":"query","schemaId":"schema_82","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination cursor from a previous response ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nextCursor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}]}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/ai/lists/{listId}/members","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"listId","in":"path","required":true,"schemaId":"schema_82"}],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_85"},{"name":"cursor","in":"query","required":false,"schemaId":"schema_82"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/ai/lists/{listId}/members","href":"ai-search/aisearchlistscontroller_getmembers","openApiOperationId":"AISearchListsController_getMembers","summary":"List AI Search list members"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAiSearchListMembersResponse"}},"schemaId":"components/schemas/GetAiSearchListMembersResponse"},{"code":"404","description":"List not found, already deleted, or not owned by the caller","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetAiSearchListMembersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAiSearchListMembersResponse"}}},{"code":"404","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_getmembers"}],"panels":[]}]},"httpPath":"/ai/lists/{listId}/members"},{"label":"Add members to an AI Search list","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_addmembers","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_addmembers","metadata":{"seo":{"title":"Add members to an AI Search list","description":"Add members by platform user ID only (no usernames). Existing members are no-ops. Max 10,000 unique IDs per request; max 70,000 members per list.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_addMembers","name":"Add members to an AI Search list","isWebhook":false,"pointer":"/paths/~1ai~1lists~1{listId}~1members/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add members to an AI Search list","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add members by platform user ID only (no usernames). Existing members are no-ops. Max 10,000 unique IDs per request; max 70,000 members per list."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"listId","in":"path","schemaId":"schema_82","description":"List id (32-char hex)","required":true}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"schemaId":"components/schemas/AiSearchListMembersRequest","pointer":"/paths/~1ai~1lists~1{listId}~1members/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/lists/{listId}/members","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"listId","in":"path","required":true,"schemaId":"schema_82"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"responseCodes":["200","404","409"],"pointer":"/ai/lists/{listId}/members","href":"ai-search/aisearchlistscontroller_addmembers","openApiOperationId":"AISearchListsController_addMembers","summary":"Add members to an AI Search list"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/AiSearchListMembersRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddAiSearchListMembersResponse"}},"schemaId":"components/schemas/AddAiSearchListMembersResponse"},{"code":"404","description":"List not found, already deleted, or not owned by the caller","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LIST_SIZE_LIMIT_EXCEEDED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — list would exceed 70,000 members"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AddAiSearchListMembersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddAiSearchListMembersResponse"}}},{"code":"404","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}},{"code":"409","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_addmembers"}],"panels":[]}]},"httpPath":"/ai/lists/{listId}/members"},{"label":"Remove members from an AI Search list","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_removemembers","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_removemembers","metadata":{"seo":{"title":"Remove members from an AI Search list","description":"Remove members by platform user ID only. Missing members are no-ops. Max 10,000 unique IDs per request.Does not consume credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchListsController_removeMembers","name":"Remove members from an AI Search list","isWebhook":false,"pointer":"/paths/~1ai~1lists~1{listId}~1members/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove members from an AI Search list","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Remove members by platform user ID only. Missing members are no-ops. Max 10,000 unique IDs per request."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Does not consume credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"listId","in":"path","schemaId":"schema_82","description":"List id (32-char hex)","required":true}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/delete/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"schemaId":"components/schemas/AiSearchListMembersRequest","pointer":"/paths/~1ai~1lists~1{listId}~1members/delete/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/ai/lists/{listId}/members","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[{"name":"listId","in":"path","required":true,"schemaId":"schema_82"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"responseCodes":["200","404"],"pointer":"/ai/lists/{listId}/members","href":"ai-search/aisearchlistscontroller_removemembers","openApiOperationId":"AISearchListsController_removeMembers","summary":"Remove members from an AI Search list"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/AiSearchListMembersRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AiSearchListMembersRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RemoveAiSearchListMembersResponse"}},"schemaId":"components/schemas/RemoveAiSearchListMembersResponse"},{"code":"404","description":"List not found, already deleted, or not owned by the caller","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}},"schemaId":"components/schemas/AiSearchListErrorResponse"}],"pointer":"/paths/~1ai~1lists~1{listId}~1members/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/RemoveAiSearchListMembersResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RemoveAiSearchListMembersResponse"}}},{"code":"404","schemaId":"components/schemas/AiSearchListErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchListErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchlistscontroller_removemembers"}],"panels":[]}]},"httpPath":"/ai/lists/{listId}/members"},{"label":"Instagram Text-based AI Search","deprecated":true,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_textsearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_textsearch","metadata":{"seo":{"title":"Instagram Text-based AI Search","description":"Find influencers whose posts semantically (what appears in photos and videos) match the text query. Put language, locations, and similar criteria in filters. query does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_textSearch","name":"Instagram Text-based AI Search","deprecated":true,"isWebhook":false,"pointer":"/paths/~1ai~1text-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram Text-based AI Search","isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Find influencers whose posts semantically (what appears in photos and videos) match the text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Put language, locations, and similar criteria in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. Each resulting profile costs 0.025 credits."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"schemaId":"components/schemas/IGTextAiSearchRequest","pointer":"/paths/~1ai~1text-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/text-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/text-search","href":"ai-search/aisearchcontroller_textsearch","openApiOperationId":"AISearchController_textSearch","summary":"Instagram Text-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/IGTextAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGTextAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}},"schemaId":"components/schemas/AiSearchResponse"}],"pointer":"/paths/~1ai~1text-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_textsearch"}],"panels":[]}]},"httpPath":"/ai/text-search"},{"label":"Instagram Image-based AI Search","deprecated":true,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_imagesearch","routeSlug":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_imagesearch","metadata":{"seo":{"title":"Instagram Image-based AI Search","description":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AISearchController_imageSearch","name":"Instagram Image-based AI Search","deprecated":true,"isWebhook":false,"pointer":"/paths/~1ai~1image-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instagram Image-based AI Search","isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile costs 0.025 credits."},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"schemaId":"components/schemas/IGImageAiSearchRequest","pointer":"/paths/~1ai~1image-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/ai/image-search","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"responseCodes":["200"],"pointer":"/ai/image-search","href":"ai-search/aisearchcontroller_imagesearch","openApiOperationId":"AISearchController_imageSearch","summary":"Instagram Image-based AI Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/IGImageAiSearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IGImageAiSearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}},"schemaId":"components/schemas/AiSearchResponse"}],"pointer":"/paths/~1ai~1image-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AiSearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AiSearchResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/ai-search/aisearchcontroller_imagesearch"}],"panels":[]}]},"httpPath":"/ai/image-search"}],"content":{"contentType":"group","meta":{"name":"AI Search"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"AI Search","showPageActions":true},{"nodeType":"markdoc","content":"AI Search allows you to discover creators using natural language or image queries. Under the hood, it uses vector similarity search to find profiles and content that most closely match the concepts in your prompt. You can also combine these AI queries seamlessly with standard filters.\n\nWhen to use it: This endpoint is ideal when your criteria go beyond basic metrics. Use it instead of regular Search when you require rich context about a creator's personal identity and niche, or when trying to match a specific visual style.\nChoose regular search endpoints when the workflow is mainly filter-based without needing semantic search over post content.\n\nAI Search is limited to creators with more than 10,000 followers.\n\nAvailable to Discovery API users."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/ai/instagram/text-search","summary":"Instagram Text-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_igtextsearch","deprecated":false},{"title":"/ai/instagram/image-search","summary":"Instagram Image-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_igimagesearch","deprecated":false},{"title":"/ai/tiktok/text-search","summary":"TikTok Text-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_tttextsearch","deprecated":false},{"title":"/ai/tiktok/image-search","summary":"TikTok Image-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_ttimagesearch","deprecated":false},{"title":"/ai/youtube/text-search","summary":"YouTube Text-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_yttextsearch","deprecated":false},{"title":"/ai/youtube/image-search","summary":"YouTube Image-based AI Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_ytimagesearch","deprecated":false},{"title":"/ai/instagram/lookalikes","summary":"Instagram Creator Lookalikes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_iglookalikes","deprecated":false},{"title":"/ai/tiktok/lookalikes","summary":"TikTok Creator Lookalikes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_ttlookalikes","deprecated":false},{"title":"/ai/youtube/lookalikes","summary":"YouTube Creator Lookalikes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchcontroller_ytlookalikes","deprecated":false},{"title":"/ai/brands","summary":"Brands Dictionary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchcontroller_brandsdictionary","deprecated":false},{"title":"/ai/hashtags","summary":"Hashtags Dictionary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchcontroller_hashtagsdictionary","deprecated":false},{"title":"/ai/mentions","summary":"Mentions Dictionary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchcontroller_mentionsdictionary","deprecated":false},{"title":"/ai/lists","summary":"Create AI Search list","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchlistscontroller_createlist","deprecated":false},{"title":"/ai/lists","summary":"List AI Search lists","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchlistscontroller_getlists","deprecated":false},{"title":"/ai/lists/{listId}","summary":"Get AI Search list metadata","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchlistscontroller_getlist","deprecated":false},{"title":"/ai/lists/{listId}","summary":"Delete AI Search list","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/ai-search/aisearchlistscontroller_deletelist","deprecated":false},{"title":"/ai/lists/{listId}/members","summary":"List AI Search list members","prefix":{"name":"get","color":"get"},"badges":[],"link":"/ai-search/aisearchlistscontroller_getmembers","deprecated":false},{"title":"/ai/lists/{listId}/members","summary":"Add members to an AI Search list","prefix":{"name":"post","color":"post"},"badges":[],"link":"/ai-search/aisearchlistscontroller_addmembers","deprecated":false},{"title":"/ai/lists/{listId}/members","summary":"Remove members from an AI Search list","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/ai-search/aisearchlistscontroller_removemembers","deprecated":false},{"title":"/ai/text-search","summary":"Instagram Text-based AI Search","prefix":{"name":"post","color":"http-deprecated"},"badges":[],"link":"/ai-search/aisearchcontroller_textsearch","deprecated":true},{"title":"/ai/image-search","summary":"Instagram Image-based AI Search","prefix":{"name":"post","color":"http-deprecated"},"badges":[],"link":"/ai-search/aisearchcontroller_imagesearch","deprecated":true}]}]}]}]}},{"type":"group","label":"Collaborations","link":"/products/discovery_api/openapi_doc/discovery/collaborations","routeSlug":"/products/discovery_api/openapi_doc/discovery/collaborations","items":[{"label":"Get collaboration posts","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/collaborations/collaborationscontroller_posts","routeSlug":"/products/discovery_api/openapi_doc/discovery/collaborations/collaborationscontroller_posts","metadata":{"seo":{"title":"Get collaboration posts","description":"This endpoint returns collaborated posts where influencers mention brands or vice versa. \t\t\tEvery successful request costs 0.2 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CollaborationsController_posts","name":"Get collaboration posts","isWebhook":false,"pointer":"/paths/~1collaborations~1posts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get collaboration posts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns collaborated posts where influencers mention brands or vice versa."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" \t\t\tEvery successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0.2 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CollaborationsPostsRequest","exampleIds":["paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/CollaborationsPostsRequest","exampleIds":["paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1collaborations~1posts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/collaborations/posts","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CollaborationsPostsRequest","exampleIds":["paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","404"],"pointer":"/collaborations/posts","href":"collaborations/collaborationscontroller_posts","openApiOperationId":"CollaborationsController_posts","summary":"Get collaboration posts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/CollaborationsPostsRequest","exampleIds":["paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CollaborationsPostsRequest","exampleIds":["paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsPostsResponse"}},"schemaId":"components/schemas/CollaborationsPostsResponse"},{"code":"404","description":"No data found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsNotFoundResponse"}},"schemaId":"components/schemas/CollaborationsNotFoundResponse"}],"pointer":"/paths/~1collaborations~1posts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CollaborationsPostsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsPostsResponse"}}},{"code":"404","schemaId":"components/schemas/CollaborationsNotFoundResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsNotFoundResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/collaborations/collaborationscontroller_posts"}],"panels":[]}]},"httpPath":"/collaborations/posts"},{"label":"Get collaboration summary","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/collaborations/collaborationscontroller_summary","routeSlug":"/products/discovery_api/openapi_doc/discovery/collaborations/collaborationscontroller_summary","metadata":{"seo":{"title":"Get collaboration summary","description":"This endpoint aggregates performance data (total as well as per_brand/per_influencer) across the collaborated posts, including total_likes, total_shares, total_views, total_collects, and total_plays. \t\t\tEvery successful request costs 0.2 credit."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CollaborationsController_summary","name":"Get collaboration summary","isWebhook":false,"pointer":"/paths/~1collaborations~1summary/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get collaboration summary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint aggregates performance data (total as well as per_brand/per_influencer) across the collaborated posts, including total_likes, total_shares, total_views, total_collects, and total_plays."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" \t\t\tEvery successful request costs "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"0.2 credit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CollaborationsSummaryRequest","exampleIds":["paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/CollaborationsSummaryRequest","exampleIds":["paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1collaborations~1summary/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/collaborations/summary","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CollaborationsSummaryRequest","exampleIds":["paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","404"],"pointer":"/collaborations/summary","href":"collaborations/collaborationscontroller_summary","openApiOperationId":"CollaborationsController_summary","summary":"Get collaboration summary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"schemaId":"components/schemas/CollaborationsSummaryRequest","exampleIds":["paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CollaborationsSummaryRequest","exampleIds":["paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsSummaryResponse"}},"schemaId":"components/schemas/CollaborationsSummaryResponse"},{"code":"404","description":"No data found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsNotFoundResponse"}},"schemaId":"components/schemas/CollaborationsNotFoundResponse"}],"pointer":"/paths/~1collaborations~1summary/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CollaborationsSummaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsSummaryResponse"}}},{"code":"404","schemaId":"components/schemas/CollaborationsNotFoundResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CollaborationsNotFoundResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/collaborations/collaborationscontroller_summary"}],"panels":[]}]},"httpPath":"/collaborations/summary"}],"content":{"contentType":"group","meta":{"name":"Collaborations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Collaborations","showPageActions":true},{"nodeType":"markdoc","content":"These endpoints return posts or summaries for the collaborations between influencers and brands. These APIs can help you monitor partnerships, analyze campaign performance, track competitor activity, and power influencer discovery or reporting tools at scale."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/collaborations/posts","summary":"Get collaboration posts","prefix":{"name":"post","color":"post"},"badges":[],"link":"/collaborations/collaborationscontroller_posts","deprecated":false},{"title":"/collaborations/summary","summary":"Get collaboration summary","prefix":{"name":"post","color":"post"},"badges":[],"link":"/collaborations/collaborationscontroller_summary","deprecated":false}]}]}]}]}},{"type":"group","label":"User Account","link":"/products/discovery_api/openapi_doc/discovery/user-account","routeSlug":"/products/discovery_api/openapi_doc/discovery/user-account","items":[{"label":"Get User Account Info","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/user-account/usercontroller_info","routeSlug":"/products/discovery_api/openapi_doc/discovery/user-account/usercontroller_info","metadata":{"seo":{"title":"Get User Account Info","description":"Get User Account Info"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"UserController_info","name":"Get User Account Info","isWebhook":false,"pointer":"/paths/~1user~1info/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get User Account Info","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/user/info","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/user/info","href":"user-account/usercontroller_info","openApiOperationId":"UserController_info","summary":"Get User Account Info"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}},"schemaId":"schema_86"}],"pointer":"/paths/~1user~1info/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_86","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-account/usercontroller_info"}],"panels":[]}]},"httpPath":"/user/info"}],"content":{"contentType":"group","meta":{"name":"User Account"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Account","showPageActions":true},{"nodeType":"markdoc","content":"API for Modash user account management"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/user/info","summary":"Get User Account Info","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-account/usercontroller_info","deprecated":false}]}]}]}]}},{"type":"group","label":"System","link":"/products/discovery_api/openapi_doc/discovery/system","routeSlug":"/products/discovery_api/openapi_doc/discovery/system","items":[{"label":"Health check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/discovery_api/openapi_doc/discovery/system/appcontroller_gethealth","routeSlug":"/products/discovery_api/openapi_doc/discovery/system/appcontroller_gethealth","metadata":{"seo":{"title":"Health check","description":"The health endpoint provides a real-time status of the API, indicating whether the system is Healthy, Degraded, or Unhealthy based on the performance of recent requests.Note: The service health calculation includes all Discovery endpoints but excludes Raw Data endpoints."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AppController_getHealth","name":"Health check","isWebhook":false,"pointer":"/paths/~1health/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Health check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The health endpoint provides a real-time status of the API, indicating whether the system is Healthy, Degraded, or Unhealthy based on the performance of recent requests."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The service health calculation includes all Discovery endpoints but excludes Raw Data endpoints."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"accessToken","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"token","in":"header","paramName":"Authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/health","servers":[{"url":"https://api.modash.io/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"accessToken","type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"token"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/health","href":"system/appcontroller_gethealth","openApiOperationId":"AppController_getHealth","summary":"Health check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.modash.io/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Health"}},"schemaId":"components/schemas/Health"}],"pointer":"/paths/~1health/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Health","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Health"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/system/appcontroller_gethealth"}],"panels":[]}]},"httpPath":"/health"}],"content":{"contentType":"group","meta":{"name":"System"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"System","showPageActions":true},{"nodeType":"markdoc","content":"System endpoints for service health and monitoring"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/health","summary":"Health check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/system/appcontroller_gethealth","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/HealthDetail":{"id":"components/schemas/HealthDetail","kind":"json-schema","title":"HealthDetail","data":{"type":"object","properties":{"endpoint":{"type":"string","description":"Endpoint path"},"status":{"type":"string","description":"Endpoint status"}},"required":["endpoint","status"]}},"components/schemas/Health":{"id":"components/schemas/Health","kind":"json-schema","title":"Health","data":{"type":"object","properties":{"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API health status:"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"ul","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"healthy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates that the system is operating normally."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"degraded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates a moderate level of failures or slow responses in one or more endpoints."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unhealthy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates a high level of failures or significant performance issues in one or more endpoints."},"children":[]}]}]}]}]}],"example":"healthy","enum":["healthy","degraded","unhealthy"]},"details":{"description":"Health details by endpoint","example":[{"endpoint":"email-search","status":"healthy"}],"type":"array","items":{"$ref":"#/components/schemas/HealthDetail"}}},"required":["status","details"]}},"components/schemas/InstagramSort":{"id":"components/schemas/InstagramSort","kind":"json-schema","title":"InstagramSort","data":{"type":"object","properties":{"field":{"type":"string","example":"followers","default":"followers","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The following sort options are available only when the corresponding filter is applied: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceLang"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGender"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceAge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceInterest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"followersGrowth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sorting field in which order you want to get the results."},"children":[]}]}]}],"enum":["engagements","followers","engagementRate","keywords","audienceGeo","audienceLang","audienceGender","audienceAge","audienceRelevance","relevance","followersGrowth","audienceInterest","reelsPlays"]},"value":{"type":"number","example":123,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceInterest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorting."},"children":[]}]}]}]},"direction":{"type":"string","example":"desc","default":"desc","description":"Sorting direction","enum":["asc","desc"]}},"required":["field"]}},"components/schemas/FollowersCount":{"id":"components/schemas/FollowersCount","kind":"json-schema","title":"FollowersCount","data":{"type":"object","properties":{"min":{"type":"number","example":20000,"description":"Minimum follower count."},"max":{"type":"number","example":70000,"description":"Maximum follower count."}}}},"components/schemas/InfluencerAgeRange":{"id":"components/schemas/InfluencerAgeRange","kind":"json-schema","title":"InfluencerAgeRange","data":{"type":"object","properties":{"min":{"type":"number","example":18,"description":"Minimum influencer age.","enum":[18,25,35,45,65]},"max":{"type":"number","example":25,"description":"Maximum influencer age.","enum":[18,25,35,45,65]}}}},"components/schemas/GrowthFilter":{"id":"components/schemas/GrowthFilter","kind":"json-schema","title":"GrowthFilter","data":{"type":"object","properties":{"interval":{"type":"string","description":"Specifies the interval of time in which growth occurred.","enum":["i1month","i2months","i3months","i4months","i5months","i6months"],"example":"i1month"},"value":{"type":"number","description":"Weight of growth rate.","example":0.4},"operator":{"type":"string","description":"Operator used for comparison.","example":"gt","enum":["gte","gt","lt","lte"]}},"required":["interval","operator"]}},"components/schemas/ContactFilter":{"id":"components/schemas/ContactFilter","kind":"json-schema","title":"ContactFilter","data":{"type":"object","properties":{"contactType":{"type":"string","example":"email","enum":["bbm","email","facebook","instagram","itunes","kakao","kik","lineid","linktree","pinterest","sarahah","sayat","skype","snapchat","tiktok","tumblr","twitchtv","twitter","vk","wechat","youtube"],"description":"Specifies the contact channels of an influencer."},"filterAction":{"type":"string","example":"must","enum":["must","should","not"],"default":"must","description":"Defines condition enforced by the filter - \"must\" include, \"should\" include, or must \"not\" include."}},"required":["contactType"]}},"components/schemas/TextTag":{"id":"components/schemas/TextTag","kind":"json-schema","title":"TextTag","data":{"type":"object","properties":{"type":{"type":"string","enum":["hashtag","mention"],"description":"The type of the tag."},"value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The hashtag or mention without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"@"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"#"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in front of it."},"children":[]}]}]}]}},"required":["type","value"]}},"components/schemas/ReelsPlaysCount":{"id":"components/schemas/ReelsPlaysCount","kind":"json-schema","title":"ReelsPlaysCount","data":{"type":"object","properties":{"min":{"type":"number","example":20000,"description":"Minimum reels plays count."},"max":{"type":"number","example":50000000,"description":"Maximum reels plays count."}}}},"components/schemas/EngagementsCount":{"id":"components/schemas/EngagementsCount","kind":"json-schema","title":"EngagementsCount","data":{"type":"object","properties":{"min":{"type":"number","example":5000,"description":"Minimum engagements count (this value will be rounded)."},"max":{"type":"number","example":10000,"description":"Maximum engagements count (this value will be rounded)."}}}},"components/schemas/InstagramFilterOperations":{"id":"components/schemas/InstagramFilterOperations","kind":"json-schema","title":"InstagramFilterOperations","data":{"type":"object","properties":{"operator":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Logical operations used to combine filters."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: To use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator, you must apply it to at least two filters."},"children":[]}]}]}]}],"enum":["and","or","not"]},"filter":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter to apply the operation on. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relevance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are specified then you can not sort by these fields."},"children":[]}]}]}],"enum":["followers","engagements","engagementRate","lastposted","bio","keywords","relevance","language","gender","age","location","isVerified","interests","brands","accountTypes","hasSponsoredPosts","textTags"]}},"required":["operator","filter"]}},"components/schemas/InstagramSearchInfluencerFilters":{"id":"components/schemas/InstagramSearchInfluencerFilters","kind":"json-schema","title":"InstagramSearchInfluencerFilters","data":{"type":"object","properties":{"followers":{"example":{"min":20000,"max":70000},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We round followers value in the filter: whenever it's below 5k, we round it to the nearest thousand (4123 -> 4000; 4800-> 5000); when it's over 5k, we round it to the nearest 5,000 (27k -> 25k; 28k -> 30k)."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/FollowersCount"}]},"engagementRate":{"type":"number","description":"Minimum engagement rate.","maximum":1,"minimum":0,"example":0.02},"location":{"example":[148838,62149,80500,1428125,304716],"description":"Filter by Influencer Location, You can get the locations with our locations api end point and send location ids in an array.","maxItems":20,"type":"array","items":{"type":"number"}},"language":{"type":"string","example":"en","description":"Filter by Influencer Language, You can get the languages code with our languages api end point.","minLength":1,"maxLength":3},"lastposted":{"type":"number","example":90,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idenitfy influencers based on when they last posted. The number represents days and should be >= 30."},"children":[]}]}]}],"minimum":30},"relevance":{"example":["#cars","@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by topic of influencers posts or by similarity of topic to other influencer. For example \"#cars #audi @topgear\" means \"Writing about #cars and #audi, has similar topic as @topgear account.\" "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can only enter 100 usernames."},"children":[]}]}]}]}],"type":"array","items":{"type":"string"}},"audienceRelevance":{"example":["@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by similarity of influencer's audience to another influencer's audience. For example \"@topgear\" means \"Has audience similar to @topgear account.\" Audience similarity means followers follow accounts with the same topics as those followed by @topgear's audience."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"gender":{"type":"string","example":"MALE","description":"Filter by Influencer gender.","enum":["MALE","FEMALE","KNOWN","UNKNOWN"]},"age":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Influencer age, possible values are: 18, 25, 35, 45, 65. You have the option to utilize either the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, or both concurrently. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any number that falls outside the accepted range will be disregarded."},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/InfluencerAgeRange"}]},"followersGrowthRate":{"description":"Growth rate by followers over a period of time.","example":{"interval":"i6months","value":0.01,"operator":"gt"},"allOf":[{"$ref":"#/components/schemas/GrowthFilter"}]},"bio":{"type":"string","example":"photos videos","description":"Search influencer by their bio description and/or full name"},"hasAudienceData":{"type":"boolean","description":"Filter by whether the influencer has audience data available. If true, shows only accounts with audience data. If false, shows all accounts including those without audience data. If not specified, defaults to true."},"hasYouTube":{"type":"boolean","example":false,"description":"If Influencer has a youtube channel."},"hasContactDetails":{"description":"If Influencer has contact details.","type":"array","items":{"$ref":"#/components/schemas/ContactFilter"}},"accountTypes":{"example":[2],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identify influencers by their Instagram account type: Regular = 1, Business = 2, Creator = 3. E.g to find business accounts use: 2"},"children":[]}]}]}],"type":"array","items":{"type":"number"}},"brands":{"example":[1708,13],"description":"Filter by Influencer Brands, You can get the array of brands with our brands API endpoint and send brand ids in an array.","type":"array","items":{"type":"number"}},"interests":{"example":[3,21,1,13,11,1708,7,1826],"description":"Filter by Influencer Interests, You can get the array of interests with our interests api end point and send interests ids in an array.","type":"array","items":{"type":"number"}},"keywords":{"type":"string","description":"Identify influencers by a phrase they use within the caption of their post.","example":"supercars"},"textTags":{"example":[{"type":"hashtag","value":"carsofinstagram"},{"type":"mention","value":"topgear"}],"maxItems":20,"description":"Filter by influencers who have used the defined hashtags or mentions in their posts. ","type":"array","items":{"$ref":"#/components/schemas/TextTag"}},"reelsPlays":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We round reels plays value in the filter to the nearest thousand (1400 -> 1k; 1500-> 2k)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ReelsPlaysCount"}]},"isVerified":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter by verified influencers."},"children":[]}]}]}]},"hasSponsoredPosts":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter by influencers who have sponsored posts. We identify sponsored posts by looking for commercial hashtags or the official paid partnership tag."},"children":[]}]}]}]},"engagements":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by engagements count. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pro tip: set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to 0 if you want to see results with hidden likes."},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/EngagementsCount"}]},"filterOperations":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Modify filter operation to use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Example: Search for "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"influencer using the keyword "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cars"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" AND "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the London"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Female "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" interested in Beauty & Cosmetics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If no operator is specified, the default operator applied is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator."},"children":[]}]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/InstagramFilterOperations"}}}}},"components/schemas/LocationWeightedFilter":{"id":"components/schemas/LocationWeightedFilter","kind":"json-schema","title":"LocationWeightedFilter","data":{"type":"object","properties":{"weight":{"type":"number","description":"Weight of filter.","maximum":1,"minimum":0,"example":0.4},"id":{"type":"number","description":"Filter value id for location (e.g. 148838)"}},"required":["id"]}},"components/schemas/LanguageWeightedFilter":{"id":"components/schemas/LanguageWeightedFilter","kind":"json-schema","title":"LanguageWeightedFilter","data":{"type":"object","properties":{"weight":{"type":"number","description":"Weight of filter.","maximum":1,"minimum":0,"example":0.4},"id":{"type":"string","description":"Filter value id for language (e.g. \"en\")","minLength":1,"maxLength":2}},"required":["id"]}},"components/schemas/GenderWeightedFilter":{"id":"components/schemas/GenderWeightedFilter","kind":"json-schema","title":"GenderWeightedFilter","data":{"type":"object","properties":{"weight":{"type":"number","description":"Weight of filter.","maximum":1,"minimum":0,"example":0.4},"id":{"type":"string","description":"Filter value id for gender","enum":["MALE","FEMALE"]}},"required":["id"]}},"components/schemas/AgeWeightedFilter":{"id":"components/schemas/AgeWeightedFilter","kind":"json-schema","title":"AgeWeightedFilter","data":{"type":"object","properties":{"weight":{"type":"number","description":"Weight of filter.","maximum":1,"minimum":0,"example":0.4},"id":{"type":"string","description":"Filter value id for age","enum":["13-17","18-24","25-34","35-44","45-64","65-"]}},"required":["id"]}},"components/schemas/AudienceAgeRange":{"id":"components/schemas/AudienceAgeRange","kind":"json-schema","title":"AudienceAgeRange","data":{"type":"object","properties":{"min":{"type":"string","example":18,"description":"Minimum audience age.","enum":["13","18","25","35","45","65"]},"max":{"type":"string","example":24,"description":"Maximum audience age.","enum":["17","24","34","44","64"]},"weight":{"type":"number","description":"Weight of audience age range.","minimum":0,"maximum":1,"example":0.3}}}},"components/schemas/InterestsWeightedFilter":{"id":"components/schemas/InterestsWeightedFilter","kind":"json-schema","title":"InterestsWeightedFilter","data":{"type":"object","properties":{"weight":{"type":"number","description":"Weight of filter.","maximum":1,"minimum":0,"example":0.4},"id":{"type":"number","description":"Filter value id for interests (e.g. 1708)"}},"required":["id"]}},"components/schemas/InstagramSearchAudienceFilters":{"id":"components/schemas/InstagramSearchAudienceFilters","kind":"json-schema","title":"InstagramSearchAudienceFilters","data":{"type":"object","properties":{"location":{"example":[{"id":148838,"weight":0.2},{"id":62149,"weight":0.2},{"id":80500,"weight":0.2},{"id":1428125,"weight":0.2},{"id":304716,"weight":0.2}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Location, You can get the locations with our locations api end point and send location ids in an array together with their weight percentages. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/LocationWeightedFilter"}},"language":{"example":{"id":"en","weight":0.2},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Language, You can get the languages code with our languages api end point and send the location id within an object, together with the weight percentage. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/LanguageWeightedFilter"}]},"gender":{"example":{"id":"MALE","weight":0.5},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by gender specific Audience, You can send the gender together with the weight percentage. The default percentage is set to 50% (0.5)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/GenderWeightedFilter"}]},"age":{"example":[{"id":"18-24","weight":0.3},{"id":"65-","weight":0.3}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience age. You can send the age together with the weight percentage. The default percentage is set to 30% (0.3)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/AgeWeightedFilter"}},"ageRange":{"example":{"min":"18","max":"24","weight":0.3},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by audience age range. You can send the age range together with the weight percentage. The default percentage is set to 30% (0.3). You can't send both age and ageRange together."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/AudienceAgeRange"}]},"interests":{"example":[{"id":1708,"weight":0.2},{"id":13,"weight":0.2},{"id":3,"weight":0.2},{"id":21,"weight":0.2},{"id":1,"weight":0.2},{"id":11,"weight":0.2},{"id":7,"weight":0.2},{"id":1826,"weight":0.2}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Interests, You can get the array of interests with our interests api end point and send interests ids in an array together with their weight percentages. The default percentage is set to 30% (0.3)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/InterestsWeightedFilter"}},"credibility":{"type":"number","example":0.75,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Credibility. The value is the inverse of fake followers, meaning 25% fake followers would translate to 0.75 of audience credibility."},"children":[]}]}]}],"minimum":0,"maximum":1}}}},"components/schemas/InstagramSearchFilters":{"id":"components/schemas/InstagramSearchFilters","kind":"json-schema","title":"InstagramSearchFilters","data":{"type":"object","properties":{"influencer":{"$ref":"#/components/schemas/InstagramSearchInfluencerFilters"},"audience":{"$ref":"#/components/schemas/InstagramSearchAudienceFilters"}}}},"components/schemas/InstagramSearchBody":{"id":"components/schemas/InstagramSearchBody","kind":"json-schema","title":"InstagramSearchBody","data":{"type":"object","properties":{"page":{"type":"number","description":"Page number","default":0,"minimum":0,"maximum":665},"calculationMethod":{"type":"string","example":"median","default":"median","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc.","enum":["median","average"]},"sort":{"description":"Sorting","allOf":[{"$ref":"#/components/schemas/InstagramSort"}]},"filter":{"example":{"influencer":{"followers":{"min":20000},"engagementRate":0.02,"location":[148838,62149,80500,1428125,304716],"language":"en","lastposted":90,"gender":"MALE","age":{"min":18},"followersGrowthRate":{"interval":"i6months","value":0.01,"operator":"gt"},"hasContactDetails":[{"contactType":"email","filterAction":"must"}],"interests":[3,21,1,13,11,1708,7,1826],"keywords":"supercars","reelsPlays":{"min":20000},"engagements":{"min":5000}},"audience":{"location":[{"id":148838,"weight":0.2},{"id":62149,"weight":0.2},{"id":80500,"weight":0.2},{"id":1428125,"weight":0.2},{"id":304716,"weight":0.2}],"language":{"id":"en","weight":0.2},"gender":{"id":"MALE","weight":0.5},"age":[{"id":"18-24","weight":0.3},{"id":"65-","weight":0.3}],"interests":[{"id":1708,"weight":0.2},{"id":13,"weight":0.2},{"id":3,"weight":0.2},{"id":21,"weight":0.2},{"id":1,"weight":0.2},{"id":11,"weight":0.2},{"id":7,"weight":0.2},{"id":1826,"weight":0.2}],"credibility":0.75}},"allOf":[{"$ref":"#/components/schemas/InstagramSearchFilters"}]}}}},"components/schemas/ProfileResponse":{"id":"components/schemas/ProfileResponse","kind":"json-schema","title":"ProfileResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"url":{"type":"string","description":"Profile URL","example":"https://www.instagram.com/instagram/"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994},"engagementRate":{"type":"number","description":"Engagement rate","example":0.0027362938100525414}},"required":["username","url","picture","followers","engagements","engagementRate"]}},"components/schemas/InfluencerMatch":{"id":"components/schemas/InfluencerMatch","kind":"json-schema","title":"InfluencerMatch","data":{"type":"object","properties":{"geo":{"type":"object","description":"Influencer geo","example":{"city":{"id":1,"name":"New York","code":"NY"},"state":{"id":1,"name":"California","code":"CA"},"country":{"id":1,"name":"United States","code":"US"},"subdivision":{"id":1,"name":"New York State","code":"NY"}}},"language":{"type":"object","description":"Influencer language","example":{"code":"en","name":"English"}},"relevance":{"type":"number","description":"Influencer relevance","example":0.85},"gender":{"type":"string","description":"Influencer gender","example":"FEMALE"},"age":{"type":"string","description":"Influencer age","example":"25-34"},"followersGrowthRate":{"type":"number","description":"Influencer followers growth rate","example":0.05},"brands":{"description":"Influencer brands","example":[{"id":1,"name":"Nike"}],"type":"array","items":{"type":"object"}},"interests":{"description":"Influencer interests","example":[{"id":3,"name":"Music"}],"type":"array","items":{"type":"object"}},"audienceRelevance":{"type":"number","description":"Influencer audience relevance","example":0.85}}}},"components/schemas/AudienceMatch":{"id":"components/schemas/AudienceMatch","kind":"json-schema","title":"AudienceMatch","data":{"type":"object","properties":{"ages":{"description":"Audience ages","example":[{"code":"13-17","weight":0.25}],"type":"array","items":{"type":"object"}},"ageRange":{"type":"object","description":"Audience age range","example":{"code":"13-17","weight":0.25}},"credibility":{"type":"number","description":"Audience credibility","example":0.85},"geo":{"type":"object","description":"Audience geo","example":{"countries":[{"id":1,"name":"United States","code":"US","weight":0.25}],"states":[{"id":1,"name":"California","code":"CA","weight":0.25}],"cities":[{"id":1,"name":"New York","code":"NY","weight":0.25}],"subdivisions":[{"id":1,"name":"New York State","weight":0.25}]}},"interests":{"description":"Audience interests","example":[{"id":1,"name":"Fashion"}],"type":"array","items":{"type":"object"}},"languages":{"description":"Audience languages","example":[{"code":"en","name":"English","weight":0.25}],"type":"array","items":{"type":"object"}},"genders":{"description":"Audience genders","example":[{"code":"MALE","weight":0.25}],"type":"array","items":{"type":"object"}}}}},"components/schemas/Match":{"id":"components/schemas/Match","kind":"json-schema","title":"Match","data":{"type":"object","properties":{"influencer":{"description":"Influencer match","allOf":[{"$ref":"#/components/schemas/InfluencerMatch"}]},"audience":{"description":"Audience match","allOf":[{"$ref":"#/components/schemas/AudienceMatch"}]}}}},"components/schemas/InfluencerResponse":{"id":"components/schemas/InfluencerResponse","kind":"json-schema","title":"InfluencerResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User Id","example":"173560420"},"profile":{"description":"Profile info of influencer","allOf":[{"$ref":"#/components/schemas/ProfileResponse"}]},"match":{"description":"Match","allOf":[{"$ref":"#/components/schemas/Match"}]}},"required":["userId","profile"]}},"components/schemas/SearchResponse":{"id":"components/schemas/SearchResponse","kind":"json-schema","title":"SearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Number of results","example":2},"lookalikes":{"description":"Lookalikes","type":"array","items":{"$ref":"#/components/schemas/InfluencerResponse"}},"directs":{"description":"Directs","type":"array","items":{"$ref":"#/components/schemas/InfluencerResponse"}},"isExactMatch":{"type":"boolean","description":"Are the results exactly matching the filters you provided? If we don't find exact results then we try to show similar users by automatically removing some filters for you.","example":true}},"required":["total","lookalikes","directs","isExactMatch"]}},"components/schemas/InstagramProfileResponse":{"id":"components/schemas/InstagramProfileResponse","kind":"json-schema","title":"InstagramProfileResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"url":{"type":"string","description":"Profile URL","example":"https://www.instagram.com/instagram/"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994},"engagementRate":{"type":"number","description":"Engagement rate","example":0.0027362938100525414}},"required":["username","url","picture","followers","engagements","engagementRate"]}},"components/schemas/Tag":{"id":"components/schemas/Tag","kind":"json-schema","title":"Tag","data":{"type":"object","properties":{"tag":{"type":"string","example":""},"weight":{"type":"number","example":0.1}},"required":["tag","weight"]}},"components/schemas/ContentTypeStatsHistory":{"id":"components/schemas/ContentTypeStatsHistory","kind":"json-schema","title":"ContentTypeStatsHistory","data":{"type":"object","properties":{"month":{"type":"string","example":"2025-01"},"avgLikes":{"type":"number","example":0},"avgEngagements":{"type":"number","example":0},"avgViews":{"type":"number","example":0},"avgComments":{"type":"number","example":0},"avgShares":{"type":"number","example":0},"avgSaves":{"type":"number","example":0}}}},"components/schemas/ContentTypeStatsInstagram":{"id":"components/schemas/ContentTypeStatsInstagram","kind":"json-schema","title":"ContentTypeStatsInstagram","data":{"type":"object","properties":{"engagements":{"type":"number","example":0},"engagementRate":{"type":"number","example":0},"avgLikes":{"type":"number","example":0},"avgComments":{"type":"number","example":0},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/ContentTypeStatsHistory"}},"avgReelsPlays":{"type":"number","example":0},"avgShares":{"type":"number","example":0}}}},"components/schemas/StatsByContentTypeInstagram":{"id":"components/schemas/StatsByContentTypeInstagram","kind":"json-schema","title":"StatsByContentTypeInstagram","data":{"type":"object","properties":{"all":{"example":{},"description":"All content type stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsInstagram"}]},"reels":{"example":{},"description":"Reels stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsInstagram"}]}}}},"components/schemas/WeightWithCode":{"id":"components/schemas/WeightWithCode","kind":"json-schema","title":"WeightWithCode","data":{"type":"object","properties":{"code":{"type":"string","example":""},"weight":{"type":"number","example":0.07}},"required":["code","weight"]}},"components/schemas/WeightWithCodeName":{"id":"components/schemas/WeightWithCodeName","kind":"json-schema","title":"WeightWithCodeName","data":{"type":"object","properties":{"name":{"type":"string","example":""},"weight":{"type":"number","example":0.07},"code":{"type":"string","example":""}},"required":["name","weight","code"]}},"components/schemas/GenderPerAge":{"id":"components/schemas/GenderPerAge","kind":"json-schema","title":"GenderPerAge","data":{"type":"object","properties":{"code":{"type":"string","example":""},"male":{"type":"number","example":0.07},"female":{"type":"number","example":0.07}},"required":["code","male","female"]}},"components/schemas/WeightWithName":{"id":"components/schemas/WeightWithName","kind":"json-schema","title":"WeightWithName","data":{"type":"object","properties":{"name":{"type":"string","example":""},"weight":{"type":"number","example":0.07}},"required":["name","weight"]}},"components/schemas/InstagramAudienceSubdivision":{"id":"components/schemas/InstagramAudienceSubdivision","kind":"json-schema","title":"InstagramAudienceSubdivision","data":{"type":"object","properties":{"name":{"type":"string","example":""},"code":{"type":"string","example":""},"items":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithName"}}},"required":["name","code","items"]}},"components/schemas/AudienceLanguage":{"id":"components/schemas/AudienceLanguage","kind":"json-schema","title":"AudienceLanguage","data":{"type":"object","properties":{"code":{"type":"string","example":"it"},"name":{"type":"string","example":"Italian"},"weight":{"type":"number","example":0.1}},"required":["code","name","weight"]}},"components/schemas/User":{"id":"components/schemas/User","kind":"json-schema","title":"User","data":{"type":"object","properties":{"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"url":{"type":"string","description":"Profile URL","example":"https://www.instagram.com/instagram/"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994}},"required":["username","url","picture","followers","engagements"]}},"components/schemas/AudienceEthnicities":{"id":"components/schemas/AudienceEthnicities","kind":"json-schema","title":"AudienceEthnicities","data":{"type":"object","properties":{"code":{"type":"string","example":"white","enum":["white","asian","african_american","hispanic"]},"name":{"type":"string","example":"White / Caucasian","enum":["White / Caucasian","Asian","African American","Hispanic"]},"weight":{"type":"number","example":0.1}},"required":["code","name","weight"]}},"components/schemas/AudienceReachability":{"id":"components/schemas/AudienceReachability","kind":"json-schema","title":"AudienceReachability","data":{"type":"object","properties":{"code":{"type":"string","example":"500-1000","enum":["-500","500-1000","1000-1500","1500-"],"description":"Range of the number of accounts followed"},"weight":{"type":"number","example":0.1,"description":"Percentage of the audience"}},"required":["code","weight"]}},"components/schemas/AudienceType":{"id":"components/schemas/AudienceType","kind":"json-schema","title":"AudienceType","data":{"type":"object","properties":{"code":{"type":"string","example":"real","enum":["mass_followers","suspicious","influencers","real"],"description":"Type of the audience"},"weight":{"type":"number","example":0.9,"description":"Percentage of the audience"}},"required":["code","weight"]}},"components/schemas/InstagramReportAudience":{"id":"components/schemas/InstagramReportAudience","kind":"json-schema","title":"InstagramReportAudience","data":{"type":"object","properties":{"notable":{"type":"number","example":0.07},"genders":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"geoCountries":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCodeName"}},"ages":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"gendersPerAge":{"type":"array","items":{"$ref":"#/components/schemas/GenderPerAge"}},"geoCities":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithName"}},"geoStates":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithName"}},"geoSubdivisions":{"type":"array","items":{"$ref":"#/components/schemas/InstagramAudienceSubdivision"}},"credibility":{"type":"number","example":0.75},"interests":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithName"}},"brandAffinity":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithName"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/AudienceLanguage"}},"notableUsers":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceLookalikes":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"ethnicities":{"type":"array","items":{"$ref":"#/components/schemas/AudienceEthnicities"}},"audienceReachability":{"description":"Percentage of the audience based on the number of accounts they follow, categorized into specific ranges. For instance, percentage of followers following no more than 500 accounts, or following between 500 and 1000 accounts.","example":[{"code":"-500","weight":0.379536},{"code":"500-1000","weight":0.161691},{"code":"1000-1500","weight":0.097547},{"code":"1500-","weight":0.361225}],"type":"array","items":{"$ref":"#/components/schemas/AudienceReachability"}},"audienceTypes":{"description":"Percentage of the audience based on the type of accounts they follow","example":[{"code":"mass_followers","weight":0.379536},{"code":"suspicious","weight":0.161691},{"code":"influencers","weight":0.097547},{"code":"real","weight":0.361225}],"type":"array","items":{"$ref":"#/components/schemas/AudienceType"}}},"required":["notable","genders","geoCountries","ages","gendersPerAge","geoCities","geoStates","geoSubdivisions","credibility","interests","brandAffinity","languages","notableUsers","audienceLookalikes","ethnicities"]}},"components/schemas/StatsData":{"id":"components/schemas/StatsData","kind":"json-schema","title":"StatsData","data":{"type":"object","properties":{"value":{"type":"number","description":"Value","example":859004},"compared":{"type":"number","description":"Change in value compared to last month","example":0.007144320631801482}}}},"components/schemas/Stats":{"id":"components/schemas/Stats","kind":"json-schema","title":"Stats","data":{"type":"object","properties":{"avgLikes":{"description":"Average Likes and historical comparison","allOf":[{"$ref":"#/components/schemas/StatsData"}]},"followers":{"description":"Followers and historical comparison","allOf":[{"$ref":"#/components/schemas/StatsData"}]},"avgShares":{"description":"Average Shares and historical comparison","allOf":[{"$ref":"#/components/schemas/StatsData"}]},"avgComments":{"description":"Average Comments and historical comparison","allOf":[{"$ref":"#/components/schemas/StatsData"}]}}}},"components/schemas/InstagramRecentPost":{"id":"components/schemas/InstagramRecentPost","kind":"json-schema","title":"InstagramRecentPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"mentions":{"type":"array","items":{"type":"string"}},"hashtags":{"type":"array","items":{"type":"string"}}},"required":["id","text","url","created","type"]}},"components/schemas/InstagramPopularPost":{"id":"components/schemas/InstagramPopularPost","kind":"json-schema","title":"InstagramPopularPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"thumbnail":{"type":"string"}},"required":["id","text","url","created","type","thumbnail"]}},"components/schemas/Language":{"id":"components/schemas/Language","kind":"json-schema","title":"Language","data":{"type":"object","properties":{"code":{"type":"string","description":"ISO 639 language code (2-letter ISO 639-1 where available, otherwise 3-letter ISO 639-2/639-3).","example":"en","enum":["af","als","am","an","ar","arz","as","ast","av","az","azb","ba","bar","bcl","be","bg","bh","bn","bo","bpy","br","bs","bxr","ca","cbk","ce","ceb","ckb","co","cs","cv","cy","da","de","diq","dsb","dty","dv","dz","el","eml","en","eo","es","et","eu","fa","fi","fo","fr","frr","fy","ga","gd","gl","gn","gom","gu","gv","he","hi","hif","hr","hsb","ht","hu","hy","ia","id","ie","ilo","io","is","it","ja","jbo","jv","ka","kk","km","kn","ko","krc","ku","kv","kw","ky","la","lb","lez","li","lmo","lo","lrc","lt","lv","mai","mg","mhr","min","mk","ml","mn","mr","mrj","ms","mt","mwl","my","myv","mzn","nah","nap","nb","nds","ne","new","nl","nn","no","oc","or","os","pa","pam","pfl","pl","pms","pnb","ps","pt","qu","rm","ro","ru","rue","rw","sa","sah","sc","scn","sco","sd","se","sh","si","sk","sl","so","sq","sr","su","sv","sw","ta","te","tg","th","tk","tl","tr","tt","tyv","ug","uk","ur","uz","vec","vep","vi","vls","vo","wa","war","wuu","xal","xh","xmf","yi","yo","yue","zh","zu"]},"name":{"type":"string","description":"Name of the language in English","example":"English"}},"required":["code","name"]}},"components/schemas/Contacts":{"id":"components/schemas/Contacts","kind":"json-schema","title":"Contacts","data":{"type":"object","properties":{"type":{"type":"string","example":"email","enum":["bbm","email","facebook","instagram","itunes","kakao","kik","lineid","linktree","phone","pinterest","sarahah","sayat","skype","snapchat","telegram","threads","tiktok","tumblr","twitchtv","twitter","viber","vk","wechat","weibo","whatsapp","youtube"]},"value":{"type":"string","example":"influenceremail@example.com","minLength":1}},"required":["type","value"]}},"components/schemas/Interest":{"id":"components/schemas/Interest","kind":"json-schema","title":"Interest","data":{"type":"object","properties":{"id":{"type":"number","example":1},"name":{"type":"string","example":""}},"required":["id","name"]}},"components/schemas/Brand":{"id":"components/schemas/Brand","kind":"json-schema","title":"Brand","data":{"type":"object","properties":{"id":{"type":"number","example":1},"name":{"type":"string","example":""}},"required":["id","name"]}},"components/schemas/PostSponsor":{"id":"components/schemas/PostSponsor","kind":"json-schema","title":"PostSponsor","data":{"type":"object","properties":{"domain":{"type":"string"},"logo_url":{"type":"string"},"name":{"type":"string"}}}},"components/schemas/InstagramSponsoredPost":{"id":"components/schemas/InstagramSponsoredPost","kind":"json-schema","title":"InstagramSponsoredPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"mentions":{"type":"array","items":{"type":"string"}},"hashtags":{"type":"array","items":{"type":"string"}},"video":{"type":"string"},"image":{"type":"string"},"thumbnail":{"type":"string"},"sponsors":{"type":"array","items":{"$ref":"#/components/schemas/PostSponsor"}}},"required":["id","text","url","created","type","thumbnail"]}},"components/schemas/MonthlyStat":{"id":"components/schemas/MonthlyStat","kind":"json-schema","title":"MonthlyStat","data":{"type":"object","properties":{"month":{"type":"string","example":"2019-05"},"followers":{"type":"number","example":1000},"following":{"type":"number","example":1000},"avgLikes":{"type":"number","example":1000},"avgViews":{"type":"number","example":1000},"avgComments":{"type":"number","example":1000},"avgShares":{"type":"number","example":1000}},"required":["month","followers","following","avgLikes","avgViews","avgComments"]}},"components/schemas/FollowersRange":{"id":"components/schemas/FollowersRange","kind":"json-schema","title":"FollowersRange","data":{"type":"object","properties":{"leftNumber":{"type":"number","example":100000},"rightNumber":{"type":"number","example":500000}}}},"components/schemas/HistogramBin":{"id":"components/schemas/HistogramBin","kind":"json-schema","title":"HistogramBin","data":{"type":"object","properties":{"min":{"type":"number","description":"The lower bound of the range","example":0.4546},"max":{"type":"number","description":"The upper bound of the range","example":0.6482},"total":{"type":"number","description":"The total count of data points within this range","example":5551},"median":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates if this bin represents the median range of the data. Only one range has this value set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]}]}]}],"example":true}},"required":["total"]}},"components/schemas/AudienceExtraInstagramReportData":{"id":"components/schemas/AudienceExtraInstagramReportData","kind":"json-schema","title":"AudienceExtraInstagramReportData","data":{"type":"object","properties":{"followersRange":{"description":"All histograms shown here are based on influencers whose number of followers fall within the range specified in this field","allOf":[{"$ref":"#/components/schemas/FollowersRange"}]},"engagementRateDistribution":{"description":"Distribution of influencers by their followers' engagement rate. This histogram displays how influencers from the same follower group are distributed based on the engagement rate of their followers. Ranges are automatically chosen for a clearer view of the entire histogram","type":"array","items":{"$ref":"#/components/schemas/HistogramBin"}},"credibilityDistribution":{"description":"Distribution of influencers by their followers' credibility. This histogram displays how influencers from the same follower group are distributed based on the credibility of their followers. Ranges are automatically chosen for a clearer view of the entire histogram","type":"array","items":{"$ref":"#/components/schemas/HistogramBin"}}},"required":["followersRange","engagementRateDistribution"]}},"components/schemas/InstagramReportProfile":{"id":"components/schemas/InstagramReportProfile","kind":"json-schema","title":"InstagramReportProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User Id","example":"173560420"},"profile":{"description":"Influencer Profile","allOf":[{"$ref":"#/components/schemas/InstagramProfileResponse"}]},"hashtags":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}},"mentions":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}},"statsByContentType":{"description":"User stats separated by content type","allOf":[{"$ref":"#/components/schemas/StatsByContentTypeInstagram"}]},"audience":{"description":"Audience data","allOf":[{"$ref":"#/components/schemas/InstagramReportAudience"}]},"stats":{"description":"Influencer stats, likes and followers (deprecated in favor of statsByContentType)","deprecated":true,"allOf":[{"$ref":"#/components/schemas/Stats"}]},"recentPosts":{"description":"Recent Posts","example":[{"id":"string","text":"string","url":"string","created":"string","likes":0,"comments":0,"mentions":["string"],"hashtags":["string"]}],"type":"array","items":{"$ref":"#/components/schemas/InstagramRecentPost"}},"popularPosts":{"description":"Popular Posts","type":"array","items":{"$ref":"#/components/schemas/InstagramPopularPost"}},"city":{"type":"string","example":"New york"},"state":{"type":"string","example":"California"},"subdivision":{"type":"string","example":"New York State"},"gender":{"type":"string","example":"FEMALE","enum":["MALE","FEMALE"]},"language":{"$ref":"#/components/schemas/Language"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contacts"}},"country":{"type":"string","example":"US"},"ageGroup":{"type":"string","example":"18-24","enum":["13-17","18-24","25-34","35-44","45-64","65-"]},"isPrivate":{"type":"boolean","example":true},"accountType":{"type":"string","example":"Regular","enum":["Regular","Business","Creator"]},"isVerified":{"type":"boolean","example":true},"postsCounts":{"type":"number","example":37},"avgLikes":{"type":"number","example":18211},"avgComments":{"type":"number","example":12321},"bio":{"type":"string","example":"CEO of #RockTok"},"interests":{"type":"array","items":{"$ref":"#/components/schemas/Interest"}},"brandAffinity":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}},"sponsoredPosts":{"type":"array","items":{"$ref":"#/components/schemas/InstagramSponsoredPost"}},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/MonthlyStat"}},"lookalikes":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"postsCount":{"type":"number","example":37},"avgViews":{"type":"number","example":48},"avgReelsPlays":{"type":"number","example":5727},"audienceExtra":{"$ref":"#/components/schemas/AudienceExtraInstagramReportData"},"paidPostPerformance":{"type":"number","example":0.5},"paidPostPerformanceViews":{"type":"number","example":37},"sponsoredPostsMedianViews":{"type":"number","example":3127},"sponsoredPostsMedianLikes":{"type":"number","example":3743},"nonSponsoredPostsMedianViews":{"type":"number","example":267},"nonSponsoredPostsMedianLikes":{"type":"number","example":367}},"required":["userId","hashtags","mentions","isPrivate","accountType","isVerified","postsCounts","avgLikes","avgComments","bio","interests","brandAffinity","sponsoredPosts","statHistory","lookalikes","postsCount","avgViews","avgReelsPlays","paidPostPerformanceViews","sponsoredPostsMedianViews","sponsoredPostsMedianLikes","nonSponsoredPostsMedianViews","nonSponsoredPostsMedianLikes"]}},"components/schemas/InstagramReport":{"id":"components/schemas/InstagramReport","kind":"json-schema","title":"InstagramReport","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"profile":{"$ref":"#/components/schemas/InstagramReportProfile"}},"required":["profile"]}},"components/schemas/AudiencerOverlapBody":{"id":"components/schemas/AudiencerOverlapBody","kind":"json-schema","title":"AudiencerOverlapBody","data":{"type":"object","properties":{"influencers":{"description":"List of usernames or user ids","example":["MrBeast","cristiano"],"type":"array","items":{"type":"string"}}}}},"components/schemas/ReportInfo":{"id":"components/schemas/ReportInfo","kind":"json-schema","title":"ReportInfo","data":{"type":"object","properties":{"totalFollowers":{"type":"number","description":"Total followers"},"totalUniqueFollowers":{"type":"number","description":"Total unique followers"}},"required":["totalFollowers","totalUniqueFollowers"]}},"components/schemas/OverlapReport":{"id":"components/schemas/OverlapReport","kind":"json-schema","title":"OverlapReport","data":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"username":{"type":"string","minLength":1},"followers":{"type":"number","description":"Number of followers for this influencer"},"uniquePercentage":{"type":"number","description":"The percent of followers that are unique for this influencer (they do not follow any other influencer within this overlap request)"},"overlappingPercentage":{"type":"number","description":"The percent of followers that overlap with at least one other influencer (they follow at least one other influencer within this overlap request)"}},"required":["userId","followers","uniquePercentage","overlappingPercentage"]}},"components/schemas/AudienceOverlapResponse":{"id":"components/schemas/AudienceOverlapResponse","kind":"json-schema","title":"AudienceOverlapResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"reportInfo":{"$ref":"#/components/schemas/ReportInfo"},"data":{"type":"array","items":{"$ref":"#/components/schemas/OverlapReport"}}},"required":["reportInfo","data"]}},"components/schemas/ListBrandsResponse":{"id":"components/schemas/ListBrandsResponse","kind":"json-schema","title":"ListBrandsResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"brands":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}},"total":{"type":"number","example":28,"description":"Total number of brands"}},"required":["brands","total"]}},"components/schemas/ListInterestsResponse":{"id":"components/schemas/ListInterestsResponse","kind":"json-schema","title":"ListInterestsResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"interests":{"type":"array","items":{"$ref":"#/components/schemas/Interest"}},"total":{"type":"number","example":28,"description":"Total number of interests"}},"required":["interests","total"]}},"components/schemas/HashtagsResponse":{"id":"components/schemas/HashtagsResponse","kind":"json-schema","title":"HashtagsResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"tags":{"type":"array","items":{"type":"string"}}},"required":["tags"]}},"components/schemas/ListLanguagesResponse":{"id":"components/schemas/ListLanguagesResponse","kind":"json-schema","title":"ListLanguagesResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"languages":{"type":"array","items":{"$ref":"#/components/schemas/Language"}},"total":{"type":"number","example":98,"description":"Total number of languages"}},"required":["languages","total"]}},"components/schemas/Location":{"id":"components/schemas/Location","kind":"json-schema","title":"Location","data":{"type":"object","properties":{"id":{"type":"number","example":51800,"description":"Id of the location"},"name":{"type":"string","example":"London","description":"Name of the location"},"title":{"type":"string","example":"London, United Kingdom","description":"Full title of the location"}},"required":["id","name","title"]}},"components/schemas/ListLocationsResponse":{"id":"components/schemas/ListLocationsResponse","kind":"json-schema","title":"ListLocationsResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"locations":{"type":"array","items":{"$ref":"#/components/schemas/Location"}},"total":{"type":"number","example":8477,"description":"Total number of locations"}},"required":["locations","total"]}},"components/schemas/UserInfluencer":{"id":"components/schemas/UserInfluencer","kind":"json-schema","title":"UserInfluencer","data":{"type":"object","properties":{"userId":{"type":"string","example":"232192182","description":"User Id"},"username":{"type":"string","example":"therock","description":"Username"},"fullname":{"type":"string","example":"therock","description":"User's full name"},"picture":{"type":"string","example":"https://imgigp.modash.io/v2?mb0KwpL92uYofJiSjDn1%2F6peL1lBwv3s%2BUvShHERlDbrEEwrWumIvR20xZeZXa0LDeIrcniqZeG9S%2F1a5s2Rx3FZdXrWpY%2BmSBJp1l%2FmBGon3rcHA4EfuatZqMhVBzAT","description":"User's profile image URL"},"followers":{"type":"number","example":313583625,"description":"User's number of followers"},"isVerified":{"type":"boolean","example":true,"description":"User has verified badge"}},"required":["userId","username","fullname","picture","followers","isVerified"]}},"components/schemas/ListUsersResponse":{"id":"components/schemas/ListUsersResponse","kind":"json-schema","title":"ListUsersResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserInfluencer"}}},"required":["users"]}},"components/schemas/TikTokSort":{"id":"components/schemas/TikTokSort","kind":"json-schema","title":"TikTokSort","data":{"type":"object","properties":{"field":{"type":"string","example":"followers","default":"followers","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The following sort options are available only when the corresponding filter is applied: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceLang"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGender"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceAge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"followersGrowth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"likesGrowth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sorting field in which order you want to get the results."},"children":[]}]}]}],"enum":["engagements","followers","engagementRate","keywords","audienceGeo","audienceLang","audienceGender","audienceAge","audienceRelevance","relevance","followersGrowth","views","shares","saves","likesGrowth"]},"value":{"type":"number","example":123,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorting."},"children":[]}]}]}]},"direction":{"type":"string","example":"desc","default":"desc","description":"Sorting direction","enum":["asc","desc"]}},"required":["field"]}},"components/schemas/ViewsCount":{"id":"components/schemas/ViewsCount","kind":"json-schema","title":"ViewsCount","data":{"type":"object","properties":{"min":{"type":"number","example":5000,"description":"Minimum views count."},"max":{"type":"number","example":10000,"description":"Maximum views count."}}}},"components/schemas/SharesCount":{"id":"components/schemas/SharesCount","kind":"json-schema","title":"SharesCount","data":{"type":"object","properties":{"min":{"type":"number","example":5000,"description":"Minimum shares count (this value will be rounded)."},"max":{"type":"number","example":10000,"description":"Maximum shares count (this value will be rounded)."}}}},"components/schemas/SavesCount":{"id":"components/schemas/SavesCount","kind":"json-schema","title":"SavesCount","data":{"type":"object","properties":{"min":{"type":"number","example":5000,"description":"Minimum saves count (this value will be rounded)."},"max":{"type":"number","example":10000,"description":"Maximum saves count (this value will be rounded)."}}}},"components/schemas/TikTokFilterOperations":{"id":"components/schemas/TikTokFilterOperations","kind":"json-schema","title":"TikTokFilterOperations","data":{"type":"object","properties":{"operator":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Logical operations used to combine filters."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: To use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator, you must apply it to at least two filters."},"children":[]}]}]}]}],"enum":["and","or","not"]},"filter":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter to apply the operation on. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relevance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are specified then you can not sort by these fields."},"children":[]}]}]}],"enum":["followers","engagements","engagementRate","lastposted","bio","keywords","relevance","language","gender","age","location","isVerified","views","textTags"]}},"required":["operator","filter"]}},"components/schemas/TikTokSearchInfluencerFilters":{"id":"components/schemas/TikTokSearchInfluencerFilters","kind":"json-schema","title":"TikTokSearchInfluencerFilters","data":{"type":"object","properties":{"followers":{"example":{"min":20000,"max":70000},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We round followers value in the filter: whenever it's below 5k, we round it to the nearest thousand (4123 -> 4000; 4800-> 5000); when it's over 5k, we round it to the nearest 5,000 (27k -> 25k; 28k -> 30k)."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/FollowersCount"}]},"engagementRate":{"type":"number","description":"Minimum engagement rate.","maximum":1,"minimum":0,"example":0.02},"location":{"example":[148838,62149,80500,1428125,304716],"description":"Filter by Influencer Location, You can get the locations with our locations api end point and send location ids in an array.","maxItems":20,"type":"array","items":{"type":"number"}},"language":{"type":"string","example":"en","description":"Filter by Influencer Language, You can get the languages code with our languages api end point.","minLength":1,"maxLength":3},"lastposted":{"type":"number","example":90,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idenitfy influencers based on when they last posted. The number represents days and should be >= 30."},"children":[]}]}]}],"minimum":30},"relevance":{"example":["#cars","@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by topic of influencers posts or by similarity of topic to other influencer. For example \"#cars #audi @topgear\" means \"Writing about #cars and #audi, has similar topic as @topgear account.\" "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can only enter 100 usernames."},"children":[]}]}]}]}],"type":"array","items":{"type":"string"}},"audienceRelevance":{"example":["@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by similarity of influencer's audience to another influencer's audience. For example \"@topgear\" means \"Has audience similar to @topgear account.\" Audience similarity means followers follow accounts with the same topics as those followed by @topgear's audience."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"gender":{"type":"string","example":"MALE","description":"Filter by Influencer gender.","enum":["MALE","FEMALE","KNOWN","UNKNOWN"]},"age":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Influencer age, possible values are: 18, 25, 35, 45, 65. You have the option to utilize either the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, or both concurrently. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any number that falls outside the accepted range will be disregarded."},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/InfluencerAgeRange"}]},"followersGrowthRate":{"description":"Growth rate by followers over a period of time.","example":{"interval":"i6months","value":0.01,"operator":"gt"},"allOf":[{"$ref":"#/components/schemas/GrowthFilter"}]},"bio":{"type":"string","example":"photos videos","description":"Search influencer by their bio description and/or full name"},"hasAudienceData":{"type":"boolean","description":"Filter by whether the influencer has audience data available. If true, shows only accounts with audience data. If false, shows all accounts including those without audience data. If not specified, defaults to true."},"views":{"description":"Filter by views count","allOf":[{"$ref":"#/components/schemas/ViewsCount"}]},"hasContactDetails":{"description":"If Influencer has contact details.","type":"array","items":{"$ref":"#/components/schemas/ContactFilter"}},"textTags":{"example":[{"type":"hashtag","value":"carsofinstagram"},{"type":"mention","value":"topgear"}],"maxItems":20,"description":"Filter by influencers who have used the defined hashtags or mentions in their posts. ","type":"array","items":{"$ref":"#/components/schemas/TextTag"}},"keywords":{"type":"string","description":"Identify influencers by a phrase they use within the caption of their post.","example":"cars"},"isVerified":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter by verified influencers."},"children":[]}]}]}]},"likesGrowthRate":{"description":"Growth rate by total likes over a period of time.","example":{"interval":"i1month","value":0.2,"operator":"gt"},"allOf":[{"$ref":"#/components/schemas/GrowthFilter"}]},"shares":{"description":"Filter by shares count","allOf":[{"$ref":"#/components/schemas/SharesCount"}]},"saves":{"description":"Filter by saves count","allOf":[{"$ref":"#/components/schemas/SavesCount"}]},"engagements":{"description":"Filter by engagements count","allOf":[{"$ref":"#/components/schemas/EngagementsCount"}]},"filterOperations":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Modify filter operation to use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Example: Search for "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"influencer using the keyword "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cars"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" AND "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the London"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Female "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" interested in Beauty & Cosmetics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If no operator is specified, the default operator applied is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator."},"children":[]}]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/TikTokFilterOperations"}}}}},"components/schemas/TikTokSearchAudienceFilters":{"id":"components/schemas/TikTokSearchAudienceFilters","kind":"json-schema","title":"TikTokSearchAudienceFilters","data":{"type":"object","properties":{"location":{"example":[{"id":148838,"weight":0.2},{"id":62149,"weight":0.2},{"id":80500,"weight":0.2},{"id":1428125,"weight":0.2},{"id":304716,"weight":0.2}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Location, You can get the locations with our locations api end point and send location ids in an array together with their weight percentages. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/LocationWeightedFilter"}},"language":{"example":{"id":"en","weight":0.2},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Language, You can get the languages code with our languages api end point and send the location id within an object, together with the weight percentage. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/LanguageWeightedFilter"}]},"gender":{"example":{"id":"MALE","weight":0.5},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by gender specific Audience, You can send the gender together with the weight percentage. The default percentage is set to 50% (0.5)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/GenderWeightedFilter"}]},"age":{"example":[{"id":"18-24","weight":0.3},{"id":"65-","weight":0.3}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience age. You can send the age together with the weight percentage. The default percentage is set to 30% (0.3)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/AgeWeightedFilter"}},"ageRange":{"example":{"min":"18","max":"24","weight":0.3},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by audience age range. You can send the age range together with the weight percentage. The default percentage is set to 30% (0.3). You can't send both age and ageRange together."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/AudienceAgeRange"}]}}}},"components/schemas/TikTokSearchFilters":{"id":"components/schemas/TikTokSearchFilters","kind":"json-schema","title":"TikTokSearchFilters","data":{"type":"object","properties":{"influencer":{"$ref":"#/components/schemas/TikTokSearchInfluencerFilters"},"audience":{"$ref":"#/components/schemas/TikTokSearchAudienceFilters"}}}},"components/schemas/TikTokSearchBody":{"id":"components/schemas/TikTokSearchBody","kind":"json-schema","title":"TikTokSearchBody","data":{"type":"object","properties":{"page":{"type":"number","description":"Page number","default":0,"minimum":0,"maximum":665},"calculationMethod":{"type":"string","example":"median","default":"median","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc.","enum":["median","average"]},"sort":{"description":"Sorting","example":{"field":"followers","direction":"desc"},"allOf":[{"$ref":"#/components/schemas/TikTokSort"}]},"filter":{"example":{"influencer":{"followers":{"min":20000},"engagementRate":0.02,"location":[148838,62149,80500,1428125,304716],"language":"en","lastposted":90,"gender":"MALE","followersGrowthRate":{"interval":"i6months","value":0.01,"operator":"gt"},"views":{"min":5000,"max":10000},"hasContactDetails":[{"contactType":"email","filterAction":"must"}],"likesGrowthRate":{"interval":"i1month","value":0.2,"operator":"gt"},"filterOperations":[{"operator":"and","filter":"followers"}]},"audience":{"location":[{"id":148838,"weight":0.2},{"id":62149,"weight":0.2},{"id":80500,"weight":0.2},{"id":1428125,"weight":0.2},{"id":304716,"weight":0.2}],"language":{"id":"en","weight":0.2},"gender":{"id":"MALE","weight":0.3},"age":[{"id":"18-24","weight":0.3},{"id":"65-","weight":0.3}]}},"allOf":[{"$ref":"#/components/schemas/TikTokSearchFilters"}]}}}},"components/schemas/TiktokProfileResponse":{"id":"components/schemas/TiktokProfileResponse","kind":"json-schema","title":"TiktokProfileResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"url":{"type":"string","description":"Profile URL","example":"https://www.instagram.com/instagram/"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994},"engagementRate":{"type":"number","description":"Engagement rate","example":0.0027362938100525414},"averageViews":{"type":"number","example":98124}},"required":["username","url","picture","followers","engagements","engagementRate","averageViews"]}},"components/schemas/TikTokReportAudience":{"id":"components/schemas/TikTokReportAudience","kind":"json-schema","title":"TikTokReportAudience","data":{"type":"object","properties":{"notable":{"type":"number","example":0.07},"genders":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"geoCountries":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCodeName"}},"ages":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"gendersPerAge":{"type":"array","items":{"$ref":"#/components/schemas/GenderPerAge"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/AudienceLanguage"}},"notableUsers":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceLookalikes":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceReachability":{"description":"Percentage of the audience based on the number of accounts they follow, categorized into specific ranges. For instance, percentage of followers following no more than 500 accounts, or following between 500 and 1000 accounts.","example":[{"code":"-500","weight":0.379536},{"code":"500-1000","weight":0.161691},{"code":"1000-1500","weight":0.097547},{"code":"1500-","weight":0.361225}],"type":"array","items":{"$ref":"#/components/schemas/AudienceReachability"}}},"required":["notable","genders","geoCountries","ages","gendersPerAge","languages","notableUsers","audienceLookalikes"]}},"components/schemas/ContentTypeStatsTiktok":{"id":"components/schemas/ContentTypeStatsTiktok","kind":"json-schema","title":"ContentTypeStatsTiktok","data":{"type":"object","properties":{"engagements":{"type":"number","example":0},"engagementRate":{"type":"number","example":0},"avgLikes":{"type":"number","example":0},"avgComments":{"type":"number","example":0},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/ContentTypeStatsHistory"}},"avgViews":{"type":"number","example":0},"avgShares":{"type":"number","example":0},"avgPosts4weeks":{"type":"number","example":0}}}},"components/schemas/StatsByContentTypeTiktok":{"id":"components/schemas/StatsByContentTypeTiktok","kind":"json-schema","title":"StatsByContentTypeTiktok","data":{"type":"object","properties":{"all":{"example":{},"description":"All content type stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsTiktok"}]}}}},"components/schemas/TikTokRecentPost":{"id":"components/schemas/TikTokRecentPost","kind":"json-schema","title":"TikTokRecentPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"video":{"type":"string"},"thumbnail":{"type":"string","deprecated":true,"example":"https://p16-amd-va.tiktokcdn.com/obj/tos-useast5-p-0068-tx/ogyxG5KtISdEAzSCEzZL4BA7BIij8pf5dwwBli","description":"Thumbnail images are sent as TikTok URLs that expire in a few hours and are not accessible in most cases. This field will be removed with the next API version."}},"required":["id","text","url","created","type","thumbnail"]}},"components/schemas/AudienceExtraReportData":{"id":"components/schemas/AudienceExtraReportData","kind":"json-schema","title":"AudienceExtraReportData","data":{"type":"object","properties":{"followersRange":{"description":"All histograms shown here are based on influencers whose number of followers fall within the range specified in this field","allOf":[{"$ref":"#/components/schemas/FollowersRange"}]},"engagementRateDistribution":{"description":"Distribution of influencers by their followers' engagement rate. This histogram displays how influencers from the same follower group are distributed based on the engagement rate of their followers. Ranges are automatically chosen for a clearer view of the entire histogram","type":"array","items":{"$ref":"#/components/schemas/HistogramBin"}}},"required":["followersRange","engagementRateDistribution"]}},"components/schemas/TiktokSponsoredPost":{"id":"components/schemas/TiktokSponsoredPost","kind":"json-schema","title":"TiktokSponsoredPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"video":{"type":"string"},"thumbnail":{"type":"string"},"title":{"type":"string"},"sponsors":{"type":"array","items":{"$ref":"#/components/schemas/PostSponsor"}}},"required":["id","text","url","created","type","thumbnail","title"]}},"components/schemas/TikTokReportProfile":{"id":"components/schemas/TikTokReportProfile","kind":"json-schema","title":"TikTokReportProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User Id","example":"173560420"},"profile":{"description":"Influencer Profile","allOf":[{"$ref":"#/components/schemas/TiktokProfileResponse"}]},"audience":{"description":"Audience data","allOf":[{"$ref":"#/components/schemas/TikTokReportAudience"}]},"secUid":{"type":"string"},"statsByContentType":{"description":"User stats separated by content type","allOf":[{"$ref":"#/components/schemas/StatsByContentTypeTiktok"}]},"recentPosts":{"description":"Recent Posts","type":"array","items":{"$ref":"#/components/schemas/TikTokRecentPost"}},"popularPosts":{"description":"Popular Posts","type":"array","items":{"$ref":"#/components/schemas/TikTokRecentPost"}},"city":{"type":"string","example":"New york"},"state":{"type":"string","example":"California"},"gender":{"type":"string","example":"FEMALE","enum":["MALE","FEMALE"]},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/MonthlyStat"}},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contacts"}},"country":{"type":"string","example":"US"},"ageGroup":{"type":"string","example":"18-24","enum":["18-24","25-34","35-44","45-64","65-"]},"isPrivate":{"type":"boolean","example":true},"isVerified":{"type":"boolean","example":true},"postsCount":{"type":"number","example":37},"avgLikes":{"type":"number","example":18211},"totalLikes":{"type":"number","example":182211},"avgComments":{"type":"number","example":12321},"bio":{"type":"string","example":"CEO of #RockTok"},"interests":{"type":"array","items":{"$ref":"#/components/schemas/Interest"}},"lookalikes":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceExtra":{"$ref":"#/components/schemas/AudienceExtraReportData"},"sponsoredPosts":{"type":"array","items":{"$ref":"#/components/schemas/TiktokSponsoredPost"}},"paidPostPerformance":{"type":"number","example":0.5},"paidPostPerformanceViews":{"type":"number","example":37},"sponsoredPostsMedianViews":{"type":"number","example":3127},"sponsoredPostsMedianLikes":{"type":"number","example":3743},"nonSponsoredPostsMedianViews":{"type":"number","example":267},"nonSponsoredPostsMedianLikes":{"type":"number","example":367}},"required":["userId","secUid","statHistory","isPrivate","isVerified","postsCount","avgLikes","totalLikes","avgComments","bio","interests","lookalikes","sponsoredPosts","paidPostPerformanceViews","sponsoredPostsMedianViews","sponsoredPostsMedianLikes","nonSponsoredPostsMedianViews","nonSponsoredPostsMedianLikes"]}},"components/schemas/TikTokReport":{"id":"components/schemas/TikTokReport","kind":"json-schema","title":"TikTokReport","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"profile":{"$ref":"#/components/schemas/TikTokReportProfile"}},"required":["profile"]}},"components/schemas/YoutubeSort":{"id":"components/schemas/YoutubeSort","kind":"json-schema","title":"YoutubeSort","data":{"type":"object","properties":{"field":{"type":"string","example":"followers","default":"followers","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The following sort options are available only when the corresponding filter is applied: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceLang"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGender"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceAge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"followersGrowth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"viewsGrowth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sorting field in which order you want to get the results."},"children":[]}]}]}],"enum":["engagements","followers","engagementRate","keywords","audienceGeo","audienceLang","audienceGender","audienceAge","audienceRelevance","relevance","followersGrowth","views","viewsGrowth"]},"value":{"type":"number","example":123,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"audienceGeo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorting."},"children":[]}]}]}]},"direction":{"type":"string","example":"desc","default":"desc","description":"Sorting direction","enum":["asc","desc"]}},"required":["field"]}},"components/schemas/YoutubeFilterOperations":{"id":"components/schemas/YoutubeFilterOperations","kind":"json-schema","title":"YoutubeFilterOperations","data":{"type":"object","properties":{"operator":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Logical operations used to combine filters."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: To use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator, you must apply it to at least two filters."},"children":[]}]}]}]}],"enum":["and","or","not"]},"filter":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter to apply the operation on. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keywords"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"relevance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are specified then you can not sort by these fields."},"children":[]}]}]}],"enum":["followers","engagements","engagementRate","lastposted","bio","keywords","relevance","language","gender","age","location","isVerified","isOfficialArtist","views"]}},"required":["operator","filter"]}},"components/schemas/YouTubeSearchInfluencerFilters":{"id":"components/schemas/YouTubeSearchInfluencerFilters","kind":"json-schema","title":"YouTubeSearchInfluencerFilters","data":{"type":"object","properties":{"followers":{"example":{"min":20000,"max":70000},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We round followers value in the filter: whenever it's below 5k, we round it to the nearest thousand (4123 -> 4000; 4800-> 5000); when it's over 5k, we round it to the nearest 5,000 (27k -> 25k; 28k -> 30k)."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/FollowersCount"}]},"engagementRate":{"type":"number","description":"Minimum engagement rate.","maximum":1,"minimum":0,"example":0.02},"location":{"example":[148838,62149,80500,1428125,304716],"description":"Filter by Influencer Location, You can get the locations with our locations api end point and send location ids in an array.","maxItems":20,"type":"array","items":{"type":"number"}},"language":{"type":"string","example":"en","description":"Filter by Influencer Language, You can get the languages code with our languages api end point.","minLength":1,"maxLength":3},"lastposted":{"type":"number","example":90,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idenitfy influencers based on when they last posted. The number represents days and should be >= 30."},"children":[]}]}]}],"minimum":30},"relevance":{"example":["#cars","@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by topic of influencers posts or by similarity of topic to other influencer. For example \"#cars #audi @topgear\" means \"Writing about #cars and #audi, has similar topic as @topgear account.\" "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can only enter 100 usernames."},"children":[]}]}]}]}],"type":"array","items":{"type":"string"}},"audienceRelevance":{"example":["@topgear"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by similarity of influencer's audience to another influencer's audience. For example \"@topgear\" means \"Has audience similar to @topgear account.\" Audience similarity means followers follow accounts with the same topics as those followed by @topgear's audience."},"children":[]}]}]}],"type":"array","items":{"type":"string"}},"gender":{"type":"string","example":"MALE","description":"Filter by Influencer gender.","enum":["MALE","FEMALE","KNOWN","UNKNOWN"]},"age":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Influencer age, possible values are: 18, 25, 35, 45, 65. You have the option to utilize either the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, or both concurrently. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"strong","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any number that falls outside the accepted range will be disregarded."},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/InfluencerAgeRange"}]},"followersGrowthRate":{"description":"Growth rate by followers over a period of time.","example":{"interval":"i6months","value":0.01,"operator":"gt"},"allOf":[{"$ref":"#/components/schemas/GrowthFilter"}]},"bio":{"type":"string","example":"photos videos","description":"Search influencer by their bio description and/or full name"},"hasAudienceData":{"type":"boolean","description":"Filter by whether the influencer has audience data available. If true, shows only accounts with audience data. If false, shows all accounts including those without audience data. If not specified, defaults to true."},"views":{"description":"Filter by average views.","allOf":[{"$ref":"#/components/schemas/ViewsCount"}]},"hasContactDetails":{"description":"If Influencer has contact details.","type":"array","items":{"$ref":"#/components/schemas/ContactFilter"}},"keywords":{"type":"string","description":"Identify influencers by a phrase they use when speaking in their videos.","example":"cats"},"isVerified":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter by verified influencers."},"children":[]}]}]}]},"isOfficialArtist":{"type":"boolean","description":"Filter by isOfficialArtist."},"viewsGrowthRate":{"description":"Growth rate by total views over a period of time.","example":{"interval":"i1month","value":0.2,"operator":"gt"},"allOf":[{"$ref":"#/components/schemas/GrowthFilter"}]},"engagements":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by engagements count. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pro tip: set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to 0 if you want to see results with hidden likes."},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/EngagementsCount"}]},"filterOperations":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Modify filter operation to use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Example: Search for "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"influencer using the keyword "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cars"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" AND "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"not"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the London"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Female "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"or"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" interested in Beauty & Cosmetics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"i","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If no operator is specified, the default operator applied is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator."},"children":[]}]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/YoutubeFilterOperations"}}}}},"components/schemas/YouTubeSearchAudienceFilters":{"id":"components/schemas/YouTubeSearchAudienceFilters","kind":"json-schema","title":"YouTubeSearchAudienceFilters","data":{"type":"object","properties":{"location":{"example":[{"id":148838,"weight":0.2},{"id":62149,"weight":0.2},{"id":80500,"weight":0.2},{"id":1428125,"weight":0.2},{"id":304716,"weight":0.2}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Location, You can get the locations with our locations api end point and send location ids in an array together with their weight percentages. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/LocationWeightedFilter"}},"language":{"example":{"id":"en","weight":0.2},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Language, You can get the languages code with our languages api end point and send the location id within an object, together with the weight percentage. The default percentage is set to 20% (0.2)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/LanguageWeightedFilter"}]},"gender":{"example":{"id":"MALE","weight":0.5},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by gender specific Audience, You can send the gender together with the weight percentage. The default percentage is set to 50% (0.5)"},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/GenderWeightedFilter"}]},"age":{"example":[{"id":"18-24","weight":0.3},{"id":"65-","weight":0.3}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience age. You can send the age together with the weight percentage. The default percentage is set to 30% (0.3)"},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/AgeWeightedFilter"}},"ageRange":{"example":{"min":"18","max":"24","weight":0.3},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by audience age range. You can send the age range together with the weight percentage. The default percentage is set to 30% (0.3). You can't send both age and ageRange together."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/AudienceAgeRange"}]}}}},"components/schemas/YouTubeSearchFilters":{"id":"components/schemas/YouTubeSearchFilters","kind":"json-schema","title":"YouTubeSearchFilters","data":{"type":"object","properties":{"influencer":{"$ref":"#/components/schemas/YouTubeSearchInfluencerFilters"},"audience":{"$ref":"#/components/schemas/YouTubeSearchAudienceFilters"}}}},"components/schemas/YouTubeSearchBody":{"id":"components/schemas/YouTubeSearchBody","kind":"json-schema","title":"YouTubeSearchBody","data":{"type":"object","properties":{"page":{"type":"number","description":"Page number","default":0,"minimum":0,"maximum":665},"calculationMethod":{"type":"string","example":"median","default":"median","description":"If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc.","enum":["median","average"]},"sort":{"description":"Sorting","example":{"field":"followers","direction":"desc"},"allOf":[{"$ref":"#/components/schemas/YoutubeSort"}]},"filter":{"example":{"audience":{"location":[{"weight":0.2,"id":148838}]},"influencer":{"relevance":["#beauty_tips","#beauty_hacks","#beauty_products","#beauty_of_nature","#beautytips","#beauty_haul","#beauty_secrets","#beauty_vlogger"],"location":[148838],"gender":"FEMALE","age":{"min":25,"max":45},"engagementRate":0.02}},"allOf":[{"$ref":"#/components/schemas/YouTubeSearchFilters"}]}}}},"components/schemas/YoutubeProfileResponse":{"id":"components/schemas/YoutubeProfileResponse","kind":"json-schema","title":"YoutubeProfileResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"url":{"type":"string","description":"Profile URL","example":"https://www.instagram.com/instagram/"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994},"engagementRate":{"type":"number","description":"Engagement rate","example":0.0027362938100525414},"averageViews":{"type":"number","example":98124},"handle":{"type":"string","example":"tseries","description":"Unique and short YouTube channel identifier"}},"required":["username","url","picture","followers","engagements","engagementRate","averageViews"]}},"components/schemas/YoutubeInfluencerResponse":{"id":"components/schemas/YoutubeInfluencerResponse","kind":"json-schema","title":"YoutubeInfluencerResponse","data":{"type":"object","properties":{"userId":{"type":"string","description":"User Id","example":"173560420"},"profile":{"description":"Profile info of influencer","allOf":[{"$ref":"#/components/schemas/YoutubeProfileResponse"}]}},"required":["userId","profile"]}},"components/schemas/YoutubeSearchResponse":{"id":"components/schemas/YoutubeSearchResponse","kind":"json-schema","title":"YoutubeSearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Number of results","example":2},"lookalikes":{"description":"Lookalikes","type":"array","items":{"$ref":"#/components/schemas/YoutubeInfluencerResponse"}},"directs":{"description":"Directs","type":"array","items":{"$ref":"#/components/schemas/YoutubeInfluencerResponse"}},"isExactMatch":{"type":"boolean","description":"Are the results exactly matching the filters you provided? If we don't find exact results then we try to show similar users by automatically removing some filters for you.","example":true}},"required":["total","lookalikes","directs","isExactMatch"]}},"components/schemas/YoutubeReportAudience":{"id":"components/schemas/YoutubeReportAudience","kind":"json-schema","title":"YoutubeReportAudience","data":{"type":"object","properties":{"notable":{"type":"number","example":0.07},"genders":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"geoCountries":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCodeName"}},"ages":{"type":"array","items":{"$ref":"#/components/schemas/WeightWithCode"}},"gendersPerAge":{"type":"array","items":{"$ref":"#/components/schemas/GenderPerAge"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/AudienceLanguage"}},"notableUsers":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceLookalikes":{"type":"array","items":{"$ref":"#/components/schemas/User"}}},"required":["notable","genders","geoCountries","ages","gendersPerAge","languages","notableUsers","audienceLookalikes"]}},"components/schemas/ContentTypeStatsYoutube":{"id":"components/schemas/ContentTypeStatsYoutube","kind":"json-schema","title":"ContentTypeStatsYoutube","data":{"type":"object","properties":{"engagements":{"type":"number","example":0},"engagementRate":{"type":"number","example":0},"avgLikes":{"type":"number","example":0},"avgComments":{"type":"number","example":0},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/ContentTypeStatsHistory"}},"avgViews":{"type":"number","example":0},"avgPosts4weeks":{"type":"number","example":0}}}},"components/schemas/StatsByContentTypeYoutube":{"id":"components/schemas/StatsByContentTypeYoutube","kind":"json-schema","title":"StatsByContentTypeYoutube","data":{"type":"object","properties":{"all":{"example":{},"description":"All content type stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsYoutube"}]},"videos":{"example":{},"description":"Videos stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsYoutube"}]},"shorts":{"example":{},"description":"Shorts stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsYoutube"}]},"streams":{"example":{},"description":"Streams stats","allOf":[{"$ref":"#/components/schemas/ContentTypeStatsYoutube"}]}}}},"components/schemas/YoutubeRecentPost":{"id":"components/schemas/YoutubeRecentPost","kind":"json-schema","title":"YoutubeRecentPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"video":{"type":"string"},"thumbnail":{"type":"string"},"title":{"type":"string"}},"required":["id","text","url","created","type","thumbnail","title"]}},"components/schemas/YoutubeSponsoredPost":{"id":"components/schemas/YoutubeSponsoredPost","kind":"json-schema","title":"YoutubeSponsoredPost","data":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"},"created":{"type":"string"},"likes":{"type":"number"},"comments":{"type":"number"},"views":{"type":"number"},"type":{"type":"string"},"video":{"type":"string"},"thumbnail":{"type":"string"},"title":{"type":"string"},"sponsors":{"type":"array","items":{"$ref":"#/components/schemas/PostSponsor"}}},"required":["id","text","url","created","type","thumbnail","title"]}},"components/schemas/YouTubeReportProfile":{"id":"components/schemas/YouTubeReportProfile","kind":"json-schema","title":"YouTubeReportProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User Id","example":"173560420"},"profile":{"description":"Influencer Profile","allOf":[{"$ref":"#/components/schemas/YoutubeProfileResponse"}]},"audience":{"description":"Audience data","allOf":[{"$ref":"#/components/schemas/YoutubeReportAudience"}]},"statsByContentType":{"description":"User stats separated by content type","allOf":[{"$ref":"#/components/schemas/StatsByContentTypeYoutube"}]},"recentPosts":{"description":"Recent Posts","type":"array","items":{"$ref":"#/components/schemas/YoutubeRecentPost"}},"popularPosts":{"description":"Popular Posts","type":"array","items":{"$ref":"#/components/schemas/YoutubeRecentPost"}},"city":{"type":"string","example":"New york"},"state":{"type":"string","example":"California"},"gender":{"type":"string","example":"FEMALE","enum":["MALE","FEMALE"]},"statHistory":{"type":"array","items":{"$ref":"#/components/schemas/MonthlyStat"}},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contacts"}},"country":{"type":"string","example":"US"},"ageGroup":{"type":"string","example":"18-24","enum":["18-24","25-34","35-44","45-64","65-"]},"isVerified":{"type":"boolean","example":true},"postsCount":{"type":"number","example":37},"avgLikes":{"type":"number","example":18211},"totalViews":{"type":"number","example":1821211},"avgComments":{"type":"number","example":12321},"description":{"type":"string","example":"CEO of #RockTok"},"interests":{"type":"array","items":{"$ref":"#/components/schemas/Interest"}},"audienceCommenters":{"$ref":"#/components/schemas/YoutubeReportAudience"},"lookalikesByTopics":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"audienceExtra":{"$ref":"#/components/schemas/AudienceExtraReportData"},"sponsoredPosts":{"type":"array","items":{"$ref":"#/components/schemas/YoutubeSponsoredPost"}},"paidPostPerformance":{"type":"number","example":0.5},"paidPostPerformanceViews":{"type":"number","example":37},"sponsoredPostsMedianViews":{"type":"number","example":3127},"sponsoredPostsMedianLikes":{"type":"number","example":3743},"nonSponsoredPostsMedianViews":{"type":"number","example":267},"nonSponsoredPostsMedianLikes":{"type":"number","example":367}},"required":["userId","statHistory","postsCount","avgLikes","totalViews","avgComments","description","interests","audienceCommenters","lookalikesByTopics","sponsoredPosts","paidPostPerformanceViews","sponsoredPostsMedianViews","sponsoredPostsMedianLikes","nonSponsoredPostsMedianViews","nonSponsoredPostsMedianLikes"]}},"components/schemas/YouTubeReport":{"id":"components/schemas/YouTubeReport","kind":"json-schema","title":"YouTubeReport","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"profile":{"$ref":"#/components/schemas/YouTubeReportProfile"}},"required":["profile"]}},"components/schemas/YoutubeUserInfluencer":{"id":"components/schemas/YoutubeUserInfluencer","kind":"json-schema","title":"YoutubeUserInfluencer","data":{"type":"object","properties":{"userId":{"type":"string","example":"232192182","description":"User Id"},"username":{"type":"string","example":"therock","description":"Username"},"fullname":{"type":"string","example":"therock","description":"User's full name"},"picture":{"type":"string","example":"https://imgigp.modash.io/v2?mb0KwpL92uYofJiSjDn1%2F6peL1lBwv3s%2BUvShHERlDbrEEwrWumIvR20xZeZXa0LDeIrcniqZeG9S%2F1a5s2Rx3FZdXrWpY%2BmSBJp1l%2FmBGon3rcHA4EfuatZqMhVBzAT","description":"User's profile image URL"},"followers":{"type":"number","example":313583625,"description":"User's number of followers"},"isVerified":{"type":"boolean","example":true,"description":"User has verified badge"},"handle":{"type":"string","example":"tseries","description":"Unique and short YouTube channel identifier"}},"required":["userId","username","fullname","picture","followers","isVerified"]}},"components/schemas/YoutubeListUsersResponse":{"id":"components/schemas/YoutubeListUsersResponse","kind":"json-schema","title":"YoutubeListUsersResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"users":{"type":"array","items":{"$ref":"#/components/schemas/YoutubeUserInfluencer"}}},"required":["users"]}},"components/schemas/EmailsSearchBody":{"id":"components/schemas/EmailsSearchBody","kind":"json-schema","title":"EmailsSearchBody","data":{"type":"object","properties":{"emails":{"description":"List of emails to search","minItems":1,"maxItems":1000,"example":["hello@modash.io","non-existent@modash.io"],"type":"array","items":{"type":"string"}}},"required":["emails"]}},"components/schemas/MatchedEmailUser":{"id":"components/schemas/MatchedEmailUser","kind":"json-schema","title":"MatchedEmailUser","data":{"type":"object","properties":{"platform":{"type":"string","description":"Platform","example":"instagram"},"userId":{"type":"string","description":"User id of the influencer","example":"173560420"},"url":{"type":"string","description":"URL of Influencer","example":"https://www.instagram.com/instagram/"},"username":{"type":"string","description":"Username of Influencer","example":"instagram"},"fullname":{"type":"string","description":"Full name of Influencer","example":"Instagram"},"picture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/3232323.jpg"},"followers":{"type":"number","description":"Follower count","example":313560626},"engagements":{"type":"number","description":"Engagements","example":857994},"engagementRate":{"type":"number","description":"Engagement rate","example":0.0027362938100525414},"isVerified":{"type":"boolean","description":"Is verified","example":true}},"required":["platform","url","username","picture","followers","engagements","engagementRate","isVerified"]}},"components/schemas/MatchedEmail":{"id":"components/schemas/MatchedEmail","kind":"json-schema","title":"MatchedEmail","data":{"type":"object","properties":{"email":{"type":"string","description":"Email address","example":"example@modash.io"},"users":{"description":"User details","type":"array","items":{"$ref":"#/components/schemas/MatchedEmailUser"}}},"required":["email","users"]}},"components/schemas/EmailsSearchResponse":{"id":"components/schemas/EmailsSearchResponse","kind":"json-schema","title":"EmailsSearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"matchedEmails":{"description":"Matches by email","type":"array","items":{"$ref":"#/components/schemas/MatchedEmail"}},"notMatchedEmails":{"description":"Emails that were not matched","type":"array","items":{"type":"string"}},"totalMatches":{"type":"number","description":"Number of matched emails","example":1}},"required":["totalMatches"]}},"components/schemas/PostCreationTimestampMs":{"id":"components/schemas/PostCreationTimestampMs","kind":"json-schema","title":"PostCreationTimestampMs","data":{"type":"object","properties":{"gte":{"type":"number","description":"Filter posts by creation timestamp in milliseconds greater than or equal to this value"},"lte":{"type":"number","description":"Filter posts by creation timestamp in milliseconds less than or equal to this value"}}}},"components/schemas/CollaborationsPostsRequest":{"id":"components/schemas/CollaborationsPostsRequest","kind":"json-schema","title":"CollaborationsPostsRequest","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User ID / Username / Profile URL, User ID is preferred. For brand collaborations, you can also use the brand ID from "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in which case we will return collaborations for all accounts associated with the brand."},"children":[]}]}]}],"example":"cristiano"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"collaboratorId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If provided, only returns the collaboration posts between the specified influencer and brand. You can also use the brand ID from "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", if you want to get collaborations between influencer X (filtered by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") and all accounts associated with the brand Y (filtered by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"collaboratorId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"postCreationTimestampMs":{"description":"Filter the posts by creation timestamp in milliseconds","example":{"gte":1716835200000},"allOf":[{"$ref":"#/components/schemas/PostCreationTimestampMs"}]},"cursor":{"type":"string","description":"Cursor for pagination (only valid for 2 days)","example":""},"limit":{"type":"number","description":"Number of collaboration posts per page","minimum":1,"maximum":30,"default":30,"example":10},"groupBrandCollaborations":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If true, brand collaborations will be grouped across all platforms. This provides insights about the brand across all its social accounts."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example: if you request brand collaborations for @cocacola on Instagram, you will get posts sponsored by Coca Cola on all three platforms (Instagram, Tiktok and Youtube)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In some cases, this may group regional or variant accounts (e.g., @cocacola_uk, @cocacola_us) when they represent the same brand identity. Set this flag to false if social media account-specific insights are needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For better grouping, retrieve the brand ID from "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and use it instead of user ID of a specific social media account."},"children":[]}]}]}]}},"required":["id","platform"]}},"components/schemas/CollaborationsPostStats":{"id":"components/schemas/CollaborationsPostStats","kind":"json-schema","title":"CollaborationsPostStats","data":{"type":"object","properties":{"likes":{"type":"number","description":"Likes","example":123},"comments":{"type":"number","description":"Comments","example":12},"likes_and_views_counts_enabled":{"type":"boolean","description":"Likes and views counts enabled","example":true},"likes_count_enabled":{"type":"boolean","description":"Likes count enabled","example":true},"plays":{"type":"number","description":"Plays","example":123},"views":{"type":"number","description":"Views","example":123},"shares":{"type":"number","description":"Shares","example":123},"views_count_enabled":{"type":"boolean","description":"Views count enabled","example":true}}}},"components/schemas/CollaborationsSponsor":{"id":"components/schemas/CollaborationsSponsor","kind":"json-schema","title":"CollaborationsSponsor","data":{"type":"object","properties":{"name":{"type":"string","description":"Brand name","example":"Honda"},"username":{"type":"string","description":"Brand username","example":"honda"},"domain":{"type":"string","description":"Brand domain","example":"honda.com"},"logo_url":{"type":"string","description":"Brand logo","example":"https://images.od.modash.io/739b39affeb633d30a8a4280668605b091af0083"},"user_id":{"type":"string","description":"User ID or domain of the influencer","example":"1234567890"},"brand_id":{"type":"string","description":"User ID or domain of the sponsor"},"category":{"type":"string","description":"Brand category (if multiple categories are relevant, we return the most relevant one)","enum":["Consumer Packaged Goods (CPG)","Retail","B2B/Enterprise/Industrial","Classifieds & Local","Food Beverage Restaurants","Healthcare","Media & Entertainment","Technology","Education","Finance","Automotive","Travel","Others","Unknown"],"example":"Travel"}},"required":["category"]}},"components/schemas/CollaborationsPost":{"id":"components/schemas/CollaborationsPost","kind":"json-schema","title":"CollaborationsPost","data":{"type":"object","properties":{"post_id":{"type":"string","description":"Post id","example":"4333460164"},"post_thumbnail":{"type":"string","description":"Post thumbnail","example":"https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f"},"post_timestamp":{"type":"number","description":"Post timestamp","example":1729502216000},"title":{"type":"string","description":"Title","example":"Title"},"description":{"type":"string","description":"Description","example":"Description"},"label":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sponsorship category followed by the evidence. Possible categories: \t\t\t(1) Properly Disclosed Sponsorship - uses #ad, paid partnership flag, or explicitly indicates a partnership in text (e.g., \"I teamed up with X to...\"). \t\t\t(2) Likely Hidden Sponsorship - no clear disclosures, but other signals indicate a sponsorship (e.g., \"Use [CODE] for X% off\" or \"thanks @brand\"). \t\t\t(3) Unclear or Vague Sponsorship Hint - a mention/tag of a known sponsor, but without proper disclosures."},"children":[]}]}]}],"example":"Properly Disclosed Sponsorship: is paid partnership flag"},"collaboration_type":{"type":"string","description":"Type of collaboration (if multiple types are relevant, we return the most relevant one)","enum":["Paid","Gifted","Ambassador","Affiliate","Unspecified"],"example":"Paid"},"stats":{"description":"Stats","allOf":[{"$ref":"#/components/schemas/CollaborationsPostStats"}]},"sponsors":{"description":"Sponsors","type":"array","items":{"$ref":"#/components/schemas/CollaborationsSponsor"}}},"required":["post_id","label","collaboration_type"]}},"components/schemas/CollaborationsPostsInfluencer":{"id":"components/schemas/CollaborationsPostsInfluencer","kind":"json-schema","title":"CollaborationsPostsInfluencer","data":{"type":"object","properties":{"id":{"type":"string","description":"User ID / Username / Profile URL","example":"johndoe"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"is_more_available":{"type":"boolean","description":"True if there are more collaboration posts available"},"username":{"type":"string","description":"Username","example":"username"},"user_picture":{"type":"string","description":"Influencer user picture","example":"https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f"},"posts":{"description":"List of collaboration posts","type":"array","items":{"$ref":"#/components/schemas/CollaborationsPost"}}},"required":["id","platform"]}},"components/schemas/CollaborationsPostBrand":{"id":"components/schemas/CollaborationsPostBrand","kind":"json-schema","title":"CollaborationsPostBrand","data":{"type":"object","properties":{"post_id":{"type":"string","description":"Post id","example":"4333460164"},"post_thumbnail":{"type":"string","description":"Post thumbnail","example":"https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f"},"post_timestamp":{"type":"number","description":"Post timestamp","example":1729502216000},"title":{"type":"string","description":"Title","example":"Title"},"description":{"type":"string","description":"Description","example":"Description"},"label":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sponsorship category followed by the evidence. Possible categories: \t\t\t(1) Properly Disclosed Sponsorship - uses #ad, paid partnership flag, or explicitly indicates a partnership in text (e.g., \"I teamed up with X to...\"). \t\t\t(2) Likely Hidden Sponsorship - no clear disclosures, but other signals indicate a sponsorship (e.g., \"Use [CODE] for X% off\" or \"thanks @brand\"). \t\t\t(3) Unclear or Vague Sponsorship Hint - a mention/tag of a known sponsor, but without proper disclosures."},"children":[]}]}]}],"example":"Properly Disclosed Sponsorship: is paid partnership flag"},"collaboration_type":{"type":"string","description":"Type of collaboration (if multiple types are relevant, we return the most relevant one)","enum":["Paid","Gifted","Ambassador","Affiliate","Unspecified"],"example":"Paid"},"stats":{"description":"Stats","allOf":[{"$ref":"#/components/schemas/CollaborationsPostStats"}]},"sponsors":{"description":"Sponsors","type":"array","items":{"$ref":"#/components/schemas/CollaborationsSponsor"}},"user_id":{"type":"string","description":"User id","example":"173560420"},"username":{"type":"string","description":"Username","example":"username"},"platform":{"type":"string","description":"Platform","example":"instagram"}},"required":["post_id","label","collaboration_type"]}},"components/schemas/CollaborationsPostsBrand":{"id":"components/schemas/CollaborationsPostsBrand","kind":"json-schema","title":"CollaborationsPostsBrand","data":{"type":"object","properties":{"id":{"type":"string","description":"User ID / Username / Profile URL","example":"johndoe"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"is_more_available":{"type":"boolean","description":"True if there are more collaboration posts available"},"brand_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand identity hash. Multiple sponsor accounts that belong to the same brand share the same brand_id. Use the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with this value to retrieve all associated accounts."},"children":[]}]}]}]},"brand_name":{"type":"string","description":"Brand name"},"brand_domain":{"type":"string","description":"Brand domain"},"brand_logo":{"type":"string","description":"Brand logo"},"brand_category":{"type":"string","description":"Brand category (if multiple categories are relevant, we return the most relevant one)","enum":["Consumer Packaged Goods (CPG)","Retail","B2B/Enterprise/Industrial","Classifieds & Local","Food Beverage Restaurants","Healthcare","Media & Entertainment","Technology","Education","Finance","Automotive","Travel","Others","Unknown"],"example":"Travel"},"posts":{"description":"Posts","type":"array","items":{"$ref":"#/components/schemas/CollaborationsPostBrand"}}},"required":["id","platform","brand_category"]}},"components/schemas/CollaborationsPostsResponse":{"id":"components/schemas/CollaborationsPostsResponse","kind":"json-schema","title":"CollaborationsPostsResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"cursor":{"type":"string","description":"Cursor for pagination (only valid for 2 days)"},"influencer":{"description":"Only available if the requested profile has influencer collaborations","allOf":[{"$ref":"#/components/schemas/CollaborationsPostsInfluencer"}]},"brand":{"description":"Only available if the requested profile has brand collaborations","allOf":[{"$ref":"#/components/schemas/CollaborationsPostsBrand"}]}}}},"components/schemas/CollaborationsNotFoundResponse":{"id":"components/schemas/CollaborationsNotFoundResponse","kind":"json-schema","title":"CollaborationsNotFoundResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false}}}},"components/schemas/CollaborationsSummaryRequest":{"id":"components/schemas/CollaborationsSummaryRequest","kind":"json-schema","title":"CollaborationsSummaryRequest","data":{"type":"object","properties":{"id":{"type":"string","description":"User ID / Username / Profile URL, User ID is preferred. Note: We do not support brand ID in this endpoint yet.","example":"cristiano"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"collaboratorId":{"type":"string","description":"If provided, only returns the collaboration summary between the specified influencer and brand. For Youtube, if you want to extract collaborations summary with a specific brand, use the brand's domain name instead of the user ID.","example":""},"cursor":{"type":"string","description":"Cursor for pagination (only valid for 2 days)"},"limit":{"type":"number","description":"Number of collaboration summaries per page","minimum":1,"maximum":10,"default":10},"groupBrandCollaborations":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If true, brand collaborations summaries will be grouped across all platforms. This provides insights about the brand across all its social accounts."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example: if you request brand collaborations summary for @cocacola on Instagram, you will get collaboration summary for posts sponsored by Coca Cola on all three platforms (Instagram, Tiktok and Youtube)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: In some cases, this may group regional or variant accounts (e.g., @cocacola_uk, @cocacola_us) when they represent the same brand identity. Set this flag to false if social media account-specific insights are needed."},"children":[]}]}]}]}},"required":["id","platform"]}},"components/schemas/InstagramSummary":{"id":"components/schemas/InstagramSummary","kind":"json-schema","title":"InstagramSummary","data":{"type":"object","properties":{"total_distinct_posts":{"type":"number"},"total_collaborations":{"type":"number"},"total_plays":{"type":"number"},"total_views":{"type":"number"},"total_likes":{"type":"number"},"total_comments":{"type":"number"}}}},"components/schemas/InfluencerSummaryInstagram":{"id":"components/schemas/InfluencerSummaryInstagram","kind":"json-schema","title":"InfluencerSummaryInstagram","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"feed_photo":{"$ref":"#/components/schemas/InstagramSummary"},"feed_video":{"$ref":"#/components/schemas/InstagramSummary"},"reels_photo":{"$ref":"#/components/schemas/InstagramSummary"},"reels_video":{"$ref":"#/components/schemas/InstagramSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_brands":{"type":"number"}}}},"components/schemas/TiktokSummary":{"id":"components/schemas/TiktokSummary","kind":"json-schema","title":"TiktokSummary","data":{"type":"object","properties":{"total_distinct_posts":{"type":"number"},"total_collaborations":{"type":"number"},"total_likes":{"type":"number"},"total_comments":{"type":"number"},"total_views":{"type":"number"},"total_shares":{"type":"number"},"total_collects":{"type":"number"}}}},"components/schemas/InfluencerSummaryTiktok":{"id":"components/schemas/InfluencerSummaryTiktok","kind":"json-schema","title":"InfluencerSummaryTiktok","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"photo":{"$ref":"#/components/schemas/TiktokSummary"},"video":{"$ref":"#/components/schemas/TiktokSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_brands":{"type":"number"}}}},"components/schemas/YoutubeSummary":{"id":"components/schemas/YoutubeSummary","kind":"json-schema","title":"YoutubeSummary","data":{"type":"object","properties":{"total_distinct_posts":{"type":"number"},"total_collaborations":{"type":"number"},"total_likes":{"type":"number"},"total_comments":{"type":"number"},"total_views":{"type":"number"}}}},"components/schemas/InfluencerSummaryYoutube":{"id":"components/schemas/InfluencerSummaryYoutube","kind":"json-schema","title":"InfluencerSummaryYoutube","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"short":{"$ref":"#/components/schemas/YoutubeSummary"},"video":{"$ref":"#/components/schemas/YoutubeSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_brands":{"type":"number"}}}},"components/schemas/BaseInstagramSummary":{"id":"components/schemas/BaseInstagramSummary","kind":"json-schema","title":"BaseInstagramSummary","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"feed_photo":{"$ref":"#/components/schemas/InstagramSummary"},"feed_video":{"$ref":"#/components/schemas/InstagramSummary"},"reels_photo":{"$ref":"#/components/schemas/InstagramSummary"},"reels_video":{"$ref":"#/components/schemas/InstagramSummary"}}}},"components/schemas/BaseTiktokSummary":{"id":"components/schemas/BaseTiktokSummary","kind":"json-schema","title":"BaseTiktokSummary","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"photo":{"$ref":"#/components/schemas/TiktokSummary"},"video":{"$ref":"#/components/schemas/TiktokSummary"}}}},"components/schemas/BaseYoutubeSummary":{"id":"components/schemas/BaseYoutubeSummary","kind":"json-schema","title":"BaseYoutubeSummary","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"short":{"$ref":"#/components/schemas/YoutubeSummary"},"video":{"$ref":"#/components/schemas/YoutubeSummary"}}}},"components/schemas/InfluencerPerBrandSummary":{"id":"components/schemas/InfluencerPerBrandSummary","kind":"json-schema","title":"InfluencerPerBrandSummary","data":{"type":"object","properties":{"brand":{"description":"Brand data","allOf":[{"$ref":"#/components/schemas/CollaborationsSponsor"}]},"summary":{"oneOf":[{"$ref":"#/components/schemas/BaseInstagramSummary"},{"$ref":"#/components/schemas/BaseTiktokSummary"},{"$ref":"#/components/schemas/BaseYoutubeSummary"}],"description":"Performance summary for collaborations between the influencer and the brand"}},"required":["brand","summary"]}},"components/schemas/CollaborationsSummaryInfluencer":{"id":"components/schemas/CollaborationsSummaryInfluencer","kind":"json-schema","title":"CollaborationsSummaryInfluencer","data":{"type":"object","properties":{"id":{"type":"string","description":"User ID / Username / Profile URL","example":"johndoe"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"is_more_available":{"type":"boolean","description":"True if there are more per-brand / per-influencer collaboration summmaries available"},"summary":{"oneOf":[{"$ref":"#/components/schemas/InfluencerSummaryInstagram"},{"$ref":"#/components/schemas/InfluencerSummaryTiktok"},{"$ref":"#/components/schemas/InfluencerSummaryYoutube"}],"description":"Influencer collaboration summary for all brands"},"per_brand_summary":{"description":"Influencer summary for collaborations with specific brands","type":"array","items":{"$ref":"#/components/schemas/InfluencerPerBrandSummary"}}},"required":["id","platform","summary","per_brand_summary"]}},"components/schemas/BrandSummaryInstagram":{"id":"components/schemas/BrandSummaryInstagram","kind":"json-schema","title":"BrandSummaryInstagram","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"feed_photo":{"$ref":"#/components/schemas/InstagramSummary"},"feed_video":{"$ref":"#/components/schemas/InstagramSummary"},"reels_photo":{"$ref":"#/components/schemas/InstagramSummary"},"reels_video":{"$ref":"#/components/schemas/InstagramSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_influencers":{"type":"number"}}}},"components/schemas/BrandSummaryTiktok":{"id":"components/schemas/BrandSummaryTiktok","kind":"json-schema","title":"BrandSummaryTiktok","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"photo":{"$ref":"#/components/schemas/TiktokSummary"},"video":{"$ref":"#/components/schemas/TiktokSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_influencers":{"type":"number"}}}},"components/schemas/BrandSummaryYoutube":{"id":"components/schemas/BrandSummaryYoutube","kind":"json-schema","title":"BrandSummaryYoutube","data":{"type":"object","properties":{"total_collaborations":{"type":"number"},"first_collaboration_timestamp":{"type":"number"},"last_collaboration_timestamp":{"type":"number"},"short":{"$ref":"#/components/schemas/YoutubeSummary"},"video":{"$ref":"#/components/schemas/YoutubeSummary"},"total_distinct_posts":{"type":"number"},"total_distinct_influencers":{"type":"number"}}}},"components/schemas/CollaborationsInfluencer":{"id":"components/schemas/CollaborationsInfluencer","kind":"json-schema","title":"CollaborationsInfluencer","data":{"type":"object","properties":{"username":{"type":"string","description":"Influencer username"},"user_id":{"type":"string","description":"Influencer user ID"},"user_picture":{"type":"string","description":"Influencer user picture"}}}},"components/schemas/BrandPerInfluencerSummary":{"id":"components/schemas/BrandPerInfluencerSummary","kind":"json-schema","title":"BrandPerInfluencerSummary","data":{"type":"object","properties":{"influencer":{"description":"Influencer data","allOf":[{"$ref":"#/components/schemas/CollaborationsInfluencer"}]},"summary":{"oneOf":[{"$ref":"#/components/schemas/BaseInstagramSummary"},{"$ref":"#/components/schemas/BaseTiktokSummary"},{"$ref":"#/components/schemas/BaseYoutubeSummary"}],"description":"Performance summary for collaborations between the brand and the influencer"}},"required":["influencer","summary"]}},"components/schemas/CollaborationsSummaryBrand":{"id":"components/schemas/CollaborationsSummaryBrand","kind":"json-schema","title":"CollaborationsSummaryBrand","data":{"type":"object","properties":{"id":{"type":"string","description":"User ID / Username / Profile URL","example":"johndoe"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"is_more_available":{"type":"boolean","description":"True if there are more per-brand / per-influencer collaboration summmaries available"},"summary":{"oneOf":[{"$ref":"#/components/schemas/BrandSummaryInstagram"},{"$ref":"#/components/schemas/BrandSummaryTiktok"},{"$ref":"#/components/schemas/BrandSummaryYoutube"}],"description":"Brand collaboration summary for all influencers"},"per_influencer_summary":{"description":"Brand summary for collaborations with specific influencers","type":"array","items":{"$ref":"#/components/schemas/BrandPerInfluencerSummary"}}},"required":["id","platform","summary","per_influencer_summary"]}},"components/schemas/CollaborationsSummaryResponse":{"id":"components/schemas/CollaborationsSummaryResponse","kind":"json-schema","title":"CollaborationsSummaryResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"cursor":{"type":"string","description":"Cursor for pagination (only valid for 2 days)"},"influencer":{"description":"Only available if the requested profile has influencer collaborations","allOf":[{"$ref":"#/components/schemas/CollaborationsSummaryInfluencer"}]},"brand":{"description":"Only available if the requested profile has brand collaborations","allOf":[{"$ref":"#/components/schemas/CollaborationsSummaryBrand"}]}}}},"components/schemas/AiSearchFiltersFollowers":{"id":"components/schemas/AiSearchFiltersFollowers","kind":"json-schema","title":"AiSearchFiltersFollowers","data":{"type":"object","properties":{"min":{"type":"number","description":"Minimum followers count. Number will be approximated to the nearest range lower or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000."},"max":{"type":"number","description":"Maximum followers count. Number will be approximated to the nearest range higher or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000."}}}},"components/schemas/AiSearchFiltersAge":{"id":"components/schemas/AiSearchFiltersAge","kind":"json-schema","title":"AiSearchFiltersAge","data":{"type":"object","properties":{"min":{"type":"string","description":"Minimum age range","enum":["13","18","25","35","45","65"]},"max":{"type":"string","description":"Maximum age range","enum":["18","25","35","45","65"]}}}},"components/schemas/AiSearchFiltersEngagementRate":{"id":"components/schemas/AiSearchFiltersEngagementRate","kind":"json-schema","title":"AiSearchFiltersEngagementRate","data":{"type":"object","properties":{"min":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum engagement rate (in percentage, 0.01 = 1%)"},"children":[]}]}]}],"example":0.01}}}},"components/schemas/AiSearchFiltersPostingFrequency":{"id":"components/schemas/AiSearchFiltersPostingFrequency","kind":"json-schema","title":"AiSearchFiltersPostingFrequency","data":{"type":"object","properties":{"min":{"type":"number","description":"Minimum average posts per 30-day month","example":4},"max":{"type":"number","description":"Maximum average posts per 30-day month","example":20}}}},"components/schemas/AiSearchFiltersViews":{"id":"components/schemas/AiSearchFiltersViews","kind":"json-schema","title":"AiSearchFiltersViews","data":{"type":"object","properties":{"min":{"type":"number","description":"Minimum average per-post view count. Number will be approximated to the nearest range lower or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000."},"max":{"type":"number","description":"Maximum average per-post view count. Number will be approximated to the nearest range higher or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000."},"calculationMethod":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to filter on median or mean per-post view count (from in-house post_views_stats over the last 60 days)."},"children":[]}]}]}],"enum":["median","average"],"default":"median"}}}},"components/schemas/AiSearchTextTag":{"id":"components/schemas/AiSearchTextTag","kind":"json-schema","title":"AiSearchTextTag","data":{"type":"object","properties":{"type":{"type":"string","description":"Type of text tag","enum":["hashtag","mention"]},"value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Value of the text tag (without # or @ prefix)"},"children":[]}]}]}],"example":"carsofinstagram"},"mode":{"type":"string","description":"Whether to include or exclude posts with this tag. Defaults to include.","enum":["include","exclude"],"default":"include"}},"required":["type","value"]}},"components/schemas/AiSearchListsFilter":{"id":"components/schemas/AiSearchListsFilter","kind":"json-schema","title":"AiSearchListsFilter","data":{"type":"object","properties":{"listIds":{"description":"AI Search list IDs (from POST /ai/lists). Currently exactly one list ID is supported for include/exclude; support for multiple lists is in the works.","minItems":1,"maxItems":1,"example":["a1b2c3d4e5f6789012345678abcdef01"],"type":"array","items":{"type":"string"}},"mode":{"type":"string","description":"include: profiles in the list; exclude: profiles not in the list","enum":["include","exclude"],"example":"exclude"}},"required":["listIds","mode"]}},"components/schemas/IGAudienceFilters":{"id":"components/schemas/IGAudienceFilters","kind":"json-schema","title":"IGAudienceFilters","data":{"type":"object","properties":{"credibility":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by Audience Credibility. The value is the inverse of fake followers, meaning 25% fake followers would translate to 0.75 of audience credibility."},"children":[]}]}]}],"minimum":0,"maximum":1}}}},"components/schemas/IGAiSearchFilters":{"id":"components/schemas/IGAiSearchFilters","kind":"json-schema","title":"IGAiSearchFilters","data":{"type":"object","properties":{"followersCount":{"description":"Filter by followers count","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersFollowers"}]},"locations":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by locations (use "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_locations"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locations dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the location IDs)"},"children":[]}]}]}],"minItems":1,"maxItems":100,"type":"array","items":{"type":"number"}},"gender":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by gender; KNOWN -> male or female, UNKNOWN -> gender neutral"},"children":[]}]}]}],"enum":["MALE","FEMALE","KNOWN","UNKNOWN"]},"lastPostedInDays":{"type":"number","description":"Filter by influencers with latest post date, in days. P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","example":90},"accountType":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by account type. 'creator' is a backwards-compatible alias for 'individual_creator' and 'group_creator'. 'individual_creator' - a single identifiable person is clearly the face and voice; 'group_creator' - two or more identifiable individuals as co-equal faces; 'brand' - a business, organization, media entity, or professional service portfolio; 'anonymous_content' - no identifiable person or organization, curated/aggregated/themed content."},"children":[]}]}]}],"enum":["creator","individual_creator","group_creator","brand","anonymous_content"]},"language":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by language (use "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_languages"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Languages dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the language IDs)"},"children":[]}]}]}]},"age":{"description":"Filter by age range","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersAge"}]},"engagementRate":{"description":"Filter by engagement rate","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersEngagementRate"}]},"postingFrequency":{"description":"Filter by average monthly posting frequency","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersPostingFrequency"}]},"viewsCount":{"description":"Filter by average per-post view count (median or mean)","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersViews"}]},"hasEmail":{"type":"boolean","description":"Filter by whether the influencer has an email"},"brands":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by brands (Use AI search's "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the brand names. P.S. this is a different endpoint than existing Brand Dictionary endpoint)."},"children":[]}]}]}],"minItems":1,"maxItems":4,"type":"array","items":{"type":"string"}},"username":{"type":"string","description":"Username to search for","minLength":1,"maxLength":100},"maxPostAgeMonths":{"type":"number","description":"Filter by the maximum age of the posts in months. Used to request more recent posts.","enum":[3,6,9,12]},"contentType":{"type":"string","description":"Filter by content type. Allowed values: video, image. If not provided, both video and image content will be returned.","enum":["video","image"],"example":"video"},"textTags":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by influencers who have used the defined hashtags or mentions in their posts. Values should be without # or @ prefix."},"children":[]}]}]}],"example":[{"type":"hashtag","value":"carsofinstagram"},{"type":"mention","value":"topgear"}],"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/AiSearchTextTag"}},"bio":{"description":"Full-text search within influencer biography. Provide a single phrase, or up to 10 phrases; a profile matches if any phrase is found.","oneOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"minItems":1,"maxItems":10}],"example":["travel photographer","landscape photography"]},"keywords":{"description":"Full-text search within post captions (Instagram/TikTok caption text, YouTube title/description). Provide a single phrase, or up to 10 phrases; a profile matches if any phrase is found.","oneOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"minItems":1,"maxItems":10}],"example":["supercars","exotic cars"]},"lists":{"description":"Filter by AI Search lists (create/manage via /ai/lists). Currently exactly one list ID is supported; support for multiple lists is in the works. include: profiles in the list; exclude: profiles not in the list. List platform must match the search platform.","example":{"listIds":["a1b2c3d4e5f6789012345678abcdef01"],"mode":"exclude"},"allOf":[{"$ref":"#/components/schemas/AiSearchListsFilter"}]},"audience":{"description":"Filter by Audience","allOf":[{"$ref":"#/components/schemas/IGAudienceFilters"}]}}}},"components/schemas/IGLookalikeRequest":{"id":"components/schemas/IGLookalikeRequest","kind":"json-schema","title":"IGLookalikeRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":10000},"gender":"MALE","lastPostedInDays":90,"accountType":"creator","language":"es","age":{"min":"18"},"engagementRate":{"min":0.01},"postingFrequency":{"min":2},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/IGAiSearchFilters"}]},"userId":{"type":"string","description":"Deprecated. Use userIds instead.","example":"173560420","deprecated":true},"userIds":{"description":"Instagram user IDs or usernames of 1 to 5 source creators.","example":["173560420","25025320"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string"}},"targetPlatform":{"type":"string","description":"Target platform to find lookalikes on. Can be the same as the source platform (same-platform) or different (cross-platform).","enum":["instagram","tiktok","youtube"],"default":"instagram"}}}},"components/schemas/BaseAiSearchFilters":{"id":"components/schemas/BaseAiSearchFilters","kind":"json-schema","title":"BaseAiSearchFilters","data":{"type":"object","properties":{"followersCount":{"description":"Filter by followers count","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersFollowers"}]},"locations":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by locations (use "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_locations"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locations dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the location IDs)"},"children":[]}]}]}],"minItems":1,"maxItems":100,"type":"array","items":{"type":"number"}},"gender":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by gender; KNOWN -> male or female, UNKNOWN -> gender neutral"},"children":[]}]}]}],"enum":["MALE","FEMALE","KNOWN","UNKNOWN"]},"lastPostedInDays":{"type":"number","description":"Filter by influencers with latest post date, in days. P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","example":90},"accountType":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by account type. 'creator' is a backwards-compatible alias for 'individual_creator' and 'group_creator'. 'individual_creator' - a single identifiable person is clearly the face and voice; 'group_creator' - two or more identifiable individuals as co-equal faces; 'brand' - a business, organization, media entity, or professional service portfolio; 'anonymous_content' - no identifiable person or organization, curated/aggregated/themed content."},"children":[]}]}]}],"enum":["creator","individual_creator","group_creator","brand","anonymous_content"]},"language":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by language (use "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/instagram/instagramcontroller_languages"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Languages dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the language IDs)"},"children":[]}]}]}]},"age":{"description":"Filter by age range","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersAge"}]},"engagementRate":{"description":"Filter by engagement rate","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersEngagementRate"}]},"postingFrequency":{"description":"Filter by average monthly posting frequency","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersPostingFrequency"}]},"viewsCount":{"description":"Filter by average per-post view count (median or mean)","allOf":[{"$ref":"#/components/schemas/AiSearchFiltersViews"}]},"hasEmail":{"type":"boolean","description":"Filter by whether the influencer has an email"},"brands":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by brands (Use AI search's "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"target":"_blank","href":"/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand Dictionary endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get the brand names. P.S. this is a different endpoint than existing Brand Dictionary endpoint)."},"children":[]}]}]}],"minItems":1,"maxItems":4,"type":"array","items":{"type":"string"}},"username":{"type":"string","description":"Username to search for","minLength":1,"maxLength":100},"maxPostAgeMonths":{"type":"number","description":"Filter by the maximum age of the posts in months. Used to request more recent posts.","enum":[3,6,9,12]},"contentType":{"type":"string","description":"Filter by content type. Allowed values: video, image. If not provided, both video and image content will be returned.","enum":["video","image"],"example":"video"},"textTags":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by influencers who have used the defined hashtags or mentions in their posts. Values should be without # or @ prefix."},"children":[]}]}]}],"example":[{"type":"hashtag","value":"carsofinstagram"},{"type":"mention","value":"topgear"}],"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/AiSearchTextTag"}},"bio":{"description":"Full-text search within influencer biography. Provide a single phrase, or up to 10 phrases; a profile matches if any phrase is found.","oneOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"minItems":1,"maxItems":10}],"example":["travel photographer","landscape photography"]},"keywords":{"description":"Full-text search within post captions (Instagram/TikTok caption text, YouTube title/description). Provide a single phrase, or up to 10 phrases; a profile matches if any phrase is found.","oneOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"array","items":{"type":"string","minLength":1,"maxLength":500},"minItems":1,"maxItems":10}],"example":["supercars","exotic cars"]},"lists":{"description":"Filter by AI Search lists (create/manage via /ai/lists). Currently exactly one list ID is supported; support for multiple lists is in the works. include: profiles in the list; exclude: profiles not in the list. List platform must match the search platform.","example":{"listIds":["a1b2c3d4e5f6789012345678abcdef01"],"mode":"exclude"},"allOf":[{"$ref":"#/components/schemas/AiSearchListsFilter"}]}}}},"components/schemas/TTLookalikeRequest":{"id":"components/schemas/TTLookalikeRequest","kind":"json-schema","title":"TTLookalikeRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":13000},"gender":"FEMALE","lastPostedInDays":90,"accountType":"creator","language":"en","age":{"min":"18"},"engagementRate":{"min":0.04},"postingFrequency":{"min":4,"max":20},"viewsCount":{"min":10000,"calculationMethod":"median"},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/BaseAiSearchFilters"}]},"userId":{"type":"string","description":"Deprecated. Use userIds instead.","example":"107955","deprecated":true},"userIds":{"description":"TikTok user IDs or usernames of 1 to 5 source creators.","example":["107955","6806000720485401605"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string"}},"targetPlatform":{"type":"string","description":"Target platform to find lookalikes on. Can be the same as the source platform (same-platform) or different (cross-platform).","enum":["instagram","tiktok","youtube"],"default":"tiktok"}}}},"components/schemas/YTLookalikeRequest":{"id":"components/schemas/YTLookalikeRequest","kind":"json-schema","title":"YTLookalikeRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":13000},"gender":"FEMALE","lastPostedInDays":90,"accountType":"creator","language":"en","age":{"min":"18"},"engagementRate":{"min":0.04},"postingFrequency":{"min":4,"max":20},"viewsCount":{"min":10000,"calculationMethod":"median"},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/BaseAiSearchFilters"}]},"userId":{"type":"string","description":"Deprecated. Use userIds instead.","example":"UCHnyfMqiRRG1u-2MsSQLbXA","deprecated":true},"userIds":{"description":"YouTube channel IDs or usernames of 1 to 5 source creators.","example":["UCHnyfMqiRRG1u-2MsSQLbXA","UCX6OQ3DkcsbYNE6H8uQQuVA"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string"}},"targetPlatform":{"type":"string","description":"Target platform to find lookalikes on. Can be the same as the source platform (same-platform) or different (cross-platform).","enum":["instagram","tiktok","youtube"],"default":"youtube"}}}},"components/schemas/IGTextAiSearchRequest":{"id":"components/schemas/IGTextAiSearchRequest","kind":"json-schema","title":"IGTextAiSearchRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":10000},"gender":"MALE","lastPostedInDays":90,"accountType":"creator","language":"es","age":{"min":"18"},"engagementRate":{"min":0.01},"postingFrequency":{"min":2},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/IGAiSearchFilters"}]},"query":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Natural-language text describing the creator and/or the type of content. Use this for querying "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content semantics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (what appears in photos and videos)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Avoid"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using criteria for which a filter exists, e.g., language, locations, age ranges."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Negation is not supported"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - do not rely on \"no\", \"not\", \"without\", or \"exclude\" to remove topics."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queries may be in any language, but different languages may yield different results; English usually yields the strongest matches."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limit: 8192 characters or 512 words. If omitted, results are sorted by follower count."},"children":[]}]}]}],"example":"Sporty stay at home mom sharing kids gut health tips and family wellness","minLength":1,"maxLength":8192}}}},"components/schemas/AiSearchPostStats":{"id":"components/schemas/AiSearchPostStats","kind":"json-schema","title":"AiSearchPostStats","data":{"type":"object","properties":{"likesCount":{"type":"number","description":"Likes count; -1 if likes count is hidden"},"commentsCount":{"type":"number","description":"Comments count; -1 if comments count is hidden"},"playsCount":{"type":"number","description":"Plays count"}},"required":["likesCount","commentsCount","playsCount"]}},"components/schemas/AiSearchPost":{"id":"components/schemas/AiSearchPost","kind":"json-schema","title":"AiSearchPost","data":{"type":"object","properties":{"id":{"type":"string","description":"Post ID"},"url":{"type":"string","description":"Post URL"},"thumbnail":{"type":"string","description":"Post thumbnail URL"},"stats":{"description":"Post statistics","allOf":[{"$ref":"#/components/schemas/AiSearchPostStats"}]}},"required":["id","url","thumbnail","stats"]}},"components/schemas/AiSearchProfile":{"id":"components/schemas/AiSearchProfile","kind":"json-schema","title":"AiSearchProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"matchedPosts":{"description":"Posts ordered by relevance to the search query","type":"array","items":{"$ref":"#/components/schemas/AiSearchPost"}},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/AiSearchPost"}},"accountCategory":{"type":"string","description":"Account category","example":"Sportsperson / Digital creator etc."}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","matchedPosts","recentPosts","accountCategory"]}},"components/schemas/AiSearchResponse":{"id":"components/schemas/AiSearchResponse","kind":"json-schema","title":"AiSearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of profiles matching the search query. This is estimated from similarity score distribution and can exceed how many profiles pagination can actually return."},"profiles":{"description":"List of influencer profiles matching the search query and filters","type":"array","items":{"$ref":"#/components/schemas/AiSearchProfile"}}},"required":["total","profiles"]}},"components/schemas/IGImageAiSearchRequest":{"id":"components/schemas/IGImageAiSearchRequest","kind":"json-schema","title":"IGImageAiSearchRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":10000},"gender":"MALE","lastPostedInDays":90,"accountType":"creator","language":"es","age":{"min":"18"},"engagementRate":{"min":0.01},"postingFrequency":{"min":2},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/IGAiSearchFilters"}]},"imageType":{"type":"string","description":"Image type","enum":["image/jpeg","image/png","image/webp"]},"base64Image":{"type":"string","description":"Image (base64 encoded), max size 5MB","format":"base64","maxLength":6990507}},"required":["imageType","base64Image"]}},"components/schemas/TextAiSearchRequest":{"id":"components/schemas/TextAiSearchRequest","kind":"json-schema","title":"TextAiSearchRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":13000},"gender":"FEMALE","lastPostedInDays":90,"accountType":"creator","language":"en","age":{"min":"18"},"engagementRate":{"min":0.04},"postingFrequency":{"min":4,"max":20},"viewsCount":{"min":10000,"calculationMethod":"median"},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/BaseAiSearchFilters"}]},"query":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Natural-language text describing the creator and/or the type of content. Use this for querying "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content semantics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (what appears in photos and videos)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Avoid"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using criteria for which a filter exists, e.g., language, locations, age ranges."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Negation is not supported"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - do not rely on \"no\", \"not\", \"without\", or \"exclude\" to remove topics."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queries may be in any language, but different languages may yield different results; English usually yields the strongest matches."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limit: 8192 characters or 512 words. If omitted, results are sorted by follower count."},"children":[]}]}]}],"example":"Sporty stay at home mom sharing kids gut health tips and family wellness","minLength":1,"maxLength":8192}}}},"components/schemas/TTAiSearchPostStats":{"id":"components/schemas/TTAiSearchPostStats","kind":"json-schema","title":"TTAiSearchPostStats","data":{"type":"object","properties":{"likesCount":{"type":"number","description":"Likes count; -1 if likes count is hidden"},"commentsCount":{"type":"number","description":"Comments count; -1 if comments count is hidden"},"sharesCount":{"type":"number","description":"Shares count"},"playsCount":{"type":"number","description":"Plays count"},"collectsCount":{"type":"number","description":"Collects count"}},"required":["likesCount","commentsCount","sharesCount","playsCount","collectsCount"]}},"components/schemas/TTAiSearchPost":{"id":"components/schemas/TTAiSearchPost","kind":"json-schema","title":"TTAiSearchPost","data":{"type":"object","properties":{"id":{"type":"string","description":"Post ID"},"url":{"type":"string","description":"Post URL"},"thumbnail":{"type":"string","description":"Post thumbnail URL"},"stats":{"description":"Post statistics","allOf":[{"$ref":"#/components/schemas/TTAiSearchPostStats"}]}},"required":["id","url","thumbnail","stats"]}},"components/schemas/TTAiSearchProfile":{"id":"components/schemas/TTAiSearchProfile","kind":"json-schema","title":"TTAiSearchProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"matchedPosts":{"description":"Posts ordered by relevance to the search query","type":"array","items":{"$ref":"#/components/schemas/TTAiSearchPost"}},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/TTAiSearchPost"}},"accountCategory":{"type":"string","description":"Account category","example":"Sportsperson / Digital creator etc."}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","matchedPosts","recentPosts","accountCategory"]}},"components/schemas/TTAiSearchResponse":{"id":"components/schemas/TTAiSearchResponse","kind":"json-schema","title":"TTAiSearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of profiles matching the search query. This is estimated from similarity score distribution and can exceed how many profiles pagination can actually return."},"profiles":{"description":"List of influencer profiles matching the search query and filters","type":"array","items":{"$ref":"#/components/schemas/TTAiSearchProfile"}}},"required":["total","profiles"]}},"components/schemas/ImageAiSearchRequest":{"id":"components/schemas/ImageAiSearchRequest","kind":"json-schema","title":"ImageAiSearchRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":13000},"gender":"FEMALE","lastPostedInDays":90,"accountType":"creator","language":"en","age":{"min":"18"},"engagementRate":{"min":0.04},"postingFrequency":{"min":4,"max":20},"viewsCount":{"min":10000,"calculationMethod":"median"},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/BaseAiSearchFilters"}]},"imageType":{"type":"string","description":"Image type","enum":["image/jpeg","image/png","image/webp"]},"base64Image":{"type":"string","description":"Image (base64 encoded), max size 5MB","format":"base64","maxLength":6990507}},"required":["imageType","base64Image"]}},"components/schemas/YTTextAiSearchRequest":{"id":"components/schemas/YTTextAiSearchRequest","kind":"json-schema","title":"YTTextAiSearchRequest","data":{"type":"object","properties":{"page":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error."},"children":[]}]}]}],"default":0,"minimum":0},"pageSize":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29."},"children":[]}]}]}],"default":6,"minimum":1,"maximum":50},"filters":{"description":"Additional filters to refine the search results","example":{"followersCount":{"min":13000},"gender":"FEMALE","lastPostedInDays":90,"accountType":"creator","language":"en","age":{"min":"18"},"engagementRate":{"min":0.04},"postingFrequency":{"min":4,"max":20},"viewsCount":{"min":10000,"calculationMethod":"median"},"hasEmail":true,"maxPostAgeMonths":3},"allOf":[{"$ref":"#/components/schemas/BaseAiSearchFilters"}]},"query":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Natural-language text describing the creator and/or the type of content. Use this for querying "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content semantics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (what appears in photos and videos)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Avoid"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using criteria for which a filter exists, e.g., language, locations, age ranges."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Negation is not supported"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - do not rely on \"no\", \"not\", \"without\", or \"exclude\" to remove topics."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queries may be in any language, but different languages may yield different results; English usually yields the strongest matches."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limit: 8192 characters or 512 words. If omitted, results are sorted by follower count."},"children":[]}]}]}],"example":"Sporty stay at home mom sharing kids gut health tips and family wellness","minLength":1,"maxLength":8192}}}},"components/schemas/YTAiSearchPostStats":{"id":"components/schemas/YTAiSearchPostStats","kind":"json-schema","title":"YTAiSearchPostStats","data":{"type":"object","properties":{"likesCount":{"type":"number","description":"Likes count; -1 if likes count is hidden"},"commentsCount":{"type":"number","description":"Comments count; -1 if comments count is hidden"},"viewsCount":{"type":"number","description":"Views count"}},"required":["likesCount","commentsCount","viewsCount"]}},"components/schemas/YTAiSearchPost":{"id":"components/schemas/YTAiSearchPost","kind":"json-schema","title":"YTAiSearchPost","data":{"type":"object","properties":{"id":{"type":"string","description":"Post ID"},"url":{"type":"string","description":"Post URL"},"thumbnail":{"type":"string","description":"Post thumbnail URL"},"title":{"type":"string","description":"Video title"},"stats":{"description":"Post statistics","allOf":[{"$ref":"#/components/schemas/YTAiSearchPostStats"}]}},"required":["id","url","thumbnail","stats"]}},"components/schemas/YTAiSearchProfile":{"id":"components/schemas/YTAiSearchProfile","kind":"json-schema","title":"YTAiSearchProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"matchedPosts":{"description":"Posts ordered by relevance to the search query","type":"array","items":{"$ref":"#/components/schemas/YTAiSearchPost"}},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/YTAiSearchPost"}}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","matchedPosts","recentPosts"]}},"components/schemas/YTAiSearchResponse":{"id":"components/schemas/YTAiSearchResponse","kind":"json-schema","title":"YTAiSearchResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of profiles matching the search query. This is estimated from similarity score distribution and can exceed how many profiles pagination can actually return."},"profiles":{"description":"List of influencer profiles matching the search query and filters","type":"array","items":{"$ref":"#/components/schemas/YTAiSearchProfile"}}},"required":["total","profiles"]}},"components/schemas/LookalikeSourceProfile":{"id":"components/schemas/LookalikeSourceProfile","kind":"json-schema","title":"LookalikeSourceProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"url":{"type":"string","description":"Profile URL","example":"https://instagram.com/instagram"},"accountCategory":{"type":"string","description":"Account category","example":"Sportsperson / Digital creator etc."}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","url"]}},"components/schemas/IGLookalikeProfile":{"id":"components/schemas/IGLookalikeProfile","kind":"json-schema","title":"IGLookalikeProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/AiSearchPost"}},"accountCategory":{"type":"string","description":"Account category","example":"Sportsperson / Digital creator etc."}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","recentPosts"]}},"components/schemas/IGLookalikeResponse":{"id":"components/schemas/IGLookalikeResponse","kind":"json-schema","title":"IGLookalikeResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of lookalike profiles found. This is estimated from similarity score distribution and can exceed how many lookalikes pagination can actually return."},"sourceProfile":{"description":"Deprecated. Use sourceProfiles. Contains the first resolved source creator profile.","deprecated":true,"allOf":[{"$ref":"#/components/schemas/LookalikeSourceProfile"}]},"sourceProfiles":{"description":"Source creator profiles used to find lookalikes","type":"array","items":{"$ref":"#/components/schemas/LookalikeSourceProfile"}},"lookalikes":{"description":"List of lookalike influencer profiles","type":"array","items":{"$ref":"#/components/schemas/IGLookalikeProfile"}}},"required":["total","sourceProfile","sourceProfiles","lookalikes"]}},"components/schemas/TTLookalikeProfile":{"id":"components/schemas/TTLookalikeProfile","kind":"json-schema","title":"TTLookalikeProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/TTAiSearchPost"}},"accountCategory":{"type":"string","description":"Account category","example":"Sportsperson / Digital creator etc."}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","recentPosts"]}},"components/schemas/TTLookalikeResponse":{"id":"components/schemas/TTLookalikeResponse","kind":"json-schema","title":"TTLookalikeResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of lookalike profiles found. This is estimated from similarity score distribution and can exceed how many lookalikes pagination can actually return."},"sourceProfile":{"description":"Deprecated. Use sourceProfiles. Contains the first resolved source creator profile.","deprecated":true,"allOf":[{"$ref":"#/components/schemas/LookalikeSourceProfile"}]},"sourceProfiles":{"description":"Source creator profiles used to find lookalikes","type":"array","items":{"$ref":"#/components/schemas/LookalikeSourceProfile"}},"lookalikes":{"description":"List of lookalike influencer profiles","type":"array","items":{"$ref":"#/components/schemas/TTLookalikeProfile"}}},"required":["total","sourceProfile","sourceProfiles","lookalikes"]}},"components/schemas/YTLookalikeProfile":{"id":"components/schemas/YTLookalikeProfile","kind":"json-schema","title":"YTLookalikeProfile","data":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"173560420"},"fullName":{"type":"string","description":"Full name","example":"Instagram"},"username":{"type":"string","description":"Username","example":"instagram"},"profilePicture":{"type":"string","description":"Profile Picture","example":"https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"},"followersCount":{"type":"number","description":"Followers count","example":313560626},"engagementRate":{"type":"number","description":"Engagement rate","example":0.01},"postingFrequency":{"type":"number","description":"Average posts per 30-day month","example":12},"viewsCountMedian":{"type":"number","description":"Median per-post view count over the last 60 days","example":25000},"viewsCountMean":{"type":"number","description":"Mean per-post view count over the last 60 days","example":32000},"recentPosts":{"description":"Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.","type":"array","items":{"$ref":"#/components/schemas/YTAiSearchPost"}}},"required":["username","profilePicture","followersCount","engagementRate","postingFrequency","recentPosts"]}},"components/schemas/YTLookalikeResponse":{"id":"components/schemas/YTLookalikeResponse","kind":"json-schema","title":"YTLookalikeResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"total":{"type":"number","description":"Approximate number of lookalike profiles found. This is estimated from similarity score distribution and can exceed how many lookalikes pagination can actually return."},"sourceProfile":{"description":"Deprecated. Use sourceProfiles. Contains the first resolved source creator profile.","deprecated":true,"allOf":[{"$ref":"#/components/schemas/LookalikeSourceProfile"}]},"sourceProfiles":{"description":"Source creator profiles used to find lookalikes","type":"array","items":{"$ref":"#/components/schemas/LookalikeSourceProfile"}},"lookalikes":{"description":"List of lookalike influencer profiles","type":"array","items":{"$ref":"#/components/schemas/YTLookalikeProfile"}}},"required":["total","sourceProfile","sourceProfiles","lookalikes"]}},"components/schemas/BrandsDictionaryBrandAccount":{"id":"components/schemas/BrandsDictionaryBrandAccount","kind":"json-schema","title":"BrandsDictionaryBrandAccount","data":{"type":"object","properties":{"platform":{"type":"string","description":"Platform","enum":["instagram","tiktok","youtube"]},"userId":{"type":"string","description":"Brand user ID, not available for Youtube"},"username":{"type":"string","description":"Brand username, not available for Youtube"},"domain":{"type":"string","description":"Brand domain (if we do not have the domain then we return the brand's profile URL instead)"}},"required":["platform","domain"]}},"components/schemas/BrandsDictionaryBrand":{"id":"components/schemas/BrandsDictionaryBrand","kind":"json-schema","title":"BrandsDictionaryBrand","data":{"type":"object","properties":{"brandId":{"type":"string","description":"Brand ID (brand identity hash)"},"name":{"type":"string","description":"Brand name"},"logoUrl":{"type":"string","description":"Brand logo URL"},"accounts":{"description":"Social platform accounts related to the brand","type":"array","items":{"$ref":"#/components/schemas/BrandsDictionaryBrandAccount"}}},"required":["brandId","name","logoUrl","accounts"]}},"components/schemas/BrandsDictionaryResponse":{"id":"components/schemas/BrandsDictionaryResponse","kind":"json-schema","title":"BrandsDictionaryResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"result":{"description":"List of top 5 brands based on the search query","type":"array","items":{"$ref":"#/components/schemas/BrandsDictionaryBrand"}}},"required":["result"]}},"components/schemas/TextTagsDictionaryResult":{"id":"components/schemas/TextTagsDictionaryResult","kind":"json-schema","title":"TextTagsDictionaryResult","data":{"type":"object","properties":{"value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The hashtag or mention value (without # or @ prefix)"},"children":[]}]}]}]},"count":{"type":"number","description":"Number of posts containing this value"}},"required":["value","count"]}},"components/schemas/TextTagsDictionaryResponse":{"id":"components/schemas/TextTagsDictionaryResponse","kind":"json-schema","title":"TextTagsDictionaryResponse","data":{"type":"object","properties":{"error":{"type":"boolean","description":"If there is an error","example":false},"result":{"description":"Top results sorted by popularity","type":"array","items":{"$ref":"#/components/schemas/TextTagsDictionaryResult"}}},"required":["result"]}},"components/schemas/CreateAiSearchListRequest":{"id":"components/schemas/CreateAiSearchListRequest","kind":"json-schema","title":"CreateAiSearchListRequest","data":{"type":"object","properties":{"name":{"type":"string","description":"List name","example":"Partnered creators July 2026","minLength":1,"maxLength":255},"platform":{"type":"string","description":"Platform for list members. Immutable after create.","enum":["instagram","tiktok","youtube"],"example":"instagram"}},"required":["name","platform"]}},"components/schemas/AiSearchListSummary":{"id":"components/schemas/AiSearchListSummary","kind":"json-schema","title":"AiSearchListSummary","data":{"type":"object","properties":{"listId":{"type":"string","example":"a1b2c3d4e5f6789012345678abcdef01"},"name":{"type":"string","example":"Partnered creators July 2026"},"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"example":"instagram"},"approximateMemberCount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast approximate size of the list. Kept approximate so metadata requests stay cheap under concurrent writes. For an exact count, paginate through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /ai/lists/{listId}/members"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and sum the returned IDs."},"children":[]}]}]}],"example":102},"createdAt":{"type":"string","example":"2026-07-23T08:00:00.000Z"},"updatedAt":{"type":"string","example":"2026-07-23T08:05:00.000Z"}},"required":["listId","name","platform","approximateMemberCount","createdAt","updatedAt"]}},"components/schemas/AiSearchListErrorResponse":{"id":"components/schemas/AiSearchListErrorResponse","kind":"json-schema","title":"AiSearchListErrorResponse","data":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string","example":"List not found"},"code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Stable machine-readable code when present ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LIST_LIMIT_EXCEEDED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LIST_SIZE_LIMIT_EXCEEDED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Prefer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" over "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for error handling."},"children":[]}]}]}],"example":"LIST_LIMIT_EXCEEDED"}},"required":["error","message"]}},"components/schemas/GetAiSearchListsResponse":{"id":"components/schemas/GetAiSearchListsResponse","kind":"json-schema","title":"GetAiSearchListsResponse","data":{"type":"object","properties":{"lists":{"type":"array","items":{"$ref":"#/components/schemas/AiSearchListSummary"}},"nextCursor":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cursor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the next request when more lists remain"},"children":[]}]}]}]}},"required":["lists"]}},"components/schemas/GetAiSearchListMembersResponse":{"id":"components/schemas/GetAiSearchListMembersResponse","kind":"json-schema","title":"GetAiSearchListMembersResponse","data":{"type":"object","properties":{"listId":{"type":"string","example":"a1b2c3d4e5f6789012345678abcdef01"},"influencerIds":{"example":["123","456"],"type":"array","items":{"type":"string"}},"nextCursor":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cursor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the next request when more members remain"},"children":[]}]}]}]}},"required":["listId","influencerIds"]}},"components/schemas/AiSearchListMembersRequest":{"id":"components/schemas/AiSearchListMembersRequest","kind":"json-schema","title":"AiSearchListMembersRequest","data":{"type":"object","properties":{"influencerIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Platform user IDs only (Instagram/TikTok digits, YouTube UC… channel IDs). Usernames, handles, and URLs are rejected. Max 10,000 unique IDs per request."},"children":[]}]}]}],"minItems":1,"maxItems":10000,"example":["123","456"],"type":"array","items":{"type":"string"}}},"required":["influencerIds"]}},"components/schemas/AddAiSearchListMembersResponse":{"id":"components/schemas/AddAiSearchListMembersResponse","kind":"json-schema","title":"AddAiSearchListMembersResponse","data":{"type":"object","properties":{"addedCount":{"type":"number","example":2},"existingCount":{"type":"number","example":0},"approximateMemberCount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast approximate size after the write. For an exact count, paginate through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /ai/lists/{listId}/members"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":102}},"required":["addedCount","existingCount","approximateMemberCount"]}},"components/schemas/RemoveAiSearchListMembersResponse":{"id":"components/schemas/RemoveAiSearchListMembersResponse","kind":"json-schema","title":"RemoveAiSearchListMembersResponse","data":{"type":"object","properties":{"removedCount":{"type":"number","example":2},"missingCount":{"type":"number","example":0},"approximateMemberCount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast approximate size after the write. For an exact count, paginate through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /ai/lists/{listId}/members"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":100}},"required":["removedCount","missingCount","approximateMemberCount"]}},"schema_69":{"kind":"json-schema","data":{"example":"@MrBeast","type":"string"},"id":"schema_69"},"schema_70":{"kind":"json-schema","data":{"default":"median","enum":["median","average"],"type":"string"},"id":"schema_70"},"schema_71":{"kind":"json-schema","data":{"example":1000,"type":"number"},"id":"schema_71"},"schema_72":{"kind":"json-schema","data":{"example":"ita","type":"string"},"id":"schema_72"},"schema_73":{"kind":"json-schema","data":{"example":"mrbeast","type":"string"},"id":"schema_73"},"schema_74":{"kind":"json-schema","data":{"example":"travel","type":"string"},"id":"schema_74"},"schema_75":{"kind":"json-schema","data":{"example":"@claudinelanglois","type":"string"},"id":"schema_75"},"schema_76":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/IGLookalikeRequest"},{"oneOf":[{"required":["userId"]},{"required":["userIds"]}]}]},"id":"schema_76"},"schema_77":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/TTLookalikeRequest"},{"oneOf":[{"required":["userId"]},{"required":["userIds"]}]}]},"id":"schema_77"},"schema_78":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/YTLookalikeRequest"},{"oneOf":[{"required":["userId"]},{"required":["userIds"]}]}]},"id":"schema_78"},"schema_79":{"kind":"json-schema","data":{"minLength":1,"maxLength":255,"example":"coca cola","type":"string"},"id":"schema_79"},"schema_80":{"kind":"json-schema","data":{"minLength":1,"maxLength":255,"type":"string"},"id":"schema_80"},"schema_81":{"kind":"json-schema","data":{"example":"instagram","enum":["instagram","tiktok","youtube"],"type":"string"},"id":"schema_81"},"schema_82":{"kind":"json-schema","data":{"type":"string"},"id":"schema_82"},"schema_83":{"kind":"json-schema","data":{"enum":["instagram","tiktok","youtube"],"type":"string"},"id":"schema_83"},"schema_84":{"kind":"json-schema","data":{"minimum":1,"maximum":100,"default":20,"type":"number"},"id":"schema_84"},"schema_85":{"kind":"json-schema","data":{"minimum":1,"maximum":5000,"default":1000,"type":"number"},"id":"schema_85"},"schema_86":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"description":"If there is an error","type":"boolean"},"user":{"type":"object","properties":{"name":{"examples":"Jane Doe","description":"Deprecated field, it is always empty. We will remove this field in the next version of the API.","type":"string"},"email":{"examples":"janedoe@example.com","description":"Deprecated field, it is always empty. We will remove this field in the next version of the API.","type":"string"}}},"billing":{"type":"object","properties":{"credits":{"examples":500.5,"type":"number"},"rawRequests":{"example":4500,"type":"number"}},"required":["rawRequests"]},"rateLimits":{"type":"object","properties":{"discoveryRatelimit":{"example":500,"type":"number"},"rawRatelimit":{"example":500,"type":"number"}},"required":["discoveryRatelimit","rawRatelimit"]}},"required":["error","user","billing","rateLimits"]},"id":"schema_86"}},"exampleStore":{"paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default":{"value":{"id":"cristiano","platform":"instagram","limit":10},"key":"default","summary":"default","id":"paths/~1collaborations~1posts/post/requestBody/content/application~1json/examples/default"},"paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default":{"value":{"id":"cristiano","platform":"instagram","limit":10},"key":"default","summary":"default","id":"paths/~1collaborations~1summary/post/requestBody/content/application~1json/examples/default"}},"securitySchemeStore":{"accessToken":{"id":"accessToken","type":"http","scheme":"bearer","bearerFormat":"token","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please enter token in following format: Bearer <APIToken>"},"children":[]}]}]}],"in":"header","paramName":"Authorization"}},"servers":[{"url":"https://api.modash.io/v1"}]},"options":{"onlyRequiredInSamples":false,"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/products/discovery_api/openapi_doc/discovery.json?download"},{"url":"/_bundle/products/discovery_api/openapi_doc/discovery.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Overview","description":"Discovery API provides powerful products for different use cases. Let us provide a brief overview:\n\nSearch allows you to build comprehensive search experience to find creators. Use filters, lookalikes and our dictionaries and lists to create stunning user interfaces.\n\nReports provide in depth analytics that include audience demographics, performance metrics, sponsored posts and much more.\n\nOur collaborations products enable you to create overviews of past brand partnerships between creators and brands.\n\nThere is more: Search by Email allows you to lookup which creator accounts are associated with an emails and audience overlap identifies the uniqueness of an audience with ease.\n\n# Testing the API\n\n## Search\n\nYou can test out the [Instagram Search API](#tag/Instagram/paths/~1instagram~1search/post) for free by leaving the filter object empty. Your request body should look similar to this.\n\n```\n> POST https://api.modash.io/v1/instagram/search\n{\n\t\"sort\": {\n\t\t\"field\": \"followers\",\n\t\t\"direction\": \"desc\"\n\t},\n\t\"filter\": {\n\t}\n}\n```\n\n## Reports\n\nTo test out the [Instagram Reports API](#tag/Instagram/paths/~1instagram~1profile~1{userId}~1report/get) for free you can set the `userId` as `instagram`.\nYour request should look like this.\n\n```\n> GET https://api.modash.io/v1/instagram/profile/instagram/report\n```\n\nWe recommend always using the report route and caching the result if necessary. Everything that is included in the overview is also in a report.\n\n# Pagination\n\nWhen using the Search API, each response has in total 15 influencers. If you wish to query more influencers for the same query you need to increment the `page` parameter in the request body.\n\nBy default the `page` parameter is set to `0`.\n\n# Dictionaries\n\n## Interests, Locations and brands\n\nWhen finding influencers by interests, locations or brands you need to search by their respective ID. To list all interests, locations or brands you need to call the `https://api.modash.io/v1/instagram/interests`, `https://api.modash.io/v1/instagram/locations`, `https://api.modash.io/v1/instagram/brands` route.\n\nYou can specify the list of interests, locations or brands returned by using the `query` parameter and limit the amount of list items returned by using the `limit` parameter.\n\nBy default the `limit` parameter is set to `20`. You can query all list items by setting the `limit` parameter to `1000000`.\n\n## Languages\n\nSimilar to interests, locations and brands, you first need to find the correct language code to search by. This can be done by calling the `https://api.modash.io/v1/instagram/languages` route.\n"}},"baseSlug":"/products/discovery_api/openapi_doc/discovery","routesMapping":{}}