Reach, frequency & GRP calculator API

Compute reach% (uniqueReach/population), average frequency (impressions/uniqueReach), and Gross Rating Points = reach% * frequency, with an effective-frequency rating. Answers 'what are my GRPs','what's my average frequency','am I hitting effective frequency'.

Price$0.01per request

MethodPOST

Route/v1/calc/mkt-reach-frequency

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcmarketingreachfrequencygrpmediaplanningmetrics

API URLhttps://x402.hexl.dev/v1/calc/mkt-reach-frequency

Integration docs

Example request

{
  "uniqueReach": 450000,
  "population": 1500000,
  "impressions": 1800000
}

Example response

{
  "formula": "GRPs = reach% * averageFrequency",
  "reachPercent": 0.3,
  "averageFrequency": 4,
  "grossRatingPoints": 120,
  "rating": "above effective frequency"
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "impressions": {
      "type": "number",
      "examples": [
        1800000
      ]
    },
    "population": {
      "type": "number",
      "description": "target population size",
      "examples": [
        1500000
      ]
    },
    "uniqueReach": {
      "type": "number",
      "description": "unique people reached",
      "examples": [
        450000
      ]
    },
    "reachPercent": {
      "type": "number",
      "description": "alternative to uniqueReach/population, decimal in [0,1]",
      "examples": [
        0.3
      ]
    },
    "frequency": {
      "type": "number",
      "description": "supply directly or derive from impressions/uniqueReach",
      "examples": [
        4
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}