People Search API

People Search Ai ark API

按公司、联系人和已保存列表筛选条件搜索职业档案。

POST/v1/run/people_search.ai_ark
可用率
100.00%
30d · 14 次调用
请求数
17
30d · 按周,近 12 周
响应时间
2.8s
中位数 · 30d

调用方式

一个请求获取 People Search Ai ark

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/people_search.ai_ark",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "page": 0,
        "size": 1
    },
)
print(res.json())
打开于
获取免费密钥
示例响应

这个示例展示了 141 个字段中的 64 个。查看全部字段

{
  "found": true,
  "data": {
    "people": [
      {
        "fullName": "Priya Nandakumar",
        "linkedinUrl": "https://www.linkedin.com/in/priyanandakumar-gm/",
        "linkedinHandle": "priyanandakumar-gm",
        "profileId": "aiark_p_88213",
        "image": "https://media.aiark.io/profile/aiark_p_88213.jpg?exp=1759190400",
        "firstName": "Priya",
        "lastName": "Nandakumar",
        "headline": "Growth Marketing Lead at Bramblewood Analytics",
        "title": "Growth Marketing Lead",
        "summary": "Run lifecycle and paid growth for a 340-person B2B analytics company. Previously scaled acquisition at two seed-stage startups.",
        "industry": "Computer Software",
        "seniority": "Manager",
        "departments": [
          "Marketing"
        ],
        "subDepartments": [
          "Growth"
        ],
        "functions": [
          "Growth Marketing"
        ],
        "skills": [
          "Lifecycle Marketing",
          "Paid Acquisition",
          "SQL",
          "A/B Testing"
        ],
        "primaryLanguage": "en",
        "primaryLanguageCountry": "US",
        "twitterUrl": "https://x.com/priyagrows",
        "followerCount": 4210,
        "connectionCount": 1980,
        "premium": true,
        "openToWork": false,
        "hiring": true,
        "verified": false,
        "influencer": false,
        "location": "Austin, Texas, United States",
        "country": "United States",
        "state": "Texas",
        "city": "Austin",
        "locationShort": "Austin, TX",
        "companyName": "Bramblewood Analytics",
        "companyIndustry": "Computer Software",
        "companyType": "PRIVATELY_HELD",
        "companyFoundedYear": 2015,
        "companyEmployeeCount": 340,
        "companyDomain": "bramblewoodanalytics.com",
        "companyWebsiteUrl": "https://bramblewoodanalytics.com",
        "companyLinkedinUrl": "https://www.linkedin.com/company/bramblewood-analytics",
        "companyCountry": "United States",
        "companyCity": "Austin",
        "experience": [
          {
            "companyName": "Bramblewood Analytics",
            "companyLinkedinUrl": "https://www.linkedin.com/company/bramblewood-analytics",
            "startUtc": 1651363200,
            "positions": [
              {
                "title": "Growth Marketing Lead",
                "companyName": "Bramblewood Analytics",
                "employmentType": "Full-time",
                "location": "Austin, TX",
                "startUtc": 1651363200
              }
            ]
          }
        ],
        "educations": [
          {
            "schoolName": "University of Texas at Austin",
            "degreeName": "B.B.A.",
            "fieldOfStudy": "Marketing",
            "startUtc": 1157068800,
            "endUtc": 1272672000
          }
        ]
      },
      {
        "fullName": "Devon Ashcroft",
        "linkedinUrl": "https://www.linkedin.com/in/devonashcroft/",
        "linkedinHandle": "devonashcroft",
        "profileId": "aiark_p_51820",
        "firstName": "Devon",
        "lastName": "Ashcroft",
        "headline": "Growth Marketing Lead at Bramblewood Analytics",
        "title": "Growth Marketing Lead",
        "industry": "Computer Software",
        "seniority": "Manager",
        "departments": [
          "Marketing"
        ],
        "location": "Denver, Colorado, United States",
        "country": "United States",
        "state": "Colorado",
        "city": "Denver",
        "companyName": "Bramblewood Analytics",
        "companyDomain": "bramblewoodanalytics.com",
        "companyEmployeeCount": 340
      },
      {
        "fullName": "Miriam Okafor",
        "linkedinUrl": "https://www.linkedin.com/in/miriamokafor/",
        "linkedinHandle": "miriamokafor",
        "profileId": "aiark_p_39044",
        "firstName": "Miriam",
        "lastName": "Okafor",
        "headline": "Senior Growth Marketing Lead at Bramblewood Analytics",
        "title": "Senior Growth Marketing Lead",
        "industry": "Computer Software",
        "seniority": "Manager",
        "departments": [
          "Marketing"
        ],
        "location": "Chicago, Illinois, United States",
        "country": "United States",
        "state": "Illinois",
        "city": "Chicago",
        "companyName": "Bramblewood Analytics",
        "companyDomain": "bramblewoodanalytics.com",
        "companyEmployeeCount": 340
      }
    ],
    "page": 0,
    "size": 3,
    "total": 128,
    "totalPages": 43
  }
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • accountobject

    {"name":{"any":{"include":["Bramblewood Analytics"]}},"industries":{"any":{"include":["Computer Software"]}}}

    公司级筛选条件,以筛选名称为键。可用名称:domain, employeeSize, foundedYear, funding, geoLocation, industries, keyword, language, linkedin, metric, naics, name, phoneNumber, productAndServices, retailSize, revenue, socialMedia, socialMediaLink, technologies, technology, type, url, location。其他名称会被拒绝。大多数名称接受 {"any"|"all": {"include": [...], "exclude": [...]}},例如 {"type": {"any": {"include": ["PUBLIC_COMPANY"]}}}。any/all 对象放在筛选名称内部,绝不能放在 account 的顶层。规模和金额类筛选(employeeSize、foundedYear、revenue、retailSize)则接受 {"type": "RANGE", "range": {"start": 50, "end": 200}} 或 {"type": "ALL"|"NONE"};geoLocation 接受 {"position": {"lat": 0, "lng": 0}, "radius": 50, "unit": "km"|"mi"};keyword 接受 {"any"|"all": {"include"|"exclude": {"content": ["..."], "sources": [{"mode": "WORD"|"SMART"|"STRICT", "source": "NAME"|"KEYWORD"|"SEO"|"DESCRIPTION"|"INDUSTRY"}]}}}。

  • contactobject

    {"title":{"any":{"include":["Growth Marketing Lead"]}},"seniority":{"any":{"include":["Manager"]}}}

    人员级筛选条件,以筛选名称为键。可用名称:certification, certifications, company, contactLanguage, contactLocation, currentCompany, department, departmentAndFunction, education, experience, fullName, function, keyword, language, linkedin, location, name, pastCompany, profileBadge, seniority, skill, skills, socialMedia, socialMediaFollower, socialMediaLink, socialProfile, title。其他名称会被拒绝。名称接受 {"any"|"all": {"include": [...], "exclude": [...]}},any/all 对象放在筛选名称内部,而不是 contact 的顶层。自由文本搜索通过 keyword 进行,它接受 {"any"|"all": {"include"|"exclude": {"content": ["..."], "sources": [{"mode": "WORD"|"SMART"|"STRICT", "source": "HEADLINE"|"SUMMARY"|"ORGANIZATION"|"SKILL"|"WORK_HISTORY_DESCRIPTION"|"EDUCATION_DESCRIPTION"|"CERTIFICATION"|"PUBLICATION"|"PATENT"|"AWARD"|"COURSE"|"PROJECTS"|"VOLUNTEERING"|"LANGUAGE_SKILL"|"TEST_SCORE"}]}}},例如 {"keyword": {"any": {"include": {"content": ["engineer"], "sources": [{"mode": "SMART", "source": "HEADLINE"}]}}}}。

  • listsobject

    AI Ark 已保存列表筛选表达式。

  • pageinteger

    结果页码,从 0 开始。

  • sizeinteger

    3

    本页最多返回的人数。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

datadata

Normalized people and page metadata, or null when no people matched.

  • pageinteger

    0

    Zero-based page number returned by the source.

  • sizeinteger

    3

    Configured page size.

  • totalinteger

    128

    Total matching people.

  • totalPagesinteger

    43

    Total result pages.

each peopledata.people[]

People returned on this page.

  • birthDatestring

    Birthday as published on the profile, in YYYY-MM-DD form. LinkedIn lets a member hide the year, and the source encodes that as the placeholder year 1600 - treat the year as unknown when it reads 1600 rather than as a real date.

  • careerStartUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • citystring

    Austin

    Location city.

  • companyAcquisitionCountinteger

    Number of acquisitions the source records for the current company.

  • companyAddressstring

    Current company headquarters address as published by the source.

  • companyCitystring

    Austin

    Current company headquarters city.

  • companyContinentstring

    Current company headquarters continent.

  • companyCountrystring

    United States

    Current company headquarters country.

  • companyCrunchbaseUrlstring

    Current company's Crunchbase URL.

  • companyDescriptionstring

    Current company description.

  • companyDomainstring

    bramblewoodanalytics.com

    Current company domain.

  • companyDomainLtdstring

    The source's second copy of the current company's domain. Usually identical to companyDomain; it can differ when the source resolves a redirect or a country domain differently, so compare the two rather than assuming they match.

  • companyEmployeeCountinteger

    340

    Estimated employees at the current company.

  • companyEmployeeRangeMininteger

    Lower bound of the current company's published employee range.

  • companyFacebookUrlstring

    Current company's canonical Facebook URL.

  • companyFoundedYearinteger

    2015

    Year the current company was founded.

  • companyIdstring

    The source's own record identifier for the current company, exposed so you can trace a result back to the record it came from.

  • companyImagestring

    Current company logo URL. This is a SIGNED, EXPIRING image-proxy URL - the path carries an exp: epoch roughly five days out - so fetch and store the image promptly rather than storing this URL.

  • companyIndustriesstring[]

    Additional industries for the current company.

  • companyIndustrystring

    Computer Software

    Current company's primary industry.

  • companyKeywordsstring[]

    Keywords describing the current company.

  • companyLanguagesstring[]

    Languages the current company publishes in.

  • companyLatitudenumber

    Current company headquarters latitude in decimal degrees.

  • companyLegalNamestring

    Current company's registered legal name.

  • companyLinkedinUrlstring

    https://www.linkedin.com/company/bramblewood-analytics

    Current company's canonical LinkedIn URL.

  • companyLongitudenumber

    Current company headquarters longitude in decimal degrees.

  • companyNaicsstring[]

    NAICS codes for the current company.

  • companyNamestring

    Bramblewood Analytics

    Current company name.

  • companyOverviewstring

    Longer overview of the current company. Overlaps companyDescription but is a separately maintained blurb and is often longer or more current.

  • companyPostalCodestring

    Current company headquarters postal code.

  • companyRevenueMaxinteger

    Upper bound of the current company's estimated annual revenue in USD.

  • companyRevenueMininteger

    Lower bound of the current company's estimated annual revenue in USD.

  • companyRevenueRangestring

    The same annual revenue estimate as a single hyphenated range string, for example 500000000-1000000000. It duplicates companyRevenueMin and companyRevenueMax; use those for arithmetic.

  • companySeoDescriptionstring

    The meta description the source scraped from the current company's website. It is site copy, not the source's own writing, so it may be in another language or out of date.

  • companyStartUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • companyStatestring

    Current company headquarters state or region.

  • companyStreetstring

    Current company headquarters street or neighbourhood line.

  • companySubOrganizationsstring[]

    The source's own record identifiers for the current company's sub-organizations, exposed so you can look each one up in the company endpoints.

  • companyTwitterUrlstring

    Current company's canonical X (Twitter) URL.

  • companyTypestring

    PRIVATELY_HELD

    Current company's organization type.

  • companyUpdatedUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • companyWebsiteUrlstring

    https://bramblewoodanalytics.com

    Current company website URL.

  • connectionCountinteger

    1980

    LinkedIn connection count.

  • countrystring

    United States

    Location country.

  • creatorboolean

    Whether the profile is in LinkedIn creator mode.

  • departmentsstring[]

    Departments the current role belongs to.

  • facebookUrlstring

    Canonical Facebook profile URL.

  • firstNamestring

    Priya

    Person's first name.

  • followableany

    Whether the profile can be followed without connecting. Untyped passthrough: the source returns null for most profiles, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • followerCountinteger

    4210

    LinkedIn follower count.

  • fullNamestring

    Priya Nandakumar

    Person's full name.

  • functionsstring[]

    Job functions the current role covers.

  • githubUrlstring

    Canonical GitHub profile URL.

  • headlinestring

    Growth Marketing Lead at Bramblewood Analytics

    Professional profile headline.

  • hiringboolean

    true

    Whether the profile is flagged as hiring.

  • imagestring

    https://media.aiark.io/profile/aiark_p_88213.jpg?exp=1759190400

    Profile photo URL. This is a SIGNED, EXPIRING image-proxy URL - the path carries an exp: epoch roughly five days out - so fetch and store the image promptly rather than storing this URL.

  • industrystring

    Computer Software

    Industry the person works in.

  • influencerboolean

    false

    Whether the profile carries a LinkedIn influencer badge.

  • lastNamestring

    Nandakumar

    Person's last name.

  • linkedinHandlestring

    priyanandakumar-gm

    LinkedIn public profile handle, the trailing segment of the profile URL.

  • linkedinUrlstring

    https://www.linkedin.com/in/priyanandakumar-gm/

    Canonical LinkedIn profile URL.

  • locationstring

    Austin, Texas, United States

    Formatted location.

  • locationPositionany

    Coordinates for the person's location as the source returns them. Untyped passthrough: the source returns null for most profiles, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • locationShortstring

    Austin, TX

    Shorter form of the same location, usually city and state without country or continent. It duplicates part of location.

  • middleNamestring

    Person's middle name.

  • networkInfluencerboolean

    The same influencer flag as the badge above, carried on the source's network statistics instead of its badge block. Expected to agree with influencer; compare them if the distinction matters to you.

  • openToWorkboolean

    false

    Whether the profile is flagged open to work.

  • premiumboolean

    true

    Whether the profile carries a LinkedIn premium badge.

  • previousJobTitlesany

    Job titles the person held before the current one, as the source returns them. Untyped passthrough: the source returns null for most profiles, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it. The experience array carries the same history in a typed form.

  • primaryLanguagestring

    en

    Primary profile language code.

  • primaryLanguageCountrystring

    US

    Country code paired with the primary profile language, for example US.

  • profileBackgroundany

    The profile background or cover image as the source returns it. Untyped passthrough: the source returns null for most profiles, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • profileIdstring

    aiark_p_88213

    The source's own record identifier for this person, exposed so you can trace a result back to the record it came from.

  • profileLanguagesany

    Languages the person lists on the profile, as the source returns them. Untyped passthrough: the source returns null for most profiles, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • senioritystring

    Manager

    Seniority level inferred for the current role.

  • skillsstring[]

    Skills listed on the profile.

  • statestring

    Texas

    Location state or region.

  • subDepartmentsstring[]

    Sub-departments the current role belongs to.

  • summarystring

    Run lifecycle and paid growth for a 340-person B2B analytics company. Previously scaled acquisition at two seed-stage startups.

    Profile summary or about section.

  • titlestring

    Growth Marketing Lead

    Current job title.

  • titleStartUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • twitterUrlstring

    https://x.com/priyagrows

    Canonical X (Twitter) profile URL.

  • updatedUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • verifiedboolean

    false

    Whether LinkedIn has verified the profile.

each companyAcquisitiondata.people[].companyAcquisitions[]

Acquisitions the source records for the current company, with the role telling you which side the company was on.

  • announcedUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • imageKeystring

    The source's internal image key for the counterparty. It is a bare key, not a URL.

  • namestring

    Counterparty organization name.

  • recordIdstring

    The source's own slug for the counterparty organization.

  • rolestring

    The current company's side of the deal, for example acquiree.

each companyLocationdata.people[].companyLocations[]

Every office the source lists for the current company, including the headquarters already reported in the companyCountry/companyCity fields.

  • addressstring

    Office address as published by the source.

  • citystring

    Office city.

  • continentstring

    Office continent.

  • countrystring

    Office country.

  • latitudenumber

    Office latitude in decimal degrees.

  • longitudenumber

    Office longitude in decimal degrees.

  • postalCodestring

    Office postal code.

  • statestring

    Office state or region.

  • streetstring

    Office street or neighbourhood line.

each companyTechnologydata.people[].companyTechnologies[]

Technologies detected on the current company's web presence.

  • categorystring

    Technology category.

  • namestring

    Technology name.

each educationdata.people[].educations[]

Education history listed on the profile.

  • degreeNamestring

    B.B.A.

    Degree earned.

  • endUtcinteger

    1272672000

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • fieldOfStudystring

    Marketing

    Field of study.

  • gradestring

    Grade as published on the profile.

  • schoolIdany

    The source's own record identifier for the school. Untyped passthrough: the source returns null on the profiles observed so far, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • schoolImageany

    The school logo as the source returns it. Untyped passthrough: the source returns null on the profiles observed so far, so its populated shape is not yet proven and this field carries whatever the source sends without reshaping it.

  • schoolNamestring

    University of Texas at Austin

    School name.

  • schoolUrlstring

    Canonical school page URL.

  • startUtcinteger

    1157068800

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

each experiencedata.people[].experience[]

Work history grouped by company, most recent first.

  • companyEmployeeRangeMaxinteger

    Upper bound of this company's published employee range.

  • companyEmployeeRangeMininteger

    Lower bound of this company's published employee range.

  • companyIdstring

    The source's own record identifier for this company, exposed so you can trace a result back to the record it came from.

  • companyImagestring

    Company logo URL. This is a SIGNED, EXPIRING image-proxy URL - the path carries an exp: epoch roughly five days out - so fetch and store the image promptly rather than storing this URL.

  • companyLinkedinUrlstring

    https://www.linkedin.com/company/bramblewood-analytics

    Canonical LinkedIn URL for this company.

  • companyNamestring

    Bramblewood Analytics

    Company name for this block of work history.

  • endUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • startUtcinteger

    1651363200

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

each positiondata.people[].experience[].positions[]

Individual roles held at this company.

  • companyNamestring

    Bramblewood Analytics

    Company name as published on the role.

  • descriptionstring

    Role description.

  • employmentTypestring

    Full-time

    Employment type, for example Full-time.

  • endUtcinteger

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • locationstring

    Austin, TX

    Role location.

  • startUtcinteger

    1651363200

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • titlestring

    Growth Marketing Lead

    Role title.

each supportedLocaledata.people[].supportedLocales[]

Every locale the profile is available in. The first entry usually repeats primaryLanguage and primaryLanguageCountry.

  • countrystring

    Country code for this locale.

  • languagestring

    Language code for this locale.

top level
  • foundboolean

    true

    Whether the search returned at least one person.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 People Search Ai ark API

AnyAPI 的 People Search Ai ark API 只需一次 POST 请求 /v1/run/people_search.ai_ark,就以统一格式的 JSON 返回 People Search 数据。按公司、联系人和已保存列表筛选条件搜索职业档案。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千条结果 US$8.40,单次请求最多 US$0.84,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 People Search Ai ark API 调用中有 100.0% 成功,响应时间中位数为 2.8 秒,共测量 14 次调用。

费用:每千条结果 US$8.40,单次请求最多 US$0.84,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按公司、联系人和已保存列表筛选条件搜索职业档案。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 People Search Ai ark API 调用中有 100.0% 成功,响应时间中位数为 2.8 秒,共测量 14 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡。

向 https://api.getanyapi.com/v1/run/people_search.ai_ark 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。