External API for accessing VwD creators data.
https://api.vwd.ai/api/public/v1/
https://apidocs.vwd.ai/_mock/apis/
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.
Ordering of results. Use a minus (-) prefix for descending order.
Filter by the creator's display name (partial match allowed).
https://api.vwd.ai/api/public/v1/creators/search/
https://apidocs.vwd.ai/_mock/apis/creators/search/
curl -i -X POST \
'https://api.vwd.ai/api/public/v1/creators/search/?include_child_scores=true&limit=10&ordering=-created_at&page=1' \
-H 'Authorization: Api-Key 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_bully": 84,
"drug_content": 84,
"hate_content": 82,
"alcohol_content": 83,
"gambling_content": 82,
"politics_content": 81,
"religion_content": 80,
"youth_content": 79,
"digital_safety": 78
},
"brands": [],
"creators_display_name": "John",
"is_filtered": true
}'{ "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": [ { … } ] }
https://api.vwd.ai/api/public/v1/creators/{id}/
https://apidocs.vwd.ai/_mock/apis/creators/{id}/
curl -i -X GET \
'https://api.vwd.ai/api/public/v1/creators/12345/?include_child_scores=true' \
-H 'Authorization: Api-Key YOUR_API_KEY_HERE'Creator profile. Returns the same shape as the creator list (GET /creators/) plus two PLG-specific blocks: scan_statuses[] (per-scan state, freshness, pipeline stage, available re-scan options) and visibility{} (history window). Pre-PLG creators return scan_statuses: [] and visibility.is_restricted: false.
vwd_score{} is the creator's overall VwD score in your organization's default scoring context (null until scored); GET /creators/{id}/score-reasoning/ explains it.
Age range: our estimate when age_band is listed in autofilled, otherwise what a person entered. age, when set, is always what a person entered. Empty string when unknown.
Which of country, region, gender, age_band and pronoun VwD inferred from the creator's published content rather than a person entering them.
Total compliance violations for this creator broken down by compliance family. Sum of values equals total_compliance_violations. All four keys are always present (zeros when no violations); values are non-negative integers.
Indicates whether the creator is currently being monitored (actively scanned for new content).
Deepest scan tier the calling org has purchased for this creator. null when the org has no scan purchase (pre-PLG creators, or creators returned by the profile endpoint — on GET /creators/{id}/ this field is always null; read scan_statuses[] instead).
Deepest scan tier the calling org has purchased for this creator. null when the org has no scan purchase (pre-PLG creators, or creators returned by the profile endpoint — on GET /creators/{id}/ this field is always null; read scan_statuses[] instead).
Overall VwD score in the calling organization's default scoring context — the number shown on every creator card in the app. null until the creator has been scored (scoring runs once the creator's first scan completes).
Overall VwD score in the calling organization's default scoring context — the number shown on every creator card in the app. null until the creator has been scored (scoring runs once the creator's first scan completes).
Per-scan state rows. Empty array ([]) for pre-PLG creators.
{ "id": 84213, "name": "Kennedy Sur", "deepest_scan": null, "vwd_score": { "score": 72.5, "good_fit": true, "computed_at": "2026-09-08T14:02:11Z" }, "scan_statuses": [ { … } ], "visibility": { "visible_from": "2025-05-18", "visible_until": "2026-05-18", "is_restricted": true, "deeper_scan_available": false, "upgrade_scan_type": null } }
Public API Endpoint
Returns a short plain-text explanation of the creator's overall VwD score — the score in your organization's default scoring context, the same vwd_score returned by GET /creators/{id}/.
The explanation is generated on the first request and cached until the score changes, so the first call for a creator can take a few seconds; later calls return immediately. No token cost.
https://api.vwd.ai/api/public/v1/creators/{id}/score-reasoning/
https://apidocs.vwd.ai/_mock/apis/creators/{id}/score-reasoning/
curl -i -X GET \
https://api.vwd.ai/api/public/v1/creators/12345/score-reasoning/ \
-H 'Authorization: Api-Key YOUR_API_KEY_HERE'The score and its explanation. All fields are null when the creator has not been scored yet. reasoning alone is null when the explanation could not be generated this time — retry later.
Overall VwD score (0-100). null when the creator has not been scored yet.
The explanation. null when the creator has not been scored yet, or when it could not be generated this time — retry later.
{ "score": 72.5, "reasoning": "Strong FTC disclosure record across 205 posts, a large 857K audience, and content that stays clear of the categories this organization avoids.", "reasoning_at": "2026-09-08T14:02:11Z" }
Find creators you do not have yet, see what adding them costs, and add them.
Preview, coming soon. Creator Discovery through the API is not generally available yet. It is in a limited preview, and details may change before release. Until then, these routes answer 403 endpoint_disabled for API keys outside the preview.
The usual flow.
GET /discovery/filters/ for the topics, industries and countries you can filter on.POST /discovery/search/ to find creators.POST /discovery/creators/add/?dry_run=true to see what adding them would cost.POST /discovery/creators/add/ to add them, then GET /creators/{id}/ with each influencer_id.Result limits. Each creator returned by search or by GET /discovery/creators/ counts towards your organization's daily and monthly limits. The request that crosses a limit is still served in full, and the next one gets 429. The daily limit resets at midnight UTC and stops all results. The monthly limit only stops paging further into a result set, so page 1 of a new search still works. These routes also count towards your organization's API rate limit.
Token-budget discovery and scan-catalog endpoints for the prepaid token model that powers creator scans, re-scans, and monitoring.
Prepaid tokens. Billable actions (new scans via POST /creators/, re-scans via POST /creators/{id}/rescan/, monitoring via POST /creators/{id}/monitor/) consume tokens from your organization's API budget. Read the current balance with GET /account/usage/. Token purchasing happens outside the API — contact your account manager to top up.
Scan tiers. A scan tier determines how much creator history is analyzed and the token cost. Initial-scan tiers (scan_1y / scan_2y / scan_full) are used on creator create; re-scan tiers (rescan_lite / rescan_mild / rescan_full) refresh or deepen an existing creator. Costs are admin-configurable — always read GET /scan-catalog/ for live values instead of hardcoding tiers.
Data visibility windows. Historical sub-resources (posts, timeline, brands, compliance) for newly-added creators are scoped to the time range covered by the scan tier purchased. The visibility{} block on GET /creators/{id}/ tells you the exact window and whether a deeper scan is available. Creators added before the token-model launch (2026-05-30) remain unrestricted.
Previewing cost. Append ?dry_run=true on POST /creators/ (single & bulk) or POST /creators/{id}/monitor/ to preview the token cost and outcome without making any change or debiting tokens. Validation still runs.
See the PLG launch changelog post for the full migration guide.