API de People Search: Ai ark
Busca perfiles profesionales con filtros de empresa, de contacto y de listas guardadas.
Precios
Precios del endpoint Ai ark de la API de People Search
Llámalo
Obtén Ai ark de People Search en una sola solicitud
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())
Este ejemplo muestra 64 de 141 campos. Ver todos los 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
}
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- accountobject
{"name":{"any":{"include":["Bramblewood Analytics"]}},"industries":{"any":{"include":["Computer Software"]}}}
Filtros a nivel de empresa, indexados por nombre de filtro. Nombres aceptados: domain, employeeSize, foundedYear, funding, geoLocation, industries, keyword, language, linkedin, metric, naics, name, phoneNumber, productAndServices, retailSize, revenue, socialMedia, socialMediaLink, technologies, technology, type, url, location. Cualquier otro nombre se rechaza. La mayoría de los nombres reciben {"any"|"all": {"include": [...], "exclude": [...]}}, por ejemplo {"type": {"any": {"include": ["PUBLIC_COMPANY"]}}}. El objeto any/all va DENTRO del nombre del filtro, nunca en el nivel superior de account. Los filtros de tamaño y dinero (employeeSize, foundedYear, revenue, retailSize) reciben en cambio {"type": "RANGE", "range": {"start": 50, "end": 200}} o {"type": "ALL"|"NONE"}; geoLocation recibe {"position": {"lat": 0, "lng": 0}, "radius": 50, "unit": "km"|"mi"}; keyword recibe {"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 a nivel de persona, indexados por nombre de filtro. Nombres aceptados: 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. Cualquier otro nombre se rechaza. Los nombres reciben {"any"|"all": {"include": [...], "exclude": [...]}}, con el objeto any/all DENTRO del nombre del filtro y no en el nivel superior de contact. La búsqueda de texto libre va por keyword, que recibe {"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 ejemplo {"keyword": {"any": {"include": {"content": ["engineer"], "sources": [{"mode": "SMART", "source": "HEADLINE"}]}}}}.
- listsobject
Expresión de filtro de listas guardadas de AI Ark.
- pageinteger
Página de resultados, empezando en cero.
- sizeinteger
3
Número máximo de personas a devolver en esta página.
Respuesta
JSON, un valor de ejemplo por campo.
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.
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.
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.
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.
Technologies detected on the current company's web presence.
- categorystring
Technology category.
- namestring
Technology name.
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.
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.
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.
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.
- 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.
Preguntas frecuentes
Acerca del endpoint Ai ark de la API de People Search
El endpoint Ai ark de AnyAPI para People Search devuelve datos de People Search como JSON normalizado con una sola llamada POST a /v1/run/people_search.ai_ark. Busca perfiles profesionales con filtros de empresa, de contacto y de listas guardadas. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta US$8.40 por cada 1,000 resultados, y nunca más de US$0.84 por una sola solicitud, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Ai ark de la API de People Search a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.8 segundos en 14 llamadas medidas.