find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/gifsnap-com:gifsnap-com-recommendations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: GifSnap GIF Search Recommendations API
  version: 1.0.0
  description: Read-only search, trending, and GIF lookup endpoints. This description covers the current public, best-effort API, which does not require an API key. No SLA or unlimited-capacity commitment is made. Media URLs may use external CDNs and formats such as GIF or WebP; use returned URLs unchanged. Software package licensing does not grant rights to media. The additional For You recommendation endpoints use a gated public pilot with verified media and integration acceptance; live /recommendations/capabilities is authoritative. Physical-iPhone checks remain deferred and untested. See https://gifsnap.com/docs/for-you.md.
servers:
- url: https://gifsnap.com/api/v1
security: []
tags:
- name: Recommendations
paths:
  /recommendations/capabilities:
    get:
      summary: Advertise tested v1 support
      description: Return enabled:false during rollout or incident. Missing/unsupported capability leaves the existing GIF surfaces available. Do not redirect.
      responses:
        '200':
          description: Success; application/json, no redirect
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForYouCapabilities'
        '429':
          description: Rate limited; preserve pending client state
          headers:
            Retry-After:
              schema:
                type: integer
        '503':
          description: Unavailable; client retains Search and pending feedback
      tags:
      - Recommendations
      operationId: getRecommendationsCapabilities
      x-operation-id-source: derived
  /recommendations/feedback:
    post:
      summary: Idempotent bounded feedback ingestion
      description: Validate every signed context token and event binding; persist accepted events before acknowledgement. Deduplicate globally by event id for at least the token lifetime plus replay margin. Return only accepted or already-accepted submitted event IDs. discarded_event_ids explicitly identifies permanently rejected/expired submitted IDs so they cannot block newer feedback; never discard on temporary storage failure. Partial acknowledgements are allowed. A retry can repeat the entire batch. Impressions require >=500 ms foreground playable visibility; quickSkip requires a valid impression and <1500 ms playable visibility; automatic loops and loading time never count. confirmedSend is emitted only after matching own server echo (or a later confirmed local history row), not send tap/socket optimistic success. Share cancelled is not shareCompleted. Downweight noisy implicit signals; cap repeated sends per content/day. Store no account identity, phone, recipients or message text; apply short retention to session-level telemetry.
      responses:
        '200':
          description: Success; application/json, no redirect
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForYouReceipt'
        '429':
          description: Rate limited; preserve pending client state
          headers:
            Retry-After:
              schema:
                type: integer
        '503':
          description: Unavailable; client retains Search and pending feedback
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForYouBatch'
      tags:
      - Recommendations
      operationId: postRecommendationsFeedback
      x-operation-id-source: derived
components:
  schemas:
    ForYouReceipt:
      type: object
      additionalProperties: false
      properties:
        accepted_event_ids:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 200
          maxItems: 50
        discarded_event_ids:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 200
          maxItems: 50
      required:
      - accepted_event_ids
    ForYouCapabilities:
      type: object
      additionalProperties: false
      properties:
        contract_version:
          const: 1
        enabled:
          type: boolean
      required:
      - contract_version
      - enabled
    ForYouContext:
      type: object
      additionalProperties: false
      properties:
        session_id:
          type: string
          minLength: 1
          maxLength: 200
        request_id:
          type: string
          minLength: 1
          maxLength: 200
        model_version:
          type: string
          minLength: 1
          maxLength: 100
        feedback_token:
          type: string
          minLength: 1
          maxLength: 4096
        recommendation_id:
          type: string
          minLength: 1
          maxLength: 200
        content_id:
          type: string
          minLength: 1
          maxLength: 256
        position:
          type: integer
          minimum: 0
          maximum: 499
        impression_id:
          type: string
          minLength: 1
          maxLength: 200
      required:
      - session_id
      - request_id
      - model_version
      - feedback_token
      - recommendation_id
      - content_id
      - position
      - impression_id
    ForYouBatch:
      type: object
      additionalProperties: false
      properties:
        contract_version:
          const: 1
        events:
          type: array
          items:
            $ref: '#/components/schemas/ForYouEvent'
          maxItems: 50
      required:
      - contract_version
      - events
    ForYouEvent:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 200
        context:
          $ref: '#/components/schemas/ForYouContext'
        kind:
          enum:
          - impression
          - save
          - unsave
          - confirmedSend
          - shareCompleted
          - quickSkip
          - notInterested
        occurred_at:
          type: string
          format: date-time
        visible_playback_ms:
          type: integer
          minimum: 0
          maximum: 60000
      required:
      - id
      - context
      - kind
      - occurred_at
externalDocs:
  description: GifSnap SDK quickstarts and API integration reference
  url: https://gifsnap.com/docs
x-for-you-rollout:
  enabled: false
  documentation: https://gifsnap.com/docs/for-you.md
  contract: https://gifsnap.com/for-you.openapi.json
  enable_only_after: Real DripChat integration acceptance and verified eligible multimodal media pool