Skip to main content

​
API Reference v2

Use /api/v2 for DumplingAI’s Unified API Platform. This is the new API lane for technical users who want either:
  • standardized capabilities
  • direct access to exact managed provider endpoints

​
Two ways to use /api/v2

​
Capabilities

Use capabilities when you want the simplest possible request shape. Examples:
  • google_search
  • scrape_page
  • get_youtube_transcript

​
Provider endpoints

Use provider endpoints when you want the exact upstream provider endpoint. Examples:
  • serper.search
  • perplexity.search
  • firecrawl.scrape
  • transcriptapi.youtube_transcript
  • transcriptapi.youtube_search
  • dataforseo.dataforseo_labs_google_keyword_ideas

​
What OpenAPI covers here

The OpenAPI spec documents the real transport endpoints under /api/v2:
  • search
  • details
  • run
  • balance
  • usage
  • transactions
Capabilities, providers, and endpoints are documented through the Unified API Platform Workbench pages rather than fake per-operation HTTP paths. Use the canonical execution request shape when calling /api/v2/run: 
{
  "type": "capability",
  "id": "google_search",
  "input": {
    "query": "best seo keywords for plumbers in nyc"
  }
}
Or for a provider endpoint: 
{
  "type": "endpoint",
  "id": "firecrawl.scrape",
  "input": {
    "url": "https://example.com",
    "format": "markdown"
  }
}