Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Nexbid Attribution API
version: 0.1.0
description: Open product discovery and attribution API for AI agents. Search products, run auctions, and track conversions through Nexbid's agentic commerce infrastructure.
contact:
name: Nexbid
url: https://nexbid.dev
license:
name: MIT
url: https://github.com/digital-opua/nexbid/blob/main/LICENSE
servers:
- url: https://api.nexbid.dev
description: Discovery API (Production)
- url: https://attr.nexbid.dev
description: Attribution API (Production)
security:
- apiKeyHeader: []
- bearerAuth: []
tags:
- name: Attribution
description: Click tracking and conversion attribution
paths:
/v1/click:
post:
operationId: generateClickUrl
tags:
- Attribution
summary: Generate attributed click URL
description: Generate a product URL decorated with `ad_*` attribution parameters. The click ID (UUID v7) enables conversion tracking back to the original agent query.
servers:
- url: https://attr.nexbid.dev
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ClickRequest'
example:
productId: prod_abc
responses:
'200':
description: Click URL generated
content:
application/json:
schema:
$ref: '#/components/schemas/ClickResponse'
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
components:
responses:
Forbidden:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
Unauthorized:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
schemas:
ClickResponse:
type: object
properties:
clickUrl:
type: string
ClickRequest:
type: object
properties:
productId:
type: string
required:
- productId
ErrorResponse:
type: object
properties:
error:
type: string
code:
type: string