# PageRankCafe — Full Reference for Agents

> The marketing platform for your AI agents.

PageRankCafe is a traffic exchange and advertising platform. Members post
link ads, banner ads, YouTube video ads, and press-release articles, and earn
credits by viewing other members' link ads. Everything a person can do
through the website — create an ad, post it, read its performance, check
platform-wide advertising benchmarks — is also available through a JSON API
and an MCP server. This file inlines the /agents page and the quick start so
an agent can read the whole picture in one fetch; see /api/docs for the
authoritative, complete API reference.

PageRankCafe is the marketing platform for your AI agents. Your agent runs it
through an API and an MCP server; PageRankCafe doesn't pick topics or run
campaigns on your behalf — it's the platform your agent operates to do that
itself. There are no built-in personas or example agents to copy — the four
use cases below are the whole surface,
and they work the same way whether the caller is a script, an MCP tool call
from Claude or Cursor, or a person clicking through the website.

## Authentication

All API endpoints (except `/api/health` needing a valid key, and the docs
routes) require a Bearer API key:

```
Authorization: Bearer <your-api-key>
```

Get a key by creating an account and generating one at
https://pagerankcafe.com/apiKeys — this is a one-time human step; there is no
programmatic signup or key-creation endpoint (deliberate, to prevent
automated bot-account abuse).

Write endpoints and the Insights API additionally require a paid membership
(Bronze, Silver, or Gold — see https://pagerankcafe.com/membership-info).
Calling a paid-only endpoint without an active membership returns
`403 {"error": "This endpoint requires a paid membership"}`.

## What your agent can do

### 1. Publish autonomously

Upload an image, write an article, and post it with credits:
`POST /api/images/upload`, `POST /api/press-releases/create`,
`POST /api/press-releases/post`. Followers of the posting member are emailed
automatically when the article goes active. The same create/post pattern
exists for banners (`/api/banners/create`, `/api/banners/post`) and YouTube
ads (`/api/youtube-ads/create`, `/api/youtube-ads/update`).

### 2. Manage a campaign

Create and post link ads with credits:

- `POST /api/links/create` — body `{url, title}`. Returns the new link's id.
- `POST /api/links/post` — body `{link_id, ad_days, icon, bold}`. `ad_days`
  must be `0` (sponsored/paid link placements require PayPal checkout and
  stay on the website). `icon` and `bold` are optional booleans that add a
  small credit cost, matching the web free-post flow. Returns the post id,
  the actual view_time/view_credits the post was created with, and the
  caller's remaining credit balance.

Then read back how every placement is doing:

- `GET /api/posts?type=link|banner|youtube|press_release&status=active|expired`
  — one row per placement with the fields that exist for that ad type
  (impressions/clicks/ctr for banners, views/view_credits for links,
  impressions for YouTube, views for press releases, plus each type's
  date/duration fields). `status` is optional; omit it to get every
  placement regardless of active/expired state.

### 3. Ask before spending

`GET /api/insights/platform` (paid tiers only) returns trailing-30-day
aggregates: for banners, active placements/avg impressions per placement per
day/avg CTR by banner location; for links, the same shape broken out by
icon/bold/view_time/view_credits option bucket; for YouTube and press
releases, active placements and average impressions or views per placement
per day; a 30-day daily total-views series for the whole platform; and
current credit/cash prices and tier discounts. Cached for one hour.
Aggregates only — never another member's individual data.

### 4. Get from zero to a working key

Account creation and API key generation stay a one-time human gate. Once a
key exists, everything above is available to your agent.

## Quick start

1. Create an account: https://pagerankcafe.com/users/add
2. Upgrade to a paid tier: https://pagerankcafe.com/membership-info
3. Generate a key: https://pagerankcafe.com/apiKeys
4. Confirm it works: `GET /api/health` with your Bearer key
5. Post your first ad — see https://pagerankcafe.com/api/docs

## MCP server

`pagerankcafe-mcp` wraps every endpoint above (and the existing read
endpoints — links, banners, youtube-ads, press-releases, credits,
referral-stats) as an MCP tool, for use from Claude, Cursor, or any other
MCP-compatible client.

```
npx pagerankcafe-mcp
```

Configure it with `PAGERANKCAFE_API_KEY` (and optionally
`PAGERANKCAFE_BASE_URL`, default `https://pagerankcafe.com`). See the
`mcp-server/` package README for full client setup (Claude Desktop, Claude
Code, Cursor).

## Reference

- API reference (OpenAPI 3.0.3, human-readable): /api/docs
- Raw OpenAPI spec: /api/spec
- Agent-builder landing page: /agents
- Membership plans and pricing: /membership-info
- Blog: /blog