Search public profiles of creators

Search for LinkedIn creator profiles using publicly available data based on available filters.

POST /v1/professional/creators/profiles/search

Basic auth

curl 'https://api.staging.insightiq.ai/v1/professional/creators/profiles/search' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "work_platform_id": "work_platform_01JXY9AZK4KV",
  "follower_count": {
    "min": 1,
    "max": 1
  },
  "content_count": {
    "min": 1,
    "max": 1
  },
  "has_contact_details": true,
  "last_post_timestamp": "2019-08-24T14:15:22",
  "average_likes": {
    "min": 1,
    "max": 1
  },
  "average_comments": {
    "min": 1,
    "max": 1
  },
  "average_shares": {
    "min": 1,
    "max": 1
  },
  "engagement_rate": {
    "percentage_value": "example"
  },
  "creator_location_names": [
    "example"
  ],
  "bio_phrase": "example",
  "hashtags": [
    {
      "name": "example"
    }
  ],
  "talks_about": [
    {
      "name": "example"
    }
  ],
  "mentions": [
    {
      "name": "example",
      "type": "COMPANY"
    }
  ],
  "creator_account_type": [
    "CREATOR"
  ],
  "sort_by": {
    "field": "AVERAGE_LIKES",
    "order": "DESCENDING"
  },
  "limit": 10,
  "offset": 0,
  "work_experiences": [
    {
      "title": "example",
      "company": "123e4567-e89b-42d3-a456-426614174000"
    }
  ],
  "education": [
    {
      "institute": "123e4567-e89b-42d3-a456-426614174000",
      "degree": "123e4567-e89b-42d3-a456-426614174000"
    }
  ]
}'

{
  "data": [
    {
      "full_name": "example",
      "url": "https://example.com",
      "image_url": "https://example.com",
      "follower_count": 1,
      "connection_count": 1,
      "work_platform": {
        "id": "9bb8913b-ddd9-430b-a66a-d74d846e6c66",
        "name": "Instagram, Twitter",
        "logo_url": "https://insightiq.ai/storage/instagram.png"
      },
      "introduction": "example",
      "engagement_rate": 1,
      "creator_location": {
        "city": "example",
        "state": "example",
        "country": "example"
      },
      "external_id": "external_01JXY9AZK4KV",
      "profile_headline": "example",
      "talks_about": [
        "example"
      ],
      "current_positions": [
        {
          "title": "example",
          "company": "example",
          "description": "example",
          "location": "example",
          "time_period": {}
        }
      ],
      "creator_account_type": [
        "CREATOR"
      ],
      "open_to": [
        "example"
      ]
    }
  ],
  "metadata": {
    "offset": 0,
    "limit": 10
  }
}

Returns search results according to the given filters

Body

· ProfessionalCreatorSearchRequest

application/json

work_platform_id string required

Target platform to search public profiles on

follower_count object

Filter profiles by follower count

content_count object

Filter profiles by content count

has_contact_details boolean

Filter profiles by availability of contact details

last_post_timestamp string · date-time

Filter profiles by the timestamp (ISO 8601) of last post

average_likes object

Filter profiles by average likes

average_comments object

Filter profiles by average comments

average_shares object

Filter profiles by average shares

Body

Responses