Rechercher des créateurs Instagram

Exécute une recherche filtrée sur la base des créateurs Instagram et renvoie les comptes correspondants avec des indicateurs résumés, de façon paginée. Combinez les filtres pour cibler niche, taille et zone. Les recherches consomment plus de quota qu'une consultation unitaire.

POST/api/v1/search/instagram/user

Consommation de quota: Chaque requête réussie vers ce point de terminaison déduit 100 unités de quota de votre forfait.

Famille de chemins multiplateforme

/api/v1/search/{platform}/user

Plateformes disponibles

Paramètres de requête

Paramètres obligatoires

Ce point de terminaison n'a aucun paramètre obligatoire.

Paramètres optionnels

Nom	Emplacement	Type	Description
`page`	body	integer	page number example: 0
`page_size`	body	integer	page size example: 0
`query`	body	object	Search term example: string
`locations`	body	object	Country
`follower_count_min`	body	object	Minimum follower count example: 0
`follower_count_max`	body	object	Maximum follower count example: 0
`create_at_start`	body	object	Publish time from example: string
`create_at_end`	body	object	Publish time to example: string
`avg_engagement_rate_min`	body	object	Minimum average engagement rate example: 0
`avg_engagement_rate_max`	body	object	Maximum average engagement rate example: 0
`avg_comment_count_min`	body	object	Minimum average comments example: 0
`avg_comment_count_max`	body	object	Maximum average comments example: 0
`avg_like_count_min`	body	object	Minimum average likes example: 0
`avg_like_count_max`	body	object	Maximum average likes example: 0
`avg_play_count_min`	body	object	Minimum average plays example: 0
`avg_play_count_max`	body	object	Maximum average plays example: 0
`gender`	body	object	Gender (0 = unknown, 1 = male, 2 = female) example: 0
`recent_month_publish_count_min`	body	object	Minimum posts in the last month example: 0
`recent_month_publish_count_max`	body	object	Maximum posts in the last month example: 0

Champs de réponse

Nom	Type	Description
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.items`	array<object>	Items
`data.total`	integer	Total
`data.page`	integer	Page
`data.page_size`	integer	Page Size
`data.total_pages`	integer	Total Pages

Tester

URL de la requête

https://openapi.scdata.cc/api/v1/search/instagram/user

Authorization

Sélectionnez une clé API du tableau de bord

Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord

Corps JSON

Exemple cURL

bash

curl -X POST "https://openapi.scdata.cc/api/v1/search/instagram/user" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":0,"page_size":0,"query":"string","locations":["string"],"follower_count_min":0,"follower_count_max":0,"create_at_start":"string","create_at_end":"string","avg_engagement_rate_min":0,"avg_engagement_rate_max":0,"avg_comment_count_min":0,"avg_comment_count_max":0,"avg_like_count_min":0,"avg_like_count_max":0,"avg_play_count_min":0,"avg_play_count_max":0,"gender":0,"recent_month_publish_count_min":0,"recent_month_publish_count_max":0}'

Exemple de réponse (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "items": [
      {
        "user_id": "string",
        "username": "string",
        "full_name": "string",
        "avatar": "string",
        "country": "string",
        "gender": "string",
        "follower_count": 0,
        "avg_engagement_rate": "string",
        "avg_video_engagement_rate": "string",
        "avg_comment_count": "string",
        "avg_like_count": "string",
        "avg_play_count": "string",
        "video_count": 0,
        "last_publish_at": "string",
        "recent_month_publish_count": 0,
        "recent_week_publish_count": 0,
        "last_media": {
          "media_id": "string",
          "description": "string",
          "create_at": "2019-08-24T14:15:22.123Z",
          "cover_url": "string",
          "like_count": 0,
          "comment_count": 0,
          "play_count": 0
        },
        "evaluation_min": "string",
        "evaluation_max": "string"
      }
    ],
    "total": 0,
    "page": 0,
    "page_size": 0,
    "total_pages": 0
  }
}

Cas d'usage

Sourcing de campagne — Trouvez à partir de zéro des créateurs d'une niche et d'une tranche d'abonnés correspondant au brief.
Cartographie de marché — Recensez tous les créateurs notables d'une catégorie et d'une région pour comprendre le paysage.