VwD API Support
License
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: 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: 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": [ { … } ] }
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.