ProvlyDocs

Search docs

Guides and API endpoints

DocsGet startedQuickstart

Quickstart

Make your first request in under a minute.

  1. 1

    Pick a plan with API access

    The public API and the MCP server are included in the Pro and Business plans. Compare plans.

  2. 2

    Create an API key

    Open Provly → Settings → API and click Create key. Copy it right away: the full key is shown only once.

    Open API settings

  3. 3

    Call the API

    Every request sends the key in the Authorization header.

    export PROVLY_API_KEY="pvly_live_…"

curl "https://provly.co/api/v1/ads?query=collagen&countries=TR&active=true&min_running_days=30&limit=5" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
  4. 4

    Or plug it into your AI assistant

    Point Claude, ChatGPT or Cursor at the MCP server and ask in plain language. See MCP server.

Ads that are still active and have run for 30+ days are usually profitable: active=true&min_running_days=30 is the single most useful filter for product research.