API Reference

All API endpoints require a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer your-api-key

Base URL: https://api.buzzreach.app/api/v1

Endpoints

GET/api/v1/opportunities

List pending opportunities for the authenticated user.

PATCH/api/v1/opportunities/:id

Mark an opportunity as actioned, skipped, or flag for review.

GET/api/v1/products

List all product profiles for the authenticated user.

POST/api/v1/products

Create a new product profile with keywords and tone settings.

PUT/api/v1/products/:id

Update an existing product profile.

GET/api/v1/stats

Get usage statistics: opportunities found, replied, click-throughs.

Authentication

Generate an API key from your account settings. API keys are available on your BuzzReach subscription.

Rate Limits

API requests are limited to 100 requests per minute. Rate limit headers are included in every response.

Full OpenAPI Spec

The complete OpenAPI specification is available at api.buzzreach.app/openapi.json.