instapi-co API

openapi: 3.1.0
info:
  title: instapi-co API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 11 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; instapi-co has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 6
    documentation: 5
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://instapi.co/docs
  - https://instapi.co/instagram-api-for-ai-agents
paths:
  /api/checkout:
    post:
      operationId: post_api_checkout
      tags:
      - Api
      summary: Stripe payment link.
      x-source: https://instapi.co/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiCheckoutRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiCheckoutResponse'
      x-evidence:
        kind: documentation
  /api/instagram/search:
    get:
      operationId: get_api_instagram_search
      tags:
      - Api
      summary: GET /api/instagram/search
      x-source: https://instapi.co/docs
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://instapi.co/api/instagram/search?q=nasa\"  -H \"Authorization: Bearer sk_instapi_...\" \n Prefer a UI? Get an\
          \ API key in the\n dashboard.\n Authentication \n Every authenticated call uses an Authorization: Bearer header. \n jwt_instapi_...\
          \ : account token from signup or login. Used for account, key and billing endpoints. \n sk_instapi_... : API key. Used for Instagram\
          \ data endpoints and the MC"
  /api/instagram/users/{username}:
    get:
      operationId: get_api_instagram_users_username
      tags:
      - Api
      summary: 'Public profile for an Instagram account: bio, links, follower, following and post counts, verified, private and business flags,
        category and public contact info.'
      x-source: https://instapi.co/docs
      parameters:
      - name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiInstagramUsersUsernameResponse'
      x-evidence:
        kind: documentation
  /api/instagram/users/{username}/posts:
    get:
      operationId: get_api_instagram_users_username_posts
      tags:
      - Api
      summary: Recent posts for a public Instagram account, newest first.
      x-source: https://instapi.co/docs
      parameters:
      - name: username
        in: path
        required: true
        schema:
          type: string
      - name: count
        in: query
        required: false
        schema:
          type: integer
        description: Number of posts to fetch (1 to 30, default 12)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiInstagramUsersUsernamePostsResponse'
      x-evidence:
        kind: documentation
  /api/keys:
    get:
      operationId: get_api_keys
      tags:
      - Api
      summary: List active API keys.
      x-source: https://instapi.co/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiKeysResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_keys
      tags:
      - Api
      summary: POST /api/keys
      x-source: https://instapi.co/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiKeysRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://instapi.co/api/keys  -H "Authorization: Bearer jwt_instapi_..."  -H "Content-Type: application/json"  -d
          ''{"name": "my-agent"}'''
  /api/keys/{id}:
    delete:
      operationId: delete_api_keys_id
      tags:
      - Api
      summary: Revoke a key.
      x-source: https://instapi.co/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApiKeysIdResponse'
      x-evidence:
        kind: documentation
  /api/login:
    post:
      operationId: post_api_login
      tags:
      - Api
      summary: Return a JWT and credit balance.
      x-source: https://instapi.co/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiLoginRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiLoginResponse'
      x-evidence:
        kind: documentation
  /api/signup:
    post:
      operationId: post_api_signup
      tags:
      - Api
      summary: POST /api/signup
      x-source: https://instapi.co/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiSignupRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://instapi.co/api/signup  -H "Content-Type: application/json"  -d ''{"email": " [email protected] ", "password":
          "..."}'''
  /api/start:
    get:
      operationId: get_api_start
      tags:
      - Api
      summary: Service info and onboarding steps.
      x-source: https://instapi.co/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiStartResponse'
      x-evidence:
        kind: documentation
  /api/status:
    get:
      operationId: get_api_status
      tags:
      - Api
      summary: Get credits, API keys, and purchase history.
      x-source: https://instapi.co/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiStatusResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiCheckoutRequest:
      type: object
      properties:
        amountCents:
          type: integer
          description: Amount in cents (min 100, steps of 100)
      required:
      - amountCents
    PostApiCheckoutResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata
        url:
          type: string
          description: Stripe payment link
    GetApiInstagramUsersUsernameResponse:
      type: object
      properties:
        username:
          type: string
          description: Username
        fullName:
          type: string
          description: Full name
        id:
          type: string
          description: User ID
        biography:
          type: string
          description: Bio text
        externalUrl:
          type: string
          description: Link in bio
        bioLinks:
          type: array
          description: Links in bio with title and url
        followerCount:
          type: integer
          description: Number of followers
        followingCount:
          type: integer
          description: Number following
        postCount:
          type: integer
          description: Number of posts
        isVerified:
          type: boolean
          description: Verified flag
        isPrivate:
          type: boolean
          description: Private account flag
        isBusiness:
          type: boolean
          description: Business account flag
        accountType:
          type: string
          description: 'Account type: personal, business or creator'
        category:
          type: string
          description: Business category if set
        contact:
          type: object
          description: Public email, phone, address if shown
        profilePicUrl:
          type: string
          description: Profile picture URL
    GetApiInstagramUsersUsernamePostsResponse:
      type: object
      properties:
        shortcode:
          type: string
          description: Instagram post code
        url:
          type: string
          description: Post URL on instagram.com
        type:
          type: string
          description: 'Post type: image, video or carousel'
        takenAt:
          type: string
          description: Post time, ISO 8601
        pinned:
          type: boolean
          description: Pinned to the profile grid
        likeCount:
          type: integer
          description: Number of likes
        commentCount:
          type: integer
          description: Number of comments
        caption:
          type: string
          description: Caption text
        media:
          type: array
          description: Array of media with type, imageUrl, videoUrl, width, height, parsedContent (AI text description)
    GetApiKeysResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata
        keys:
          type: array
          description: List of active API keys
    PostApiKeysRequest:
      type: object
      properties:
        name:
          type: string
    DeleteApiKeysIdResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata
    PostApiLoginRequest:
      type: object
      properties:
        email:
          type: string
          description: Email address
        password:
          type: string
          description: Password
      required:
      - email
      - password
    PostApiLoginResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata
        jwt:
          type: string
          description: JWT token
        credits:
          type: integer
          description: Remaining credits
    PostApiSignupRequest:
      type: object
      properties:
        email:
          type: string
        password:
          type: string
    GetApiStartResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata with next steps
    GetApiStatusResponse:
      type: object
      properties:
        meta:
          type: object
          description: Metadata
        credits:
          type: integer
          description: Remaining credits
        keys:
          type: array
          description: List of API keys
        purchaseHistory:
          type: array
          description: Purchase history
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api