VwD API Support
License
External API for accessing VwD creators data.
https://api.vwd.ai/api/public/v1/
https://apidocs.vwd.ai/_mock/apis/
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.
Compliance framework or specific violation subcategory to filter by.
Top-level frameworks: FTC, FINRA, Healthcare, TTB
FTC subcategories: FTC_PARTNERSHIP, FTC_FALSE_CLAIMS, FTC_FALSE_ADVICE, FTC_COPPA, FTC_PRIVACY
FINRA subcategories: FINRA_FALSE_CLAIMS, FINRA_FALSE_STATEMENTS, FINRA_FALSE_ADVICE, FINRA_COMPARATIVE_STATEMENTS, FINRA_MEMBERSHIP, FINRA_FIGURES
Healthcare subcategories: HEALTHCARE_PERSONAL_INFORMATION, HEALTHCARE_FALSE_INFORMATION, HEALTHCARE_PRODUCT_USE, HEALTHCARE_CLINICAL_INACCURACY, HEALTHCARE_NON_ACCESSIBLE_CONTENT, HEALTHCARE_INFORMATION_LIMITATIONS
TTB subcategories: TTB_LABELING_ACCURACY, TTB_ADVERTISING_CONTENT, TTB_YOUTH_TARGETING, TTB_HEALTH_SAFETY_MESSAGING, TTB_SOCIAL_RESPONSIBILITY, TTB_SPONSORSHIP_EVENT, TTB_PRODUCT_PACKAGING, TTB_DIGITAL_SOCIAL_MEDIA
https://api.vwd.ai/api/public/v1/creators/{id}/compliance-timeline/
https://apidocs.vwd.ai/_mock/apis/creators/{id}/compliance-timeline/
curl -i -X GET \
'https://api.vwd.ai/api/public/v1/creators/{id}/compliance-timeline/?compliance_key=FTC' \
-H 'Authorization: YOUR_API_KEY_HERE'[ { "year": 2024, "months": [ … ] } ]
Compliance framework or specific violation subcategory to filter by.
Top-level frameworks: FTC, FINRA, Healthcare, TTB
FTC subcategories: FTC_PARTNERSHIP, FTC_FALSE_CLAIMS, FTC_FALSE_ADVICE, FTC_COPPA, FTC_PRIVACY
FINRA subcategories: FINRA_FALSE_CLAIMS, FINRA_FALSE_STATEMENTS, FINRA_FALSE_ADVICE, FINRA_COMPARATIVE_STATEMENTS, FINRA_MEMBERSHIP, FINRA_FIGURES
Healthcare subcategories: HEALTHCARE_PERSONAL_INFORMATION, HEALTHCARE_FALSE_INFORMATION, HEALTHCARE_PRODUCT_USE, HEALTHCARE_CLINICAL_INACCURACY, HEALTHCARE_NON_ACCESSIBLE_CONTENT, HEALTHCARE_INFORMATION_LIMITATIONS
TTB subcategories: TTB_LABELING_ACCURACY, TTB_ADVERTISING_CONTENT, TTB_YOUTH_TARGETING, TTB_HEALTH_SAFETY_MESSAGING, TTB_SOCIAL_RESPONSIBILITY, TTB_SPONSORSHIP_EVENT, TTB_PRODUCT_PACKAGING, TTB_DIGITAL_SOCIAL_MEDIA
https://api.vwd.ai/api/public/v1/creators/{id}/compliance-posts/
https://apidocs.vwd.ai/_mock/apis/creators/{id}/compliance-posts/
curl -i -X GET \
'https://api.vwd.ai/api/public/v1/creators/{id}/compliance-posts/?compliance_key=FTC&month=0&year=0' \
-H 'Authorization: YOUR_API_KEY_HERE'[ { "id": 12345, "platform_name": "Instagram", "date": "January 1, 2024", "link": "https://instagram.com/post/12345", "reasons": [ … ], "brands": [ … ], "is_dismissed": false, "article_title": "string", "image_url": "string", "article_text": "string", "source_name": "string" } ]