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

# Email Finder from URL

> This operation allows you to find email from a profile URL. It returns a list of email with their types (professional, personal) along with credits and rate limit information. This operation consumes 4 credits.

<Info>
  **Credit Cost:** This endpoint consumes **4 credits** per request (live or cached).
</Info>

## Email Validation & Credit Policy

<CardGroup cols={2}>
  <Card title="Verified Email Only" icon="circle-check">
    We return only **validated, deliverable email**. No wildcards or unverified
    unverified email. Every email returned has been tested for validity.
  </Card>

  <Card title="No Results = No Charge" icon="coins">
    If we don't find any valid email, **no credits are debited** from your
    account. You only pay when we deliver results.
  </Card>
</CardGroup>

## Request Tracking & Reporting

<Info>
  **Found incorrect or missing data?** Visit your [API
  Logs](https://app.scrapin.io/api-logs) to view all requests and report issues
  directly from the web interface.
</Info>

**How to report an issue:**

1. Go to [app.scrapin.io/api-logs](https://app.scrapin.io/api-logs)
2. Find the request you want to report in the logs table
3. Click the **"Report"** button in the Actions column
4. Select the issue type and add a description

<Tip>
  The `request_id` helps our team investigate and resolve issues quickly. All
  enrichment requests are automatically logged for your convenience.
</Tip>


## OpenAPI

````yaml POST /v1/enrichment/emails/finder/url
openapi: 3.0.0
info:
  title: ScrapIn API
  version: 1.1.0
servers:
  - url: https://api.scrapin.io
security:
  - apiKey: []
tags:
  - name: Person
  - name: Company
  - name: Job
  - name: Workspaces
paths:
  /v1/enrichment/emails/finder/url:
    post:
      tags:
        - Person
      summary: Email Finder from URL
      description: >-
        This operation allows you to find email from a profile URL. It returns a
        list of email with their types (professional, personal) along with
        credits and rate limit information. This operation consumes 4 credits.
      operationId: EmailFinderFromUrl
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  description: >-
                    This required parameter is a string. It represents the URL
                    of the profile from which to extract email.
              required:
                - url
      responses:
        '200':
          description: The endpoint returns email addresses found for the profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailsFinderResponse'
              examples:
                EmailsFound:
                  $ref: '#/components/examples/EmailsFound'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    EmailsFinderResponse:
      allOf:
        - type: object
          properties:
            success:
              type: boolean
              description: Indicates success or failure of api request.
        - $ref: '#/components/schemas/RateLimitInfo'
        - type: object
          properties:
            metadata:
              type: object
              properties:
                source:
                  type: string
                  description: >-
                    Indicates whether the data was served from cache or freshly
                    scraped.
                request_id:
                  type: string
                  description: Unique identifier for this request.
            emails:
              type: array
              items:
                $ref: '#/components/schemas/Email'
              description: Array of email addresses found for the profile.
    RateLimitInfo:
      type: object
      properties:
        credits_consumed:
          type: number
          description: Represents the number of credits consumed by this query.
        credits_left:
          type: number
          description: >-
            Represents the usable credits available for the user account after
            this query.
        rate_limit_left:
          type: number
          description: >-
            Represents the usable daily request limit available for the user
            account after this query.
        daily_rate_limit_left:
          type: number
          description: >-
            Represents the usable daily request limit available for the user
            account after this query.
        minute_rate_limit_left:
          type: number
          description: >-
            Represents the usable minute request limit available for the user
            account after this query.
        next_minute_rate_limit_reset:
          type: string
          description: >-
            Represents the next minute rate limit reset for the user account
            after this query. Datetime in ISO 8601 format (e.g.,
            2025-11-14T14:34:43.000Z).
        quotas:
          type: object
          description: >-
            Structured quota information for the user account. Provides the same
            data as the flat fields above in a more organized format.
          properties:
            credits:
              type: object
              description: Credit usage information for the user account.
              properties:
                total:
                  type: number
                  description: Total credits available on the account.
                used:
                  type: number
                  description: Total credits used on the account.
                left:
                  type: number
                  description: Remaining credits available on the account.
            daily_rate_limit:
              type: object
              description: Daily rate limit information for the user account.
              properties:
                limit:
                  type: number
                  description: Maximum number of requests allowed per day.
                used:
                  type: number
                  description: Number of requests used today.
                left:
                  type: number
                  description: Remaining requests allowed today.
                next_reset:
                  type: string
                  description: >-
                    Next daily rate limit reset time in ISO 8601 format (e.g.,
                    2026-01-28T00:00:00.000Z).
            minute_rate_limit:
              type: object
              description: Per-minute rate limit information for the user account.
              properties:
                limit:
                  type: number
                  description: Maximum number of requests allowed per minute.
                used:
                  type: number
                  description: Number of requests used in the current minute window.
                left:
                  type: number
                  description: Remaining requests allowed in the current minute window.
                next_reset:
                  type: string
                  description: >-
                    Next minute rate limit reset time in ISO 8601 format (e.g.,
                    2026-01-27T14:32:45.000Z).
    Email:
      type: object
      properties:
        value:
          type: string
          description: The email address.
        type:
          type: string
          enum:
            - professional
            - personal
          description: The type of email address (professional or personal).
    ErrorResponseSchema:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        title:
          type: string
        msg:
          type: string
  examples:
    EmailsFound:
      summary: Emails Found
      value:
        success: true
        credits_consumed: 4
        credits_left: 200731.5
        rate_limit_left: 99890
        daily_rate_limit_left: 99890
        minute_rate_limit_left: 499
        next_minute_rate_limit_reset: '2025-10-28T15:23:32.000Z'
        quotas:
          credits:
            total: 10000
            used: 1234
            left: 8766
          daily_rate_limit:
            limit: 5000
            used: 150
            left: 4850
            next_reset: '2024-10-31T12:46:00.000Z'
          minute_rate_limit:
            limit: 500
            used: 12
            left: 488
            next_reset: '2024-10-31T12:46:00.000Z'
        metadata:
          source: fresh
          request_id: 000xcc2a-829a-4200-9704-f6f9cf9a23de
        emails:
          - value: john@scrapin.io
            type: professional
    NoApiKey:
      summary: No Api Key
      value:
        success: false
        title: An error has occurred 🚒
        msg: The API Key is missing
    MissingEmail:
      summary: Missing Email
      value:
        success: false
        title: An error has occurred 🚒
        msg: The email is missing
    InvalidEmail:
      summary: Invalid Email
      value:
        success: false
        title: An error has occurred 🚒
        msg: The email has the wrong format
    InvalidApiKey:
      summary: Invalid Api Key
      value:
        success: false
        title: Unauthorized
        msg: API Key is invalid
    PaymentRequired:
      summary: Payment Required
      value:
        success: false
        title: You don't have enough credits on your account 💰
        msg: You have to upgrade to continue
    PageNotFound:
      summary: Data Not Found
      value:
        success: false
        title: Not Found
        msg: No data found
    ServerError:
      summary: Server Error
      value:
        success: false
        title: Internal Server Error
        msg: An internal server error has occurred
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseSchema'
          examples:
            NoApiKey:
              $ref: '#/components/examples/NoApiKey'
            MissingEmail:
              $ref: '#/components/examples/MissingEmail'
            InvalidEmail:
              $ref: '#/components/examples/InvalidEmail'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseSchema'
          examples:
            InvalidApiKey:
              $ref: '#/components/examples/InvalidApiKey'
    PaymentRequired:
      description: Insufficient Account Balance
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseSchema'
          examples:
            PaymentRequired:
              $ref: '#/components/examples/PaymentRequired'
    NotFound:
      description: Data Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseSchema'
          examples:
            PageNotFound:
              $ref: '#/components/examples/PageNotFound'
    ServerError:
      description: Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseSchema'
          examples:
            ServerError:
              $ref: '#/components/examples/ServerError'
  securitySchemes:
    apiKey:
      name: apikey
      in: query
      type: apiKey
      description: >-
        This required parameter is a string. It represents the APIKEY obtained
        from the developer dashboard. 

        You must use it in the query string of your request as
        ?apikey=YOUR_API_KEY or in the headers as x-api-key: YOUR_API_KEY

````