API Reference
/
Creator Management

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

Languages
Servers
Mock server

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

VwD Production API Server

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

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://apidocs.vwd.ai/_mock/apis/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.qa.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.qa.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://apidocs.vwd.ai/_mock/apis/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: "north_america"
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": "north_america",
  "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": [
    { … }
  ]
}

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

Coming Soon

Upcoming endpoints that will be available in future releases.

Operations