# BRAINIAC Hashtag Analyze

> BRAINIAC Hashtag Analyze is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-17).

Analyzes hashtags from supplied social media post data to report usage counts, impressions, and engagement metrics without scraping or publishing

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/social-content/hashtag-analyze?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-hashtag-analyze-b38cedc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1UQjaBqQx1cXFxvoS01v6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-hashtag-analyze-b38cedc4 -d '<json body>'
```

Example prompt: Analyze the hashtags in these 15 Instagram posts I'm giving you — tell me how many times each hashtag appeared, how many impressions they got based on the post data, and flag any performance patterns you see. I'll supply the post text, likes, comments, and impressions per post.

## When to prefer this

Choose this endpoint when you have your own social post data (text, engagement metrics) and want to compute hashtag-level analytics from it without scraping any platform or publishing anything. It is ideal for agents building social media reports, auditing content strategy, or summarizing hashtag performance from exported data. It is NOT for discovering trending hashtags in real time, scraping live platform data, or scheduling posts.

## Known failure modes

- Missing required fields in posts array (e.g. no text) causing incomplete hashtag extraction
- Hashtag array items missing the required `tag` field, causing validation errors
- Input data too large (text/csv/json fields exceeding 200,000 chars or posts array exceeding 200 items)
- Supplying contradictory impression data between the posts array and the hashtags array
- Payment not completed via x402 on Base, resulting in 402 Payment Required response
- Malformed base64 in file upload causing decoding errors

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with a list of hashtags each containing tag name, post count within the dataset, impressions (if supplied), dataset post count, and whether impression/post data was explicitly provided or inferred. Also includes a checkedAt timestamp, a findings array, a limitations list clarifying that no scraping or publishing occurred, and boolean flags confirming no reach was invented and no posts were removed or published.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "posts": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "text": {
      "type": "string",
      "maxLength": 4000
     },
     "likes": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "saves": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "shares": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "comments": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "platform": {
      "type": "string",
      "maxLength": 40
     },
     "impressions": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "window": {
   "type": "object",
   "required": [
    "start",
    "days"
   ],
   "properties": {
    "days": {
     "type": "integer",
     "maximum": 31,
     "minimum": 1
    },
    "start": {
     "type": "string",
     "maxLength": 40,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "account": {
   "type": "object",
   "properties": {
    "name": {
     "type": "string",
     "maxLength": 80
    },
    "platform": {
     "type": "string",
     "maxLength": 40
    },
    "followers": {
     "type": "integer",
     "maximum": 1000000000,
     "minimum": 0
    }
   },
   "additionalProperties": false
  },
  "comments": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "text": {
      "type
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "checked",
  "scraped": false,
  "findings": [],
  "hashtags": [
   {
    "tag": "#launch",
    "postCount": 2,
    "impressions": 0,
    "datasetPosts": 0,
    "interpretation": "stated",
    "impressionsSupplied": false,
    "datasetPostsSupplied": false
   },
   {
    "tag": "#brand",
    "postCount": 1,
    "impressions": 500,
    "datasetPosts": 10,
    "interpretation": "stated",
    "impressionsSupplied": true,
    "datasetPostsSupplied": true
   }
  ],
  "checkedAt": "2026-11-03T18:00:00.000Z",
  "published": false,
  "limitations": [
   "Engagement metrics are calculated only from numbers supplied in the request.",
   "No account is scraped and no platform restriction is bypassed.",
   "…"
  ],
  "postsRemoved": false,
  "reachInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-hashtag-analyze-b38cedc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
