API para People Search

API para People Search: Ai ark

Busque perfis profissionais com filtros de conta, contato e listas salvas.

POST/v1/run/people_search.ai_ark
Disponibilidade
100,00%
30d · 14 chamadas
Requisições
17
30d · semanal, últimas 12 sem.
Resposta
2,8s
mediana · 30d

Como chamar

Obtenha Ai ark do People Search em uma só requisição

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())
Abrir em
Obter chave grátis
Resposta de exemplo

Este exemplo mostra 64 de 141 campos. Ver todos os campos

{
  "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
  }
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • accountobject

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

    Filtros de empresa, indexados pelo nome do filtro. Nomes aceitos: domain, employeeSize, foundedYear, funding, geoLocation, industries, keyword, language, linkedin, metric, naics, name, phoneNumber, productAndServices, retailSize, revenue, socialMedia, socialMediaLink, technologies, technology, type, url, location. Qualquer outro nome é recusado. A maioria dos nomes recebe {"any"|"all": {"include": [...], "exclude": [...]}}, por exemplo {"type": {"any": {"include": ["PUBLIC_COMPANY"]}}}. O objeto any/all vai DENTRO do nome do filtro, nunca no nível superior de account. Filtros de porte e valores (employeeSize, foundedYear, revenue, retailSize) recebem {"type": "RANGE", "range": {"start": 50, "end": 200}} ou {"type": "ALL"|"NONE"}; geoLocation recebe {"position": {"lat": 0, "lng": 0}, "radius": 50, "unit": "km"|"mi"}; keyword recebe {"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"]}}}

    Filtros de pessoa, indexados pelo nome do filtro. Nomes aceitos: 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. Qualquer outro nome é recusado. Os nomes recebem {"any"|"all": {"include": [...], "exclude": [...]}}, com o objeto any/all DENTRO do nome do filtro, e não no nível superior de contact. A busca em texto livre é feita por keyword, que recebe {"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"}]}}}, por exemplo {"keyword": {"any": {"include": {"content": ["engineer"], "sources": [{"mode": "SMART", "source": "HEADLINE"}]}}}}.

  • listsobject

    Expressão de filtro de lista salva da AI Ark.

  • pageinteger

    Página de resultados, começando em zero.

  • sizeinteger

    3

    Número máximo de pessoas a retornar nesta página.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Ai ark da API para People Search

O endpoint Ai ark da AnyAPI para People Search retorna dados de People Search em JSON normalizado com uma chamada POST para /v1/run/people_search.ai_ark. Busque perfis profissionais com filtros de conta, contato e listas salvas. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 8,40 por mil resultados, e nunca mais de US$ 0,84 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Ai ark da API para People Search feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,8 segundos, em 14 chamadas medidas.

Custa US$ 8,40 por mil resultados, e nunca mais de US$ 0,84 por requisição, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque perfis profissionais com filtros de conta, contato e listas salvas. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Ai ark da API para People Search feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,8 segundos, em 14 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/people_search.ai_ark com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.