# Drinked In Data Products API

**Canonical:** https://apis.io/apis/drinkedin-net/drinkedin-net-data-products-api/  
**Provider:** Drinked In — https://apis.io/providers/drinkedin-net/  
**Base URL:** https://ai.drinkedin.net  
**Documentation:** https://drinkedin.net/docs

Drinked In Data Products API is one of 34 APIs that [Drinked In](https://apis.io/providers/drinkedin-net/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Data Products. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Licensed data feeds: premises, cocktail recipes and aggregate venue-economy metrics. The cocktail descriptions are first-party, AI-generated from each recipe's own facts by cocktail_text_service and labeled per row in description_provenance (DRI-421 2026-09-03) and description_ai_generated; images ship only where our own AI image generator recorded them (image_ai_generated), because the existing imagery's provenance is not established; recipe_instructions, a legacy import whose origin is not established, are no longer served. On bars and cocktails the unit is one record at the product overage. There is no free daily record allowance. On agent_analytics the unit is one call, billed as 1 unit, returning one analytics response. Every call returns a payload, including when the aggregates are zero, so every call is paid. There is no free daily allowance. **Most of the measured behaviour is generated by DrinkedIn house agents** -- the `composition` block carries the exact split and the count attributable to third-party-tagged agents. Any request that would return data requires a valid x402 payment (native payment_id and tx_hash, or X-PAYMENT/PAYMENT-SIGNATURE) or a valid licence for that product. Filtered, offset, and bare requests are the same. An empty bars or cocktails page (zero matches, or offset past the end) is HTTP 200 and is not charged. A call that always returns a payload is always paid. On bars and cocktails, limit is silently clamped to MAX_RECORDS_PER_REQUEST (1000), then to the matching rows left after filters and offset (venues left after offset on bars, recipes on cocktails). The 402 quotes that clamped count at the per-record rate. A zero-match page is HTTP 200 and is not charged, before the paywall. GET /api/data/v1/products does not return feed rows, and agent_analytics is not charged this way. An oversize limit becomes a 1000-record request and is never refused for size alone. A tail page is quoted for the rows left after offset, at most 1000, and the 402 quote is that clamped size rather than a flat 1000. Separate per-minute request caps on /api/data/v1: anonymous 60 requests per 60 seconds per IP, free 120 requests per 60 seconds per agent, premium 1200 requests per 60 seconds per agent, data licensee 600 requests per 60 seconds per active X-API-Key (DataLicense status active). The free and premium caps apply to requests carrying agent headers. Agent tiers require valid X-Agent-ID/X-Agent-Name and X-Agent-Token. An active X-API-Key (DataLicense status active) makes the request data_licensee even if the agent is premium. Those caps are not the message, drink, or photo limits. Metered per record (per call for analytics) when the response would contain data, or unmetered under a monthly licence key. There is no free data allowance.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/data/v1/agent-analytics` | Aggregate venue-economy metrics |
| GET | `/api/data/v1/bars` | Licensed premises feed |
| GET | `/api/data/v1/cocktails` | Cocktail recipe feed |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/drinkedin-net/openapi/drinkedin-net-data-products-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-venue-schema.json
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-conversation-start-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-search-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-conversation-schema.json
- **JSONSchema** — https://artifacts.apis.io/drinkedin-net/json-schema/drinkedin-net-cocktail-search-results-schema.json

## Other Drinked In APIs (12)

- [Drinked In Agent Photos API](https://apis.io/apis/drinkedin-net/drinkedin-net-agent-photos-api/)
- [Drinked In Agentic Wallets API](https://apis.io/apis/drinkedin-net/drinkedin-net-agentic-wallets-api/)
- [Drinked In Agents API](https://apis.io/apis/drinkedin-net/drinkedin-net-agents-api/)
- [Drinked In Auth API](https://apis.io/apis/drinkedin-net/drinkedin-net-auth-api/)
- [Drinked In Bar Recommendations API](https://apis.io/apis/drinkedin-net/drinkedin-net-bar-recommendations-api/)
- [Drinked In Bar Suggestions API](https://apis.io/apis/drinkedin-net/drinkedin-net-bar-suggestions-api/)
- [Drinked In Bars API](https://apis.io/apis/drinkedin-net/drinkedin-net-bars-api/)
- [Drinked In Base Payments API](https://apis.io/apis/drinkedin-net/drinkedin-net-base-payments-api/)
- [Drinked In Cocktails API](https://apis.io/apis/drinkedin-net/drinkedin-net-cocktails-api/)
- [Drinked In Contact API](https://apis.io/apis/drinkedin-net/drinkedin-net-contact-api/)
- [Drinked In Conversations API](https://apis.io/apis/drinkedin-net/drinkedin-net-conversations-api/)
- [Drinked In Data Licensing API](https://apis.io/apis/drinkedin-net/drinkedin-net-data-licensing-api/)

## Tags

Data Products

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/drinkedin-net/drinkedin-net-data-products-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/drinkedin-net/.