Thisispaper Intelligence

The curated-taste API

Search, similarity and metadata over 2,491 hand-selected architecture, design, photography and art projects. One curator, two decades of editorial judgement, exposed as a clean HTTP API.

Base URL

https://www.thisispaper.com/intelligence/api/v1

All endpoints are GET, return JSON, and are CORS-open for browser apps.

Authentication

Pass your key as a bearer token (or ?key= for quick tests):

curl "https://www.thisispaper.com/intelligence/api/v1/search?q=concrete+chapel" \
  -H "Authorization: Bearer tip_live_..."

Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers.

Endpoints

GET /search

Lexical search across name, studio, city, category and intro.

GET /search?q=japanese+teahouse&limit=10

{
  "query": "japanese teahouse",
  "count": 10,
  "results": [
    {
      "slug": "audeum-kengo-kuma",
      "name": "Audeum by Kengo Kuma",
      "studio": "Kengo Kuma & Associates",
      "city": "Seoul", "year": "2024",
      "category": "Architecture",
      "intro": "...",
      "thumbnail": "https://cdn.../...webp",
      "url": "https://www.thisispaper.com/mag/audeum-kengo-kuma",
      "score": 8.42
    }
  ]
}

GET /project/{slug}

Full metadata for one project, including description and design language.

GET /project/audeum-kengo-kuma

GET /similar/{slug}

Nearest projects by visual + semantic similarity (precomputed SigLIP neighbours).

GET /similar/audeum-kengo-kuma?limit=12

For AI agents (MCP)

The same catalog is available as a remote Model Context Protocol server (Streamable HTTP, stateless), so Claude and other AI agents can query it natively:

https://www.thisispaper.com/intelligence/api/mcp

TOOL search_projects

Search the curated catalog by keywords. Returns ranked project summaries.

TOOL similar_projects

Visual + semantic neighbours for a project slug.

TOOL get_project

Full metadata for one project: description, details, dimensions, URL.

TOOL get_api_key

Mints a free API key (200 calls/month) for your email, right from the conversation.

Without a key the tools run in anonymous preview mode (5 results max). Add Authorization: Bearer tip_live_... to the connector for full, metered access.

On claude.ai or the Claude apps: Settings → Connectors → Add custom connector, then paste the URL above. In Claude Code:

claude mcp add --transport http thisispaper \
  https://www.thisispaper.com/intelligence/api/mcp

Or in a JSON MCP config (Claude Desktop via mcp-remote, or any client that speaks Streamable HTTP):

{
  "mcpServers": {
    "thisispaper": {
      "command": "npx",
      "args": ["mcp-remote", "https://www.thisispaper.com/intelligence/api/mcp"]
    }
  }
}

Any MCP client works; no session or OAuth handshake is required.

Pricing

Free

€0

200 calls / month

Personal use and evaluation.

API Studio

€29/mo

5,000 calls / month

Commercial use.

Upgrade to Studio

API Pro

€99/mo

25,000 calls / month

Commercial use, priority support.

Upgrade to Pro

Pay with the same email your key was issued to and the upgrade applies automatically.

Get a free key

Enter your email. Your key is shown once — store it somewhere safe.