External API for accessing VwD creators data.
https://api.vwd.ai/api/public/v1/
https://apidocs.vwd.ai/_mock/apis/
Full-text search across creator names, summaries, and associated post content powered by Elasticsearch. Supports boolean keyword logic (AND/OR/NOT), exact phrase matching, platform filtering, list filtering, and multiple sort options.
Results are automatically scoped to the organization associated with the API key.
Free-text search query matched against the creator's name, summary, and associated post content. Maximum 500 characters.
When true the query is treated as an exact phrase — the words must appear consecutively and in the given order. When false (default) the query is tokenised and matched with partial/fuzzy logic.
AND logic — every keyword in this list must be present in the matching post content. Maximum 10 items, each up to 200 characters.
NOT logic — none of the keywords in this list should appear in the matching post content. Maximum 10 items, each up to 200 characters.
OR logic — at least one keyword from this list must be present in the matching post content. Maximum 10 items, each up to 200 characters.
Sort order for results. Use relevance (default) to rank by search score. Prefix a field name with - for descending order.
Number of results per page (1–100). Defaults to 10.
https://api.vwd.ai/api/public/v1/search/creators/
https://apidocs.vwd.ai/_mock/apis/search/creators/
curl -i -X POST \
https://api.vwd.ai/api/public/v1/search/creators/ \
-H 'Authorization: Api-Key YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"q": "sustainable fashion",
"exact": false,
"must_include_all": [
"vegan",
"organic"
],
"must_not_include": [
"spam"
],
"may_include_any": [
"eco-friendly",
"green"
],
"sort_by": "-followers_reach",
"page": 1,
"page_size": 10,
"filters": {
"platforms": [
"instagram",
"tiktok"
],
"influencer_id": 12345,
"list_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}'{ "count": 42, "total_pages": 5, "page": 1, "page_size": 10, "results": [ { … } ] }
Full-text search across post content (captions, descriptions, transcripts) powered by Elasticsearch. Supports boolean keyword logic (AND/OR/NOT), exact phrase matching, platform filtering, list filtering, and sorting by relevance or date.
Results are automatically scoped to the organization associated with the API key.
Free-text search query matched against post content. Maximum 500 characters.
When true the query is treated as an exact phrase — the words must appear consecutively and in the given order. When false (default) the query is tokenised and matched with partial/fuzzy logic.
AND logic — every keyword in this list must be present in the post content. Maximum 10 items, each up to 200 characters.
NOT logic — none of the keywords in this list should appear in the post content. Maximum 10 items, each up to 200 characters.
OR logic — at least one keyword from this list must be present in the post content. Maximum 10 items, each up to 200 characters.
Sort order for results. relevance (default) ranks by search score. posted_at sorts chronologically (oldest first), -posted_at sorts reverse-chronologically (newest first).
Number of results per page (1–100). Defaults to 10.
https://api.vwd.ai/api/public/v1/search/posts/
https://apidocs.vwd.ai/_mock/apis/search/posts/
curl -i -X POST \
https://api.vwd.ai/api/public/v1/search/posts/ \
-H 'Authorization: Api-Key YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"q": "brand partnership",
"exact": false,
"must_include_all": [
"sponsored",
"ad"
],
"must_not_include": [
"giveaway"
],
"may_include_any": [
"collab",
"partnership"
],
"sort_by": "-posted_at",
"page": 1,
"page_size": 10,
"filters": {
"platforms": [
"instagram",
"youtube"
],
"influencer_id": 12345,
"list_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}'{ "count": 128, "total_pages": 13, "page": 1, "page_size": 10, "results": [ { … } ] }
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.