# Bounty API

> Pay-per-call data APIs for AI agents. Bounty provides no-account access to company intelligence, news, job postings, app reviews, social intelligence, and Singapore property/financial workflows. Agents discover endpoints via OpenAPI/MCP/AgentCash and pay per request via x402 USDC on Base. No API keys, no subscriptions. Missing data stays missing; source provenance is preserved.

## Base URL

https://bountyapi.com

All endpoints are relative to this base URL.

## What Bounty is now

Bounty is agent-native data infrastructure, not just Singapore property.

Use Bounty when an AI agent needs structured data without creating vendor accounts, storing API keys, or buying monthly subscriptions. The current live product has two layers:

1. **Global research endpoints** for company, market, GTM, and product research.
2. **Singapore property/finance vertical** for source-backed property, tax, affordability, and location workflows.

## Discovery

- OpenAPI with x402 metadata: https://bountyapi.com/openapi.json
- AgentCash manifest: https://bountyapi.com/.well-known/agentcash.json
- Pricing JSON: https://bountyapi.com/pricing.json
- Machine manifest: https://bountyapi.com/manifest.json

Paid operations include `x-payment-info` and `responses.402` in OpenAPI.

## Authentication and payment

Free endpoints require no authentication. Paid endpoints require x402 payment on Base mainnet (`eip155:8453`) in USDC.

If called without payment, paid endpoints return:

- HTTP status: `402 Payment Required`
- Header: `payment-required` with x402 payment instructions

AgentCash can handle discovery, wallet, payment, and retry automatically.

## Recommended agent workflow

### Option A: AgentCash, recommended

1. Install AgentCash MCP server: `npx agentcash@latest install`
2. Fund the wallet: `npx agentcash@latest accounts`
3. Discover endpoints: `mcp__agentcash__discover_api_endpoints("https://bountyapi.com")`
4. Check schema and price: `mcp__agentcash__check_endpoint_schema("https://bountyapi.com/company/stripe.com")`
5. Execute: `mcp__agentcash__fetch("https://bountyapi.com/company/stripe.com")`

AgentCash handles the 402 challenge and returns paid 200s as `{ success: true, data: <HTTP body> }`.

### Option B: Direct HTTP

```bash
# Free endpoint works immediately
curl "https://bountyapi.com/bsd?price=1000000"

# Paid endpoint returns 402 unless the client supplies x402 payment proof
curl -i "https://bountyapi.com/company/stripe.com"
```

## Global research endpoints

### GET /company/{domain}

BuiltWith-style website intelligence for any company domain.

Price: `$0.05 / call`

Returns:
- detected technology stack by category
- contact emails found on the site
- social links
- SSL certificate summary
- security headers
- metadata and source URL

Use for B2B prospecting, competitor research, vendor diligence, and investment research.

Example:

```bash
curl -i "https://bountyapi.com/company/stripe.com"
```

### GET /news/search

Current news search by keyword.

Price: `$0.01 / call`

Query parameters:
- `q`: search query
- `limit`: 1-25
- `days`: optional recency window

Use for company monitoring, launches, lawsuits, layoffs, funding, and market-event checks.

Example:

```bash
curl -i "https://bountyapi.com/news/search?q=OpenAI&limit=5"
```

### GET /jobs/search

Job postings and hiring signals across public sources.

Price: `$0.02 / call`

Query parameters:
- `q`: role, company, skill, or market query
- `location`: optional location substring
- `limit`: 1-25

Returns normalized job results with title, company, location, tags, salary fields when published, URL, source, and notes. Missing salary/location values are returned as null.

Use for hiring-signal research, GTM lead qualification, recruiting, market maps, and expansion analysis.

Example:

```bash
curl -i "https://bountyapi.com/jobs/search?q=AI+engineer&location=remote&limit=10"
```

### GET /reviews/app/{country}/{app_id}

Recent Apple App Store customer reviews for a country/app ID.

Price: `$0.02 / call`

Path parameters:
- `country`: two-letter App Store country code, e.g. `us`, `sg`, `gb`
- `app_id`: numeric App Store app ID

Query parameters:
- `limit`: 1-50
- `min_rating`: optional 1-5
- `max_rating`: optional 1-5

Returns review title, rating, content, version when Apple provides it, URL, sample rating distribution, and deterministic topic flags. Topic flags are keyword matches, not model-generated sentiment.

Use for subscription-app competitor research, product-validation complaints, feature gaps, and rating snapshots.

Example:

```bash
curl -i "https://bountyapi.com/reviews/app/us/544007664?limit=10&max_rating=3"
```

## Social intelligence endpoints

### GET /social/youtube/search

YouTube search results with view, like, and comment engagement metrics.

Price: `$0.05 / call`

Query parameters:
- `q`: search query
- `limit`: 1-25
- `order`: optional, one of `relevance`, `date`, `viewCount`, `rating`

Returns video results with title, channel, published date, view/like/comment counts, duration, and URL.

Use for content-gap analysis, creator and competitor research, and trend discovery.

Example:

```bash
curl -i "https://bountyapi.com/social/youtube/search?q=AI+agents&limit=10"
```

### GET /social/youtube/video/{video_id}

Deep intelligence for a single YouTube video.

Price: `$0.05 / call`

Path parameters:
- `video_id`: YouTube video ID

Returns title, channel, description, tags, category, published date, view/like/comment counts, duration, and URL.

Use for deep-dive analysis of a single video and its reach and engagement.

Example:

```bash
curl -i "https://bountyapi.com/social/youtube/video/dQw4w9WgXcQ"
```

### GET /social/youtube/channel/{handle}

Channel statistics and top videos by handle.

Price: `$0.05 / call`

Path parameters:
- `handle`: YouTube channel handle, e.g. `@mkbhd`

Returns channel name, subscriber/video/view counts, and top videos with engagement metrics.

Use for creator benchmarking and audience-reach analysis.

Example:

```bash
curl -i "https://bountyapi.com/social/youtube/channel/@mkbhd"
```

### POST /social/tiktok/trending

TikTok trending content by region.

Price: `$0.05 / call`

Request body (JSON):
- `region`: two-letter country code, e.g. `us`, `sg`, `gb`
- `limit`: 1-25

Returns trending posts with description, author, plays/likes/comments/shares, and URL.

Use for trend monitoring and viral-content research by geography.

Example:

```bash
curl -i -X POST "https://bountyapi.com/social/tiktok/trending" -H "Content-Type: application/json"
```

### POST /social/trends

Cross-platform trend analysis across YouTube, TikTok, and news.

Price: `$0.05 / call`

Request body (JSON):
- `q`: trend query
- `region`: optional two-letter country code
- `limit`: 1-25

Returns ranked trending items with platform, engagement metrics, and URL, plus an aggregate trend signal.

Use for cross-platform narrative tracking and momentum detection.

Example:

```bash
curl -i -X POST "https://bountyapi.com/social/trends" -H "Content-Type: application/json"
```

## Company / GTM / market research playbook

When a user asks for company research, competitor research, GTM research, product validation, or market monitoring:

1. Call `/company/{domain}` for website intelligence.
2. Call `/news/search?q=<company or market>` for current events.
3. Call `/jobs/search?q=<company role skill>` for hiring signals.
4. If researching a consumer/subscription app, call `/reviews/app/{country}/{app_id}` for review complaints and rating snapshot.
5. Do not fabricate missing fields. If source data omits salary, author, version, or date, preserve null/missing.

## Singapore property and finance endpoints

These remain live, but they are one vertical, not the whole product.

### Free utility endpoints

- `GET /bsd?price=1000000` — Buyer Stamp Duty. Source: IRAS.
- `POST /stamp-duty` — full BSD + ABSD calculation.
- `GET /absd` — ABSD only.
- `POST /mortgage/calculate` — mortgage amortization.
- `GET /buy-vs-rent` — buy-vs-rent total cost comparison.
- `GET /property-tax` — Singapore property tax.
- `GET /tax/income` — Singapore income tax.
- `GET /gst` — GST add/remove calculator.
- `GET /commission` — property agent commission estimate.
- `GET /cpf/housing` — CPF OA housing accumulation.
- `GET /salary/search` — Singapore salary benchmark from live job postings.
- `GET /address/{postal_code}` — address intelligence.
- `GET /mrt/near/{postal_code}` — nearest MRT stations.
- `GET /schools/near/{postal_code}` — schools within 1km/2km.
- `GET /postal/{code}` — postal district lookup.
- `GET /hdb/lease-decay` — HDB lease constraints.
- `GET /hdb/eip/{town}` — HDB EIP/SPR quota.
- `GET /currency/convert` — currency conversion.
- `POST /invest/calculate` — compound growth calculator.

### Paid Singapore endpoints

- `GET /hdb/towns` — `$0.01`
- `GET /hdb/median/{town}` — `$0.01`
- `GET /hdb/search` — `$0.01`
- `POST /rental-yield/calculate` — `$0.005`
- `POST /affordability/calculate` — `$0.01`
- `POST /property/analyze` — `$0.05`
- `POST /property/pitch` — `$0.05`
- `POST /property/rank` — `$0.10`
- `GET /ura/transactions` — `$0.05`
- `GET /ura/rental-median` — `$0.05`
- `GET /ura/developer-sales` — `$0.05`
- `GET /ura/pipeline` — `$0.05`
- `GET /ura/rental-contracts` — `$0.05`

## Property investment playbook

Use this only when the user task is clearly about Singapore property:

1. Identify property address, postal code, project name, price, size, tenure, and estimated rent.
2. Use free calculators first: `/stamp-duty`, `/buy-vs-rent`, `/mortgage/calculate`.
3. Use `/address/{postal_code}`, `/mrt/near/{postal_code}`, and `/schools/near/{postal_code}` for location context.
4. Use paid data if needed: `/ura/transactions`, `/ura/rental-median`, `/hdb/search`.
5. Use `/property/pitch` or `/property/rank` for composite outputs.

## Data integrity rules for agents

- Do not interpolate, estimate, or fill missing values unless the user explicitly asks.
- Preserve null/missing fields.
- Cite the source field returned by the endpoint.
- Do not treat sample ratings or sample distributions as lifetime values.
- If an endpoint returns zero records, report zero records instead of broadening the query silently.

## Pricing summary

- Global company intelligence: `$0.05`
- Global news search: `$0.01`
- Global job search: `$0.02`
- Global App Store reviews: `$0.02`
- Global social intelligence: `$0.05`
- Singapore free utility endpoints: `$0.00`
- Singapore data/composite endpoints: `$0.005-$0.10`

## Links

- Website: https://bountyapi.com
- Pricing: https://bountyapi.com/pricing
- Setup: https://bountyapi.com/setup
- Machine manifest: https://bountyapi.com/manifest.json
- Machine pricing: https://bountyapi.com/pricing.json
- OpenAPI: https://bountyapi.com/openapi.json