> ## Documentation Index > Fetch the complete documentation index at: https://docs.eventory.ai/llms.txt > Use this file to discover all available pages before exploring further. # Artist > 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 real-time notification stream is a WebSocket and is documented separately under **Real-time stream**. 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 eleven supported platforms. **5 credits per request.** - name: Watchlist description: | Manage the events your account monitors. The watchlist drives the real-time stream. **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 or empty.' content: application/json: schema: $ref: '#/components/schemas/DataApiError' example: status: error code: MISSING_URL message: 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 with that url '429': $ref: '#/components/responses/RateLimited' '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: country_code: type: - string - 'null' biography: type: - string - 'null' genre: type: - string - 'null' subgenres: type: - string - 'null' career_stage: type: - string - 'null' origin_city: type: - string - 'null' 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: country_code: US biography: Singer-songwriter from Georgia. genre: pop subgenres: soul, r&b career_stage: mainstream origin_city: Conyers 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_REQUEST - MISSING_URL - EVENT_NOT_FOUND - ARTIST_NOT_FOUND - BAD_UPSTREAM_REQUEST - UPSTREAM_AUTH_FAILED - EDGE_UPSTREAM_ERROR - EDGE_UNAVAILABLE - EDGE_TIMEOUT - INTERNAL_ERROR 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: The provided credentials are invalid. 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: 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 resource. RateLimited: description: More than 30 requests in the current minute. Back off. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: code: rate_limited message: Rate limit exceeded. DataUpstream: description: >- The data backend rejected the request, failed, or timed out. `INTERNAL_ERROR`, `EDGE_UNAVAILABLE`, and `EDGE_TIMEOUT` are safe to retry once with backoff. content: application/json: schema: $ref: '#/components/schemas/DataApiError' example: status: error code: EDGE_UPSTREAM_ERROR message: Upstream returned an unexpected payload securitySchemes: apiKey: type: apiKey in: header name: apikey description: Your Eventory API key. Sent as the `apikey` request header. ````