> ## Documentation Index > Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Cross-store app lookup > Resolve public Apple/Google Play listings by title or explicit IDs. Resolved complete listings use a bounded Groq multilingual identity judgment plus an independent developer string guard; a model cannot override publisher mismatch. Model confidence is uncalibrated and requires at least 0.8 to merge. Explicit match_threshold opts into deterministic title/developer matching. Missing, expired, exhausted or failed inference uses that same fallback and reports fallback_code. Title search resolution is still deterministic; supply explicit IDs for differently named localized listings. Partial source results retain known fields. A clean no-match costs 30 credits; unresolved listings or all-source failure are uncharged. Shared deadline 47 seconds; finite store and inference allowances apply. Resolve an app by `title`, `google_play_id`, or `app_store_id`; at least one is required. Explicit IDs anchor their stores directly. Without a title, the resolved anchor supplies the search title for the other store. `stores` is a nonempty CSV subset of `google_play,app_store`; IDs for excluded stores are rejected. Each selected store returns an independent status and canonical App. Search uses a bounded ranked window (Google Play: 30 requested rows; Apple: 100). A candidate must pass the title threshold, default **0.6**, and competing publishers within **two native source positions** and **0.05 title similarity** are treated as ambiguous. Native source rank breaks more distant ties; this can exclude lower-ranked homonyms, so supply explicit IDs when identity must be authoritative. The selected candidate is then enriched with full app details. Failed enrichment preserves only the known search fields and marks that store partial. Complete resolved cross-store listings are compared by a **multilingual model judgment** through Groq (`openai/gpt-oss-20b`), with a separate publisher string guard. Only public store IDs, titles and publisher names are sent to the model. It can recognize translated titles, but cannot override publisher mismatch. A merge requires an equivalent-title judgment with a model confidence of at least **0.8**, plus the independent publisher guard. Different apps owned by the same publisher must remain separate. `match.method` identifies `llm_identity` or `title_developer_fallback`. Confidence is an **uncalibrated assessment, not a probability**; check `confidence_kind`, `model`, `title_relation`, and `fallback_code`. Supplying `match_threshold` explicitly selects the deterministic title/developer guard. Missing credentials, expired trial access, exhausted allowances, rate limits, timeout, invalid output or incomplete listings also select the documented fallback. Publisher mismatch prevents the inference call entirely. Title-search candidate selection remains deterministic. For localized names that do not share title tokens, supply both store IDs so the model compares the resolved listings. Localized publisher names that fail the independent string guard also remain separate; the model does not invent ownership evidence. `include` selects a nonempty CSV subset of `merged,similar,developer`, default all three. Omitted blocks are not computed. `merged` is null unless both listings pass the match guards. Its rating gap is Google Play minus Apple; ratings are specific to each market and collection time. Apple install counts are unavailable and remain null. Similar apps and developer apps are source lists, not independently verified recommendations. Country/language must be accepted by every selected store; defaults are US/en. The stores share a **47-second deadline**. Source tasks are persisted for one hour, so retrying pending work reuses the same task. A timeout, exhausted provider allowance or source failure never turns into an empty successful result. A fresh successful response costs **30 credits**, including clean no-match and explicitly partial results. No resolved listing yields 404; a required source failure with no usable listing yields 503. Both are free, as are cache hits and idempotent replays. Use `X-Max-Credits: 30` and a 60-second client timeout. Invalid `include` returns 400; other unsupported options return 422 before source work. DataForSEO and Apple lookups use existing finite verification allowances. Groq is limited to 100 approved free-plan inference tests and the configured key window ending 11 November 2026. AI failure retains the deterministic fallback. Cross-language candidate discovery, independently translated publisher identities and sustained production capacity remain unverified. ## OpenAPI ````yaml GET /prism/apps-lookup openapi: 3.1.0 info: title: SocialQuery API version: '2026-10-09' description: >- Documented requests for public-source records. Inspect accepted inputs and credit amounts, then verify the selected operation before integrating preview coverage. servers: - url: https://socialquery.dev/v1 security: - apiKey: [] paths: /prism/apps-lookup: get: tags: - Prism summary: Prism Apps Lookup description: >- Resolve public Apple/Google Play listings by title or explicit IDs. Resolved complete listings use a bounded Groq multilingual identity judgment plus an independent developer string guard; a model cannot override publisher mismatch. Model confidence is uncalibrated and requires at least 0.8 to merge. Explicit match_threshold opts into deterministic title/developer matching. Missing, expired, exhausted or failed inference uses that same fallback and reports fallback_code. Title search resolution is still deterministic; supply explicit IDs for differently named localized listings. Partial source results retain known fields. A clean no-match costs 30 credits; unresolved listings or all-source failure are uncharged. Shared deadline 47 seconds; finite store and inference allowances apply. operationId: get_prism_apps_lookup parameters: - name: title in: query required: false example: Notion schema: type: string - name: google_play_id in: query required: false schema: type: string - name: app_store_id in: query required: false schema: type: string - name: stores in: query required: false example: google_play,app_store schema: type: string - name: country in: query required: false schema: type: string - name: language in: query required: false schema: type: string - name: match_threshold in: query required: false schema: type: string - name: include in: query required: false schema: type: string - name: Cache-Control in: header required: false example: no-cache schema: type: string - name: Idempotency-Key in: header required: false example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c schema: type: string - name: X-Max-Credits in: header required: false description: >- Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero. schema: type: integer minimum: 0 responses: '200': description: >- Resolve public Apple/Google Play listings by title or explicit IDs. Resolved complete listings use a bounded Groq multilingual identity judgment plus an independent developer string guard; a model cannot override publisher mismatch. Model confidence is uncalibrated and requires at least 0.8 to merge. Explicit match_threshold opts into deterministic title/developer matching. Missing, expired, exhausted or failed inference uses that same fallback and reports fallback_code. Title search resolution is still deterministic; supply explicit IDs for differently named localized listings. Partial source results retain known fields. A clean no-match costs 30 credits; unresolved listings or all-source failure are uncharged. Shared deadline 47 seconds; finite store and inference allowances apply. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: query: type: object properties: title: type: - string - 'null' google_play_id: type: - string - 'null' app_store_id: type: - string - 'null' country: type: string language: type: string stores: type: array items: type: string enum: - google_play - app_store required: - title - google_play_id - app_store_id - country - language - stores additionalProperties: false stores: type: array items: type: object properties: store: type: string enum: - google_play - app_store status: type: string enum: - ok - partial - not_found - ambiguous - error resolution: type: string enum: - id - title app: anyOf: - type: object properties: id: type: string description: >- Store app ID (Google Play package name / App Store numeric id) store: const: google_play url: type: - string - 'null' description: String at app.url title: type: - string - 'null' description: App title subtitle: type: 'null' icon: type: - string - 'null' description: String at app.icon description: type: - string - 'null' description: String at app.description developer: type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: - string - 'null' description: String at app.developer.email address: type: - string - 'null' description: String at app.developer.address website: type: - string - 'null' description: String at app.developer.website rating: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 price: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed reviews_count: type: - integer - 'null' description: Numeric at app.reviews_count category: type: - string - 'null' description: String at app.category categories: type: 'null' installs: type: - object - 'null' description: >- Install signal (Google only): { display "1,000,000,000+", count }; null on Apple properties: display: type: - string - 'null' description: String at app.installs.display count: type: - integer - 'null' description: Numeric at app.installs.count version: type: - string - 'null' description: String at app.version minimum_os_version: type: - string - 'null' description: String at app.minimum_os_version size: type: - string - 'null' description: String at app.size released_at: type: - string - 'null' updated_at: type: - string - 'null' update_notes: type: - string - 'null' description: String at app.update_notes image_urls: type: - array - 'null' description: Screenshot URLs items: type: string description: Screenshot URLs video_urls: type: - array - 'null' description: Array at app.video_urls items: type: string description: String at app.video_urls languages: type: 'null' advisories: type: 'null' genres: type: - array - 'null' description: Google Play genres (null on Apple) items: type: string description: Google Play genres (null on Apple) tags: type: - array - 'null' description: Array at app.tags items: type: string description: String at app.tags similar_apps: type: - array - 'null' description: Array at app.similar_apps items: type: object description: 'Nested object: app.similar_apps' properties: id: type: - string - 'null' description: String at app.similar_apps.id title: type: - string - 'null' description: String at app.similar_apps.title url: type: - string - 'null' description: String at app.similar_apps.url more_by_developer: type: - array - 'null' description: Array at app.more_by_developer items: type: object description: 'Nested object: app.more_by_developer' properties: id: type: - string - 'null' description: String at app.more_by_developer.id title: type: - string - 'null' description: String at app.more_by_developer.title url: type: - string - 'null' description: String at app.more_by_developer.url ext: type: object properties: appdata: type: object properties: country: type: string requested_language: type: string source: const: dataforseo source_rank: type: - integer - 'null' minimum: 0 coverage_note: type: string required: - country - requested_language - source - source_rank - coverage_note additionalProperties: false required: - appdata additionalProperties: false required: - id - store - url - title - subtitle - icon - description - developer - rating - price - reviews_count - category - categories - installs - version - minimum_os_version - size - released_at - updated_at - update_notes - image_urls - video_urls - languages - advisories - genres - tags - similar_apps - more_by_developer - ext additionalProperties: false - type: object properties: id: type: string description: >- Store app ID (Google Play package name / App Store numeric id) store: type: string description: >- App marketplace ("google_play" or "app_store") url: type: - string - 'null' description: String at app.url title: type: - string - 'null' description: App title subtitle: type: - string - 'null' description: String at app.subtitle icon: type: - string - 'null' description: String at app.icon description: type: - string - 'null' description: String at app.description developer: type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: 'null' address: type: 'null' website: type: - string - 'null' description: String at app.developer.website rating: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 price: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed reviews_count: type: - integer - 'null' description: Numeric at app.reviews_count category: type: - string - 'null' description: String at app.category categories: type: - array - 'null' description: Array at app.categories items: type: string description: String at app.categories installs: type: 'null' version: type: - string - 'null' description: String at app.version minimum_os_version: type: - string - 'null' description: String at app.minimum_os_version size: type: - string - 'null' description: String at app.size released_at: type: - string - integer - 'null' description: 'Union: string | integer | null' updated_at: type: - string - integer - 'null' description: 'Union: string | integer | null' update_notes: type: - string - 'null' description: String at app.update_notes image_urls: type: - array - 'null' description: Screenshot URLs items: type: string description: Screenshot URLs video_urls: type: 'null' languages: type: - array - 'null' description: Array at app.languages items: type: string description: String at app.languages advisories: type: - array - 'null' description: >- Apple age/content advisories (null on Google) items: type: string description: >- Apple age/content advisories (null on Google) genres: type: 'null' tags: type: 'null' similar_apps: type: - array - 'null' description: Array at app.similar_apps items: type: object description: 'Nested object: app.similar_apps' properties: id: type: - string - 'null' description: String at app.similar_apps.id title: type: - string - 'null' description: String at app.similar_apps.title url: type: - string - 'null' description: String at app.similar_apps.url more_by_developer: type: - array - 'null' description: Array at app.more_by_developer items: type: object description: 'Nested object: app.more_by_developer' properties: id: type: - string - 'null' description: String at app.more_by_developer.id title: type: - string - 'null' description: String at app.more_by_developer.title url: type: - string - 'null' description: String at app.more_by_developer.url ext: type: object properties: appdata: type: object properties: country: type: string requested_language: type: string source: const: dataforseo enrichment_source: const: apple_itunes source_rank: type: - integer - 'null' minimum: 0 apple_advisory: type: - string - 'null' coverage_note: type: string required: - country - requested_language - source - enrichment_source - source_rank - apple_advisory - coverage_note additionalProperties: false required: - appdata additionalProperties: false required: - id - store - url - title - subtitle - icon - description - developer - rating - price - reviews_count - category - categories - installs - version - minimum_os_version - size - released_at - updated_at - update_notes - image_urls - video_urls - languages - advisories - genres - tags - similar_apps - more_by_developer - ext additionalProperties: false - type: object properties: id: type: string description: >- Store app ID (Google Play package name / App Store numeric id) store: const: google_play url: type: - string - 'null' description: String at app.url title: type: - string - 'null' description: App title subtitle: type: 'null' icon: type: - string - 'null' description: String at app.icon description: type: 'null' developer: type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: 'null' address: type: 'null' website: type: 'null' rating: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 price: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed reviews_count: type: - integer - 'null' description: Numeric at app.reviews_count category: type: 'null' categories: type: 'null' installs: type: 'null' version: type: 'null' minimum_os_version: type: 'null' size: type: 'null' released_at: type: 'null' updated_at: type: 'null' update_notes: type: 'null' image_urls: type: 'null' video_urls: type: 'null' languages: type: 'null' advisories: type: 'null' genres: type: 'null' tags: type: 'null' similar_apps: type: 'null' more_by_developer: type: 'null' ext: type: object properties: appdata: type: object properties: country: type: string requested_language: type: string source: const: dataforseo source_rank: type: - integer - 'null' minimum: 0 coverage_note: type: string required: - country - requested_language - source - source_rank - coverage_note additionalProperties: false required: - appdata additionalProperties: false required: - id - store - url - title - subtitle - icon - description - developer - rating - price - reviews_count - category - categories - installs - version - minimum_os_version - size - released_at - updated_at - update_notes - image_urls - video_urls - languages - advisories - genres - tags - similar_apps - more_by_developer - ext additionalProperties: false - type: object properties: id: type: string description: >- Store app ID (Google Play package name / App Store numeric id) store: type: string description: >- App marketplace ("google_play" or "app_store") url: type: - string - 'null' description: String at app.url title: type: - string - 'null' description: App title subtitle: type: 'null' icon: type: - string - 'null' description: String at app.icon description: type: 'null' developer: type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: 'null' address: type: 'null' website: type: - string - 'null' description: String at app.developer.website rating: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 price: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed reviews_count: type: - integer - 'null' description: Numeric at app.reviews_count category: type: - string - 'null' description: String at app.category categories: type: - array - 'null' description: Array at app.categories items: type: string description: String at app.categories installs: type: 'null' version: type: 'null' minimum_os_version: type: 'null' size: type: 'null' released_at: type: 'null' updated_at: type: 'null' update_notes: type: 'null' image_urls: type: 'null' video_urls: type: 'null' languages: type: 'null' advisories: type: 'null' genres: type: 'null' tags: type: 'null' similar_apps: type: 'null' more_by_developer: type: 'null' ext: type: object properties: appdata: type: object properties: country: type: string requested_language: type: string source: const: dataforseo enrichment_source: const: apple_itunes source_rank: type: - integer - 'null' minimum: 0 apple_advisory: type: - string - 'null' coverage_note: type: string required: - country - requested_language - source - enrichment_source - source_rank - apple_advisory - coverage_note additionalProperties: false required: - appdata additionalProperties: false required: - id - store - url - title - subtitle - icon - description - developer - rating - price - reviews_count - category - categories - installs - version - minimum_os_version - size - released_at - updated_at - update_notes - image_urls - video_urls - languages - advisories - genres - tags - similar_apps - more_by_developer - ext additionalProperties: false - type: 'null' title_score: type: - number - 'null' error_code: type: - string - 'null' required: - store - status - resolution - app - title_score - error_code additionalProperties: false partial: type: boolean match: anyOf: - type: object properties: same_app: type: boolean title_similarity: type: number developer_similarity: type: number confidence: type: number method: type: string enum: - llm_identity - title_developer_fallback confidence_kind: type: string enum: - uncalibrated_model_assessment - uncalibrated_string_similarity threshold: type: number reason: type: string model: type: - string - 'null' title_relation: type: - string - 'null' enum: - equivalent - different - uncertain - null fallback_code: type: - string - 'null' required: - same_app - title_similarity - developer_similarity - confidence - method - confidence_kind - threshold - reason - model - title_relation - fallback_code additionalProperties: false - type: 'null' merged: anyOf: - type: object properties: title: type: string store_ids: type: object properties: google_play: type: string app_store: type: string required: - google_play - app_store additionalProperties: false ratings: type: object properties: google_play: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 app_store: type: object description: >- Aggregate rating (value, max, number of ratings) properties: value: type: - number - 'null' minimum: 0 maximum: 5 max: type: - number - 'null' enum: - 5 - null count: type: - integer - 'null' minimum: 0 required: - google_play - app_store additionalProperties: false rating_gap: type: - number - 'null' prices: type: object properties: google_play: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed app_store: type: object description: >- Price block (current, original, currency, is_free, displayed) properties: current: type: - number - 'null' minimum: 0 original: type: - number - 'null' minimum: 0 currency: type: - string - 'null' description: String at app.price.currency is_free: type: - boolean - 'null' description: Boolean at app.price.is_free displayed: type: - string - 'null' description: String at app.price.displayed required: - google_play - app_store additionalProperties: false installs: type: object properties: google_play: type: - object - 'null' description: >- Install signal (Google only): { display "1,000,000,000+", count }; null on Apple properties: display: type: - string - 'null' description: String at app.installs.display count: type: - integer - 'null' description: Numeric at app.installs.count app_store: type: 'null' required: - google_play - app_store additionalProperties: false required: - title - store_ids - ratings - rating_gap - prices - installs additionalProperties: false - type: 'null' similar: type: array items: type: object properties: store: type: string enum: - google_play - app_store apps: anyOf: - type: - array - 'null' description: Array at app.similar_apps items: type: object description: 'Nested object: app.similar_apps' properties: id: type: - string - 'null' description: String at app.similar_apps.id title: type: - string - 'null' description: String at app.similar_apps.title url: type: - string - 'null' description: String at app.similar_apps.url - type: - array - 'null' description: Array at app.similar_apps items: type: object description: 'Nested object: app.similar_apps' properties: id: type: - string - 'null' description: String at app.similar_apps.id title: type: - string - 'null' description: String at app.similar_apps.title url: type: - string - 'null' description: String at app.similar_apps.url required: - store - apps additionalProperties: false developer: type: array items: type: object properties: store: type: string enum: - google_play - app_store developer: anyOf: - type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: - string - 'null' description: String at app.developer.email address: type: - string - 'null' description: String at app.developer.address website: type: - string - 'null' description: String at app.developer.website - type: object description: >- Developer block (name, id, url; email/address for Google) properties: id: type: - string - 'null' description: String at app.developer.id name: type: - string - 'null' description: String at app.developer.name url: type: - string - 'null' description: String at app.developer.url email: type: 'null' address: type: 'null' website: type: - string - 'null' description: String at app.developer.website more_apps: anyOf: - type: - array - 'null' description: Array at app.more_by_developer items: type: object description: 'Nested object: app.more_by_developer' properties: id: type: - string - 'null' description: String at app.more_by_developer.id title: type: - string - 'null' description: String at app.more_by_developer.title url: type: - string - 'null' description: String at app.more_by_developer.url - type: - array - 'null' description: Array at app.more_by_developer items: type: object description: 'Nested object: app.more_by_developer' properties: id: type: - string - 'null' description: String at app.more_by_developer.id title: type: - string - 'null' description: String at app.more_by_developer.title url: type: - string - 'null' description: String at app.more_by_developer.url required: - store - developer - more_apps additionalProperties: false coverage_note: type: string required: - query - stores - partial - match - coverage_note additionalProperties: false required: - data '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '402': $ref: '#/components/responses/Error402' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '405': $ref: '#/components/responses/Error405' '409': $ref: '#/components/responses/Error409' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' '500': $ref: '#/components/responses/Error500' '502': $ref: '#/components/responses/Error502' '503': $ref: '#/components/responses/Error503' '504': $ref: '#/components/responses/Error504' components: schemas: SocialQueryResponse: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - data properties: success: type: boolean const: true platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean data: type: object additionalProperties: true description: >- The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null. SocialQueryError: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - error properties: success: type: boolean const: false platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean error: type: object required: - code - type - message - status - doc_url properties: code: type: string type: type: string message: type: string status: type: integer doc_url: type: string format: uri responses: Error400: description: Upstream rejected the request. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error401: description: Missing, expired, invalid, or revoked API key. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error402: description: Insufficient SocialQuery credits. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error403: description: Key scope or provider policy denied access. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error404: description: Endpoint or upstream resource not found. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error405: description: HTTP method is not supported. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error409: description: Idempotency conflict or request in progress. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error422: description: Invalid parameters. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error429: description: Request limit reached. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error500: description: Request processing failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error502: description: Upstream service failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error503: description: Provider or required service is unavailable. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error504: description: Upstream service timed out. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.