China Marketing AI · Example Payload

China Marketing AI Destination Demand Example

CompanyMarketingChinaGenerative Engine OptimizationMarket IntelligenceMCPAI AgentsBrand Visibility

China Marketing AI Destination Demand Example is an example object payload from China Marketing AI, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

capability_idnameexamples_urlexamples

Example Payload

Raw ↑
{
  "capability_id": "destination_demand_snapshot",
  "name": "Destination Demand Snapshot",
  "examples_url": "/agents/examples/destination-demand.json",
  "examples": [
    {
      "name": "Minimal request",
      "request": {
        "destination": "Tokyo"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Full request",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Payment required",
      "request": {
        "destination": "Tokyo"
      },
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "PAYMENT_REQUIRED",
          "message": "Payment is required before this resource can be accessed.",
          "recoverable": true,
          "suggested_fix": "Attach a valid x402 payment proof for the listed capability price."
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    },
    {
      "name": "Successful paid response",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Degraded source response",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "low",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "limited",
              "freshness": "recent",
              "confidence": "low",
              "limitations": [
                "Source coverage is partial for this request."
              ]
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Source coverage is partial; treat this output as directional until rechecked."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Insufficient input error",
      "request": {},
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "INSUFFICIENT_INPUT",
          "message": "Request parameters failed validation.",
          "recoverable": true,
          "suggested_fix": "Provide destination and retry the request.",
          "missing_fields": [
            "destination"
          ]
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/chinamarketing-ai-destination-demand-example"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.