> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Base URL: https://api.eventory.ai. Send your API key in the apikey header. Market Data and Live Availability calls cost credits, pings included; GET /usage is free, so use it to test a key. Costs per endpoint: https://eventory.ai/docs/credits-and-access.md # Artist social metrics > Resolves an artist by its exact marketplace URL and returns social metrics, the latest snapshot, and a rolling window of platform snapshots. The match on `url` is exact. Whitespace is trimmed but nothing else is normalised, so pass the URL exactly as it appears in `event.artist.url` of a Viagogo event response. **Cost:** 1 credit. ## OpenAPI ````yaml /openapi.yaml get /eventory/data/artist openapi: 3.1.0 info: title: Eventory API version: '1.0' description: > Every HTTP endpoint of the Eventory platform, reached through the single public gateway at `https://api.eventory.ai`. The Notifications API is a WebSocket and is documented separately under **Notifications API**. Authenticate every request with the `apikey` header. Each endpoint lists its credit cost; see **Credits & access** for how billing works. contact: name: Eventory url: https://eventory.ai servers: - url: https://api.eventory.ai description: Production security: - apiKey: [] tags: - name: Market Data description: | Historical and aggregated marketplace data for events and artists, plus full-text search over the Eventory catalog. Polling API. **1 credit per request** (sales list scales with rows requested). - name: Live Availability description: > On-demand scrape of the current ticket availability for one event on one of the twelve supported platforms. **5 credits per request.** - name: Watchlist description: | Manage the events your account monitors. The watchlist drives the Notifications API. **Free.** - name: Account description: Your plan and credit usage, live from billing. **Free.** paths: /eventory/data/artist: get: tags: - Market Data summary: Artist description: > Resolves an artist by its exact marketplace URL and returns social metrics, the latest snapshot, and a rolling window of platform snapshots. The match on `url` is exact. Whitespace is trimmed but nothing else is normalised, so pass the URL exactly as it appears in `event.artist.url` of a Viagogo event response. **Cost:** 1 credit. operationId: getArtist parameters: - name: url in: query required: true description: Exact artist URL on record. schema: type: string format: uri example: >- https://www.viagogo.com/Concert-Tickets/R-B/Contemporary-R-B/Teddy-Swims-Tickets - name: snapshots_limit in: query required: false description: Maximum entries in `snapshots_history`. schema: type: integer minimum: 1 maximum: 200 default: 30 responses: '200': description: Artist data. content: application/json: schema: $ref: '#/components/schemas/ArtistResponse' '400': description: '`url` is missing (`INVALID_REQUEST`) or empty (`MISSING_URL`).' content: application/json: schema: $ref: '#/components/schemas/DataApiError' examples: missing: value: status: error code: INVALID_REQUEST message: 'query.url: Field required' empty: value: status: error code: MISSING_URL message: Query parameter 'url' is required. '401': $ref: '#/components/responses/Unauthenticated' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '404': description: No artist on file with that exact URL. content: application/json: schema: $ref: '#/components/schemas/DataApiError' example: status: error code: ARTIST_NOT_FOUND message: >- No artist found for url 'https://www.viagogo.com/Concert-Tickets/Unknown-Artist-Tickets'. '502': $ref: '#/components/responses/DataUpstream' components: schemas: ArtistResponse: type: object properties: artist: type: object properties: artist_url: type: string artist_name: type: - string - 'null' artist_image_url: type: - string - 'null' social_metrics: type: - object - 'null' description: '`null` when the artist has no social profile on file.' additionalProperties: true properties: artist_name: type: - string - 'null' country_code: type: - string - 'null' description: Empty string when unknown. city: type: - string - 'null' description: Empty string when unknown. bio: type: - string - 'null' description: Empty string when unknown. level: type: - string - 'null' description: >- Career stage: `long_tail`, `mid_level`, `mainstream` or `superstar`. gender: type: - string - 'null' description: Empty string when unknown. birth_date: type: - string - 'null' format: date-time main_genre: type: - string - 'null' subgenres: type: array items: type: string created_at: type: - string - 'null' format: date-time updated_at: type: - string - 'null' format: date-time latest_snapshot: type: - object - 'null' description: >- `null` when there is no social profile. `demographics`, `scores`, and `releases` are free-form and may evolve; treat them as opaque. additionalProperties: true properties: snapshot_date: type: string format: date platforms: type: object description: >- Keyed by platform (`spotify`, `youtube`, …), each mapping metric name to value. additionalProperties: true demographics: type: - object - 'null' additionalProperties: true scores: type: - object - 'null' additionalProperties: true releases: type: - object - 'null' additionalProperties: true snapshots_history: type: array description: Empty when there is no social profile. items: type: object additionalProperties: true properties: snapshot_date: type: string format: date platforms: type: object additionalProperties: true example: artist: artist_url: >- https://www.viagogo.com/Concert-Tickets/R-B/Contemporary-R-B/Teddy-Swims-Tickets artist_name: Teddy Swims artist_image_url: https://images.example.com/teddy.jpg social_metrics: artist_name: Teddy Swims country_code: US city: Conyers bio: Singer-songwriter from Georgia. level: mainstream gender: male birth_date: '1992-09-25T00:00:00.000Z' main_genre: pop subgenres: - soul - r&b created_at: '2026-03-02T10:15:00.000Z' updated_at: '2026-06-12T06:00:00.000Z' latest_snapshot: snapshot_date: '2026-06-12' platforms: spotify: followers: 12345678 monthly_listeners: 45678901 youtube: subscribers: 2345678 demographics: {} scores: {} releases: {} snapshots_history: - snapshot_date: '2026-06-11' platforms: spotify: followers: 12340000 - snapshot_date: '2026-06-12' platforms: spotify: followers: 12345678 DataApiError: type: object description: Error envelope of the Market Data API. required: - status - code - message properties: status: type: string const: error code: type: string enum: - INVALID_VIAGOGO_ID - INVALID_VIVIDSEATS_ID - INVALID_TICKETMASTER_ID - INVALID_REQUEST - INVALID_FILTER - MISSING_URL - EVENT_NOT_FOUND - ARTIST_NOT_FOUND message: type: string GatewayError: type: object description: > Envelope for every failure decided by the gateway (auth, ACL, billing, rate limit, unknown route, upstream 5xx). Key on `code`; `message` is prose and may change. required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - unauthenticated - invalid_credentials - forbidden - no_subscription - limit_reached - no_billing_account - plan_unavailable - payment_required - invalid_parameter - rate_limited - not_found - service_unavailable message: type: string responses: Unauthenticated: description: No credential was sent, or the key was rejected. content: application/json: schema: $ref: '#/components/schemas/GatewayError' examples: missing: value: error: code: unauthenticated message: Authentication is required to access this resource. invalid: value: error: code: invalid_credentials message: Your credentials are invalid or expired. PaymentRequired: description: Billing denied the request. See `code`. content: application/json: schema: $ref: '#/components/schemas/GatewayError' examples: limit: value: error: code: limit_reached message: You have reached your usage limit. subscription: value: error: code: no_subscription message: Your account has no active subscription. Forbidden: description: >- The key is valid but not granted this route. Contact support to enable it. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: code: forbidden message: You do not have access to this service. DataUpstream: description: >- The Market Data API failed or timed out. The gateway keeps the status (`500`, `502`, `503` or `504`) and answers with its own envelope; the underlying error is not forwarded. Retry with backoff. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: code: service_unavailable message: The service is temporarily unavailable. securitySchemes: apiKey: type: apiKey in: header name: apikey description: Your Eventory API key. Sent as the `apikey` request header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.