Occurrence Counter

Overview

You pass text (or a file_ref) and one or more literal or regex patterns; we return per-pattern occurrence counts with optional match offsets. Regex uses RE2/J (linear-time, ReDoS-safe). Do not use this for semantic entity extraction.

Batch pattern counting with per-pattern results saves round-trips and avoids LLM miscounting.

When to use it

Scope

Non-goals

• Does not perform semantic analysis
• Does not extract entities
• Regex has safety limits (max pattern length, max pattern count)

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"text.count_occurrences","input":{"text":"hello world hello","patterns":[{"id":"hello","value":"hello","type":"literal"}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("text.count_occurrences", {"patterns":[{"type":"literal","id":"hello","value":"hello"},{"type":"literal","id":"world","value":"world"}],"text":"hello world hello"});

Errors

Other limits

Limitations

• Does not perform semantic analysis
• Does not extract entities
• Regex has safety limits (max pattern length, max pattern count)
• Entity extraction (use NLP tools)

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "text.count_occurrences",
  "input": {
    "patterns": [
      {
        "type": "literal",
        "id": "hello",
        "value": "hello"
      },
      {
        "type": "literal",
        "id": "world",
        "value": "world"
      }
    ],
    "text": "hello world hello"
  }
}

Examples

{
  "patterns": [
    {
      "type": "literal",
      "id": "hello",
      "value": "hello"
    },
    {
      "type": "literal",
      "id": "world",
      "value": "world"
    }
  ],
  "text": "hello world hello"
}

{
  "policy": "multi_pattern",
  "normalized": false,
  "normalization": "none",
  "skill": "text.count_occurrences",
  "counts": [
    {
      "id": "hello",
      "count": 2
    },
    {
      "id": "world",
      "count": 1
    }
  ],
  "warnings": [],
  "total_count": 3,
  "case_sensitive": true,
  "unit": "occurrence",
  "overlap": false
}

{
  "text": "HELLO hello Hello",
  "case_sensitive": false,
  "patterns": [
    {
      "type": "literal",
      "id": "hello",
      "value": "Hello"
    }
  ]
}

{
  "policy": "multi_pattern",
  "normalized": false,
  "normalization": "none",
  "skill": "text.count_occurrences",
  "counts": [
    {
      "id": "hello",
      "count": 3
    }
  ],
  "warnings": [],
  "total_count": 3,
  "case_sensitive": false,
  "unit": "occurrence",
  "overlap": false
}

Recommended use cases

• Multi-keyword frequency analysis
• Content audit
• Pattern density measurement

Avoid for

• Entity extraction (use NLP tools)

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags