> ## Documentation Index
> Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Look up a public Threads profile (beta)

> Beta. Resolves a public Threads profile by exact username and returns its public metrics. Requires the threads_profile_discovery Threads permission, which is pending Meta App Review, so calls may return an upstream authorization error for accounts outside the app's tester roster until that permission is granted. Matching is exact, with no fuzzy or prefix search. Only profiles with 100 or more followers are discoverable, anything else returns 404. The upstream budget is 1000 lookups per user per rolling 24 hours.



## OpenAPI

````yaml /api-reference/openapi.json get /platforms/threads/profile-lookup
openapi: 3.0.0
info:
  description: >-
    Unified social media inbox API. Read and respond to comments, DMs, reviews,
    and mentions across Instagram, Facebook, Threads, Google Business Profile,
    TikTok, LinkedIn, and YouTube through a single REST API. X/Twitter and
    Trustpilot coming soon.
  title: SocialAPI.AI
  contact:
    name: SocialAPI.AI Support
    email: support@social-api.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.social-api.ai/v1
security: []
paths:
  /platforms/threads/profile-lookup:
    get:
      tags:
        - Threads
      summary: Look up a public Threads profile (beta)
      description: >-
        Beta. Resolves a public Threads profile by exact username and returns
        its public metrics. Requires the threads_profile_discovery Threads
        permission, which is pending Meta App Review, so calls may return an
        upstream authorization error for accounts outside the app's tester
        roster until that permission is granted. Matching is exact, with no
        fuzzy or prefix search. Only profiles with 100 or more followers are
        discoverable, anything else returns 404. The upstream budget is 1000
        lookups per user per rolling 24 hours.
      parameters:
        - description: Connected account ID whose token authorizes the lookup
          name: account_id
          in: query
          required: true
          schema:
            type: string
        - description: Exact Threads username, with or without a leading @
          name: username
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ThreadsProfileResponse'
        '400':
          description: Missing account_id or username
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '404':
          description: Profile not discoverable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '429':
          description: Lookup budget exhausted for this user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '502':
          description: Upstream Threads API error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    api_endpoints.ThreadsProfileResponse:
      type: object
      properties:
        data:
          $ref: >-
            #/components/schemas/social-api_ai_core_api_connectors_base.ThreadsPublicProfile
    api_endpoints.ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/api_endpoints.ErrorBody'
    social-api_ai_core_api_connectors_base.ThreadsPublicProfile:
      type: object
      properties:
        biography:
          type: string
        follower_count:
          type: integer
        is_verified:
          type: boolean
        likes_count:
          type: integer
        name:
          type: string
        profile_picture_url:
          type: string
        quotes_count:
          type: integer
        reposts_count:
          type: integer
        username:
          type: string
        views_count:
          type: integer
    api_endpoints.ErrorBody:
      type: object
      properties:
        code:
          type: string
          example: resource.not_found
        message:
          type: string
          example: Account not found
        meta:
          type: object
          additionalProperties: {}
  securitySchemes:
    BearerAuth:
      description: >-
        Prefix your API key with "Bearer ". Example: `Authorization: Bearer
        sapi_key_...`
      type: apiKey
      name: Authorization
      in: header

````