VwD External API (1.0.0)

External API for accessing VwD creators data.

Download OpenAPI description

index.json

index.yaml

Overview

VwD API Support

hello@vwd.ai

License

MIT

Servers

VwD Production API Server

https://api.vwd.ai/api/public/v1/

Mock server

https://apidocs.vwd.ai/_mock/apis/

Creator Management

Endpoints related to creators information and searches.

Operations

Search and list creators

Request

Public API Endpoint

Use this endpoint to search creators based on various filters, with support for pagination and ordering. This is a POST request and requires an API key for authentication.

Provide filters to narrow down the search results. If no filters are provided, all creators are listed with pagination applied.

Query

limitinteger

Number of results per page.

Example: limit=10

pageinteger

Page number for pagination.

Example: page=1

orderingstring

Ordering of results. Use a minus (-) prefix for descending order.

Enum"created_at""-created_at""followers_reach""-followers_reach"

Example: ordering=-created_at

Bodyapplication/jsonrequired

regionstring

Filter creators by their region.

Example: "europe"

genderstring

Filter creators by gender.

Example: "male"

followers_reachinteger

Minimum follower reach for filtering.

Example: 720000

platformobject

Platform filters (e.g., Instagram, Facebook).

content_alignmentobject

Content alignment filters for various types of content.

brandsArray of strings

Filter by associated brands.

Example: []

creators_display_namestring

Filter by the creator's display name (partial match allowed).

Example: "John"

is_filteredboolean

Whether to apply the filters or not.

Example: true

curl -i -X POST \
  'https://api.vwd.ai/api/public/v1/creators/search/?limit=10&ordering=-created_at&page=1' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "region": "europe",
    "gender": "male",
    "followers_reach": 720000,
    "platform": {
      "instagram": true,
      "facebook": false
    },
    "content_alignment": {
      "language_content": 85,
      "sexual_content": 85,
      "violence_content": 86,
      "cyber_bullying_content": 84,
      "drug_content": 84,
      "hate_content": 82,
      "alcohol_content": 83,
      "gambling_content": 82,
      "politics_content": 81,
      "religion_content": 80
    },
    "brands": [],
    "creators_display_name": "John",
    "is_filtered": true
  }'

Responses

A paginated list of creators matching the provided filters.

Bodyapplication/json

nextstring

URL for the next page of results.

Example: "https://api.vwd.ai/api/public/v1/creators/search/?limit=10&ordering=-created_at&page=2"

previousstring

URL for the previous page of results.

Example: null

total_pagesinteger

Total number of pages available.

Example: 15

totalinteger

Total number of creators matching the filters.

Example: 144

creatorsArray of objects

A list of creators matching the filters.

Response

application/json

{
  "next": "https://api.vwd.ai/api/public/v1/creators/search/?limit=10&ordering=-created_at&page=2",
  "previous": null,
  "total_pages": 15,
  "total": 144,
  "creators": [
    { … }
  ]
}

Retrieve an creator's profile

Request

Public API Endpoint

Use this endpoint to retrieve an creator's profile. Only accessible if the API key is valid and the creators belongs to the organization associated with the API key.

Path

idintegerrequired

The ID of the creators to retrieve.

Example: 12345

curl -i -X GET \
  https://api.vwd.ai/api/public/v1/creators/12345/ \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully retrieved the creators profile.

Bodyapplication/json

idinteger

Example: 10

namestring

Example: "Influencer 1"

photo_urlstring or null

Example: "https://media.vwd.ai/media/creators-profile-pics/influencer.jpg"

regionstring or null

Example: "europe"

genderstring or null

Example: "female"

is_publicboolean

Example: true

followers_reachinteger or null

Example: 500000

follower_reach_normalisedstring

Example: "500 k"

pronounstring or null

Example: "she/her"

ageinteger or null

Example: 28

social_profilesArray of objects

scoresobject

summarystring or null

Example: "Popular lifestyle influencer based in North America"

avg_comments_per_poststring

Example: "150"

avg_likes_per_poststring

Example: "5.2 k"

avg_views_per_videostring

Example: "12.5 k"

total_compliance_violationsinteger

Example: 0

brandsArray of objects

List of associated brands

Response

application/json

{
  "id": 10,
  "name": "Influencer 1",
  "photo_url": "https://media.vwd.ai/media/creators-profile-pics/influencer.jpg",
  "region": "europe",
  "gender": "female",
  "is_public": true,
  "followers_reach": 500000,
  "follower_reach_normalised": "500 k",
  "pronoun": "she/her",
  "age": 28,
  "social_profiles": [
    { … }
  ],
  "scores": {
    "property1": { … },
    "property2": { … }
  },
  "summary": "Popular lifestyle influencer based in North America",
  "avg_comments_per_post": "150",
  "avg_likes_per_post": "5.2 k",
  "avg_views_per_video": "12.5 k",
  "total_compliance_violations": 0,
  "brands": [
    { … }
  ]
}

List all creators

Request

Public API Endpoint

List creators for the authenticated organization with pagination. Response items include associated brands with IDs.

Query

pageinteger

Page number for pagination.

Example: page=1

limitinteger

Number of results per page.

Example: limit=10

include_child_scoresboolean

false (default): return parent category scores only (top-level categories)
true: return both top-level parent categories and child/leaf tags (zero-filled)

Default false

curl -i -X GET \
  'https://api.vwd.ai/api/public/v1/creators/?include_child_scores=false&limit=10&page=1' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully retrieved creators list.

Bodyapplication/json

creatorsArray of objects(CreatorWithBrands)

totalinteger

Total number of creators

Example: 100

countinteger

Number of creators in current page

Example: 10

nextstring or null

URL for next page

Example: "https://api.vwd.ai/api/public/v1/creators/?page=2&limit=10"

Response

application/json

{
  "creators": [
    { … }
  ],
  "total": 100,
  "count": 10,
  "next": "https://api.vwd.ai/api/public/v1/creators/?page=2&limit=10"
}

Brand Management

Endpoints for brand search and management.

Operations

List Management

Endpoints for managing creator lists.

Operations

Content Analysis

Endpoints for retrieving creators posts with labels.

Operations

Brand Mentions

Endpoints for creators posts and timelines related to brands.

Operations

Compliance Monitoring

Endpoints for creators compliance data.

Operations

VwD External API (1.0.0)

Creator Management

Search and list creators

Request

Responses

Was this helpful?

Retrieve an creator's profile

Request

Responses

Was this helpful?

List all creators

Request

Responses

Was this helpful?

Brand Management

List Management

Content Analysis

Brand Mentions

Compliance Monitoring

VwD External API (1.0.0)

Creator Management

Search and list creators

RequestExpand all

Responses

Was this helpful?

Retrieve an creator's profile

Request

Responses

Was this helpful?

List all creators

Request

Responses

Was this helpful?

Brand Management

List Management

Content Analysis

Brand Mentions

Compliance Monitoring

Request