Skip to main content
POST
/
v1
/
enrichment
/
match
Match Profile
curl --request POST \
  --url 'https://api.scrapin.io/v1/enrichment/match?apikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "includes": {
    "includeCompany": true,
    "includeSummary": true,
    "includeFollowersCount": true,
    "includeCreationDate": true,
    "includeSkills": true,
    "includeLanguages": true,
    "includeExperience": true,
    "includeEducation": true,
    "includeCertifications": true
  },
  "firstName": "<string>",
  "lastName": "<string>",
  "companyDomain": "<string>",
  "companyName": "<string>",
  "email": "<string>",
  "cacheDuration": "2d"
}
'
{
  "success": true,
  "credits_consumed": 1,
  "credits_left": 90000.5,
  "rate_limit_left": 19000,
  "daily_rate_limit_left": 19000,
  "minute_rate_limit_left": 499,
  "next_minute_rate_limit_reset": "2025-07-24T12:11:01.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"
  },
  "person": {
    "publicIdentifier": "michael",
    "linkedInIdentifier": "ACoAABTEFqYBfjGaiNAy5ITKaPacBEBDdR1Srhs",
    "memberIdentifier": "248295112",
    "linkedInUrl": "https://www.social.com/in/michael",
    "firstName": "Michael",
    "lastName": "Davis",
    "headline": "VP Sales Scrapin.io - B2B Data for AI",
    "location": {
      "city": "London",
      "state": "England",
      "country": "United Kingdom",
      "countryCode": "GB"
    },
    "summary": "I'm a software engineer with a passion for building scalable and efficient systems.",
    "photoUrl": "https://media.licdn.com/dms/image/v2/D4E03AQG5S0X4QKtN5A/profile-displayphoto-shrink_200_200/B4EZRgQ6wZGYAY-/0/1736781836053?e=1756339200&v=beta&t=phxC3jRwoDG_zQ8QY4Iu6OduHPUM-abbrEHkJZPP9fM",
    "backgroundUrl": "https://media.licdn.com/dms/image/v2/C4E16AQGba4BhpCykTA/profile-displaybackgroundimage-shrink_350_1400/profile-displaybackgroundimage-shrink_350_1400/0/1516880563413?e=1756339200&v=beta&t=fdimLlwIIQEke73CfLZWvq0T367YxZajvtmMwynSIiU",
    "openToWork": false,
    "premium": true,
    "showVerificationBadge": true,
    "creationDate": {
      "month": 6,
      "year": 2014
    },
    "followerCount": 3735,
    "connectionsCount": 650,
    "currentPosition": {
      "title": "VP of Sales",
      "description": "B2B Data for AI +",
      "contractType": "Full-time",
      "companyName": "ScrapIn",
      "linkedInId": "100602385",
      "linkedInUrl": "https://www.social.com/company/scrapin-api/",
      "companyLocation": "London, England, United Kingdom",
      "companyLogo": "https://media.licdn.com/dms/image/v2/D4E0BAQF-Z-m2ZKv6qQ/company-logo_200_200/B4EZcRELezHcAM-/0/1748337998127/scrapin_api_logo?e=1756339200&v=beta&t=GjTJ9cgDP2iBYJCx8GxXEg8V2hZjnNBOtvXe58eiqJ0",
      "startEndDate": {
        "start": {
          "month": 1,
          "year": 2024
        },
        "end": null
      }
    },
    "positions": {
      "positionsCount": 10,
      "positionHistory": [
        {
          "title": "VP of Sales",
          "companyName": "ScrapIn",
          "description": "B2B Data for AI +",
          "startEndDate": {
            "start": {
              "month": 1,
              "year": 2024
            },
            "end": null
          },
          "companyLogo": "https://media.licdn.com/dms/image/v2/D4E0BAQF-Z-m2ZKv6qQ/company-logo_200_200/B4EZcRELezHcAM-/0/1748337998127/scrapin_api_logo?e=1756339200&v=beta&t=GjTJ9cgDP2iBYJCx8GxXEg8V2hZjnNBOtvXe58eiqJ0",
          "linkedInUrl": "https://www.social.com/company/100602385/",
          "linkedInId": "100602385"
        },
        {
          "title": "Co-Founder & CEO",
          "companyName": "LukaHQ",
          "companyLocation": "London, England, United Kingdom",
          "description": "AI accounting for the mid-market",
          "startEndDate": {
            "start": {
              "month": 1,
              "year": 2023
            },
            "end": {
              "month": 12,
              "year": 2023
            }
          },
          "companyLogo": "https://media.licdn.com/dms/image/v2/C4E0BAQHUbWeUxkGCfw/company-logo_400_400/company-logo_400_400/0/1677251426049?e=1756339200&v=beta&t=qQuFuWn2EsyNX-kqmN166nzxW-DxXD66cPph71e3F7g",
          "linkedInUrl": "https://www.social.com/company/93128145/",
          "linkedInId": "93128145"
        },
        {
          "title": "Co-Founder & CEO",
          "companyName": "Telleroo",
          "companyLocation": "London",
          "description": "Leading SME payments platform for bill and payroll payments in the UK 💪",
          "startEndDate": {
            "start": {
              "month": 4,
              "year": 2016
            },
            "end": {
              "month": 10,
              "year": 2020
            }
          },
          "companyLogo": "https://media.licdn.com/dms/image/v2/D4E0BAQFg65EK-q7guw/company-logo_100_100/B4EZdkSAIuHsAQ-/0/1749734130592/telleroo_logo?e=1756339200&v=beta&t=4rKb656EJBg9K3ewqcB0_Gjt9Z2roK_8B5ABHX7Qvjg",
          "linkedInUrl": "https://www.social.com/company/10820464/",
          "linkedInId": "10820464"
        }
      ]
    },
    "schools": {
      "educationsCount": 2,
      "educationHistory": [
        {
          "degreeName": "Bachelor of Arts in Business (B.A.)",
          "fieldOfStudy": "Management & Economics",
          "linkedInUrl": "https://www.social.com/company/628151/",
          "schoolLogo": "https://media.licdn.com/dms/image/v2/C4E0BAQHWOueQUCYM2w/company-logo_400_400/company-logo_400_400/0/1631321484128?e=1756339200&v=beta&t=D_3g7F10ojzXtq-dcHxFAvMR8ANmJN_rNb3ETPf9THM",
          "schoolName": "MCI | The Entrepreneurial School®",
          "startEndDate": {
            "start": {
              "month": 1,
              "year": 2011
            },
            "end": {
              "month": 1,
              "year": 2015
            }
          }
        },
        {
          "degreeName": "International Studies - Doing Business in Brazil",
          "fieldOfStudy": null,
          "linkedInUrl": "https://www.social.com/company/8175/",
          "schoolLogo": "https://media.licdn.com/dms/image/v2/C4D0BAQFtDwxOTmj18Q/company-logo_400_400/company-logo_400_400/0/1657633907178/fgv_logo?e=1756339200&v=beta&t=Dfl7ag8K3dK8LeB2f_1AvexYw3QNaFWWsTK5KBDfIhk",
          "schoolName": "FGV - Fundação Getulio Vargas",
          "startEndDate": {
            "start": {
              "month": 1,
              "year": 2014
            },
            "end": {
              "month": 1,
              "year": 2014
            }
          }
        }
      ]
    },
    "skills": [
      "Bubble.io",
      "Changemaker",
      "Decisionmaker",
      "Big Picture View",
      "Team Motivation",
      "Public Speaking",
      "Storytelling",
      "Social Media Marketing",
      "Portfolio Management",
      "Assetmanagement",
      "Financial Analysis",
      "Asset Allocation",
      "FinTech",
      "Banking",
      "Leadership",
      "Investmentbank",
      "Financial Modeling",
      "Capital Markets",
      "Creative Strategy",
      "Corporate Finance",
      "Systematic Thinking",
      "Experimental Design",
      "Bloomberg",
      "WordPress",
      "Podcasting",
      "Content Marketing",
      "Business Model Innovation",
      "Email Marketing",
      "Web Design",
      "Blogging",
      "Tech Application",
      "Jack of all trades",
      "Google Apps",
      "Google Docs",
      "Trading",
      "Investment Strategies",
      "Microsoft Excel",
      "Commodity",
      "Fixed Income",
      "Equities"
    ],
    "languages": [
      "Deutsch",
      "English"
    ],
    "languagesWithProficiency": [
      {
        "language": "Chinese",
        "proficiency": "Native or bilingual proficiency"
      },
      {
        "language": "English",
        "proficiency": "Full professional proficiency"
      },
      {
        "language": "French",
        "proficiency": "Native or bilingual proficiency"
      },
      {
        "language": "Japanese",
        "proficiency": "Elementary proficiency"
      }
    ],
    "recommendations": {
      "recommendationsCount": 2,
      "recommendationHistory": [
        {
          "caption": "May 14, 2025, Lucas and David studied together",
          "description": "I had the opportunity to work with David, both at school and at work. In an academic environment, we worked together on several projects, in a very dynamic and effective way. We have different profiles with some similarities, and I saw him evolving in a complex professional environment and improving his skills while sharing his knowledge with me. \nWe also travelled together, and I discoverd a really curious and organized person, which are important qualities to work together in a team.",
          "authorFullname": "Lucas Nascimento",
          "authorUrl": "https://www.linkedin.com/in/lucasnascimento"
        },
        {
          "caption": "May 12, 2025, Lisa and David studied together",
          "description": "David and I spent two years studying together at ESILV. We worked on several common projects where he showed his great technical skills that helped the group a lot. David is curious, pragmatic and proactive. I also spent 3 weeks with him at Shanghai Normal University where he helped me with chinese course. I would definitely love to work with partners like David in the future. ",
          "authorFullname": "Lisa Lopes",
          "authorUrl": "https://www.linkedin.com/in/lisalopes"
        }
      ]
    },
    "certifications": {
      "certificationsCount": 1,
      "certificationHistory": [
        {
          "name": "Trading Certificate Frankfurt Stock Exchange",
          "organizationName": "Deutsche Börse",
          "organizationUrl": "https://www.social.com/company/163430/",
          "issuedDate": "Issued May 2012"
        }
      ]
    },
    "testScores": {
      "testScoresCount": 0,
      "testScoreHistory": []
    },
    "volunteeringExperiences": {
      "volunteeringExperiencesCount": 0,
      "volunteeringExperienceHistory": []
    }
  },
  "company": {
    "linkedInId": "100602385",
    "name": "ScrapIn",
    "universalName": "scrapin-api",
    "linkedInUrl": "https://www.social.com/company/100602385",
    "employeeCount": 12,
    "followerCount": 1030,
    "employeeCountRange": {
      "start": 11,
      "end": 50
    },
    "websiteUrl": "https://www.scrapin.io/",
    "tagline": "Powering AI products with Live B2B Data",
    "description": "ScrapIn provides live B2B data with all necessary context you need to build a full-featured, scalable AI tool — We hide any data scraping complexity and infrastructure. Let us handle data collection and you focus on building.",
    "industry": "Software Development",
    "phone": null,
    "specialities": [],
    "headquarter": {
      "city": "Paris",
      "country": "FR",
      "postalCode": "75000",
      "geographicArea": null,
      "street1": null,
      "street2": null
    },
    "logo": "https://media.licdn.com/dms/image/v2/D4E0BAQF-Z-m2ZKv6qQ/company-logo_200_200/B4EZcRELezHcAM-/0/1748337998127/scrapin_api_logo?e=1756339200&v=beta&t=GjTJ9cgDP2iBYJCx8GxXEg8V2hZjnNBOtvXe58eiqJ0",
    "foundedOn": {
      "year": 2020
    },
    "fundingData": null,
    "backgroundUrl": "https://media.licdn.com/dms/image/v2/D4E1BAQEnSV0NjtZSXA/company-background_200/B4EZcRNJq.HYAc-/0/1748340349995/scrapin_api_cover?e=1753966800&v=beta&t=PdbNUkpicYwyp6cn9tri20MLicIO_9ASua8ZUsJm5cg"
  }
}
Caching Available: Use the optional cacheDuration parameter to enable caching and reduce costs. Cache hits consume only 0.5 credits instead of 1 credit. See the request parameters below for details.

​
How Caching Works

Cache Hit

If we find the profile in our cache within your specified duration, we serve it instantly at 0.5 credits. This is a 50% savings on the standard price.

Cache Miss

If the profile isn’t cached, we perform a live scrape to get fresh data. This costs the standard 1 credit.
Complete History: The positionHistory, educationHistory, and certificationHistory fields return all positions, education entries, and certifications available on the profile.

​
Request Tracking & Reporting

Found incorrect or missing data? Visit your API Logs to view all requests and report issues directly from the web interface.
How to report an issue:
  1. Go to 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
The request_id helps our team investigate and resolve issues quickly. All enrichment requests are automatically logged for your convenience.

Authorizations

​
apikey
string
query
required

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

Body

application/json
​
includes
object
required

This required parameter is an object. It specifies which additional data to include in the response.

​
firstName
string

This optional parameter is a string. It represents the first name to body.

​
lastName
string

This optional parameter is a string. It represents the last name to body.

​
companyDomain
string

This optional parameter is a string. It represents the company domain/URL to body. *You can use current or any previous company to that person.

​
companyName
string

This optional parameter is a string. It represents the company name to body. *You can use current or any previous company to that person.

​
email
string

This optional parameter is a string. It represents the email to body.

​
cacheDuration
string

Optional parameter to enable caching. Accepts duration strings like '4h', '2d', '1w', '2mo', '1y'. We use the parse-duration library internally to parse these values. If the profile is found in cache within this duration, only 0.5 credits are consumed. Otherwise, fresh data is scraped for 1 credit.

Example:

"2d"

Response

The endpoint returns profile information.

​
success
boolean

Indicates success or failure of api request.

​
credits_consumed
number

Represents the number of credits consumed by this query.

​
credits_left
number

Represents the usable credits available for the user account after this query.

​
rate_limit_left
number

Represents the usable daily request limit available for the user account after this query.

​
daily_rate_limit_left
number

Represents the usable daily request limit available for the user account after this query.

​
minute_rate_limit_left
number

Represents the usable minute request limit available for the user account after this query.

​
next_minute_rate_limit_reset
string

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
object

Structured quota information for the user account. Provides the same data as the flat fields above in a more organized format.

​
person
object
​
company
​
metadata
object