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

# Search Results

> Read your search results, save them as a list and download exports.

## Get search status

Poll `GET /v1/jobs/{job_id}` after `next_poll_after` seconds. A successful search returns `search_id`, `count` and `output_file_id` in `result`.

## Read items

Set `JOB_ID` to the `job_id` returned by your search. Python examples require `requests`.

```bash cURL theme={null}
API=https://api.sixtyfour.ai
curl --fail-with-body -sS "$API/v1/jobs/$JOB_ID/items?page_size=100" \
  -H "x-api-key: YOUR_API_KEY"
```

```python Python theme={null}
import os
import requests

API = "https://api.sixtyfour.ai"
headers = {"x-api-key": "YOUR_API_KEY"}
response = requests.get(f"{API}/v1/jobs/{os.environ['JOB_ID']}/items",
    headers=headers, params={"page_size": 100})
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const API = "https://api.sixtyfour.ai";
const headers = { "x-api-key": "YOUR_API_KEY" };
const response = await fetch(API + "/v1/jobs/" + process.env.JOB_ID + "/items?page_size=100", { headers });
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

## Response

Read the finished profiles from `GET /v1/jobs/{job_id}/items`.

```json Item response theme={null}
{
  "items": [
    {
      "index": 0,
      "custom_id": null,
      "input": {
        "max_results": 3,
        "query": "People at Sixtyfour"
      },
      "status": "succeeded",
      "result": {
        "linkedinUrl": "https://linkedin.com/in/christopher-price-59a24b178",
        "fullName": "Christopher Price",
        "currentCompany": "Sixtyfour",
        "currentPosition": "Co-Founder"
      },
      "error": null
    }
  ],
  "next_cursor": null
}
```

Person profile keys use camelCase, such as `fullName` and `linkedinUrl`. Each item repeats the retained search parameters in `input`.

## Item fields

| Field | Type | Description |
| - | - | - |
| `index` | integer | Zero-based position among the Job's results, not an input-row index. |
| `custom_id` | null | Search results have no per-person input identifier. |
| `input` | object | Search parameters retained by the Job, repeated on every item. |
| `status` | string | This result's outcome, independent of the Job's overall status. |
| `result` | object or null | Indexed person or company data. Person fields such as `fullName` use camelCase. |
| `error` | object or null | Error for this item; null on success. |

## Result fields

A search result carries the profile fields below. A field with no value is `""`, `null` or `0`.

### People

| Field | Type | Contains |
| - | - | - |
| `linkedinUrl` | string | LinkedIn profile URL. |
| `fullName` | string | Full name. |
| `headline` | string | Profile headline. |
| `summary` | string | Profile biography. |
| `currentCompany`, `currentPosition` | string | Current employer and job title. |
| `currentCompanyStartDate`, `currentPositionStartDate` | string | When the person joined the company and started the role, as `YYYY-MM`, or `YYYY` when the month is unknown. |
| `previousCompany`, `previousPosition` | string | Employer and job title before the current one. |
| `locationName` | string | City, region and country, such as `San Francisco, California, United States`. |
| `locationCountry` | string | Two-letter country code, such as `US`. |
| `industry` | string | Industry on the profile. |
| `totalExperienceYears` | number | Years of work experience, such as `1.78`. |
| `education`, `degree`, `fieldOfStudy` | string | School, degree and field of study from the first education entry on the profile. |
| `graduationYear` | integer or string | Graduation year for that entry, such as `2019`. `""` when unknown. |
| `skills`, `certifications`, `languages` | string | Values in one string, separated by `; `: up to 10 skills, up to 5 certifications, and every language, with its proficiency in parentheses when known. |
| `connectionsCount`, `followersCount` | integer | LinkedIn connections and followers. |
| `logoUrl`, `currentCompanyLogo` | string | Profile photo and employer logo. See [Photo and logo URLs](#photo-and-logo-urls). |

### Companies

| Field | Type | Contains |
| - | - | - |
| `linkedinUrl` | string | LinkedIn company page URL. |
| `name` | string | Company name. |
| `industry` | string | Industry. |
| `overview`, `tagline` | string | Company description and one-line summary. |
| `website`, `domain` | string | Website URL and its domain, such as `sixtyfour.ai`. |
| `employeeCount` | integer | Reported number of employees. |
| `employeesOnLinkedIn` | integer | Employees with a LinkedIn profile. |
| `revenue` | number | Annual revenue. `0` when unknown. |
| `foundedAt` | string | Founding year, such as `"1993"`. `""` when unknown. |
| `headquartersCity`, `headquartersCountry`, `headquartersRegion` | string | Headquarters location. |
| `locationCount` | integer | Number of office locations. |
| `specialties`, `tags` | string | Values in one string, separated by `, `. |
| `fundingAmount` | number or null | Amount raised in the latest funding round. |
| `fundingType` | string | Type of the latest funding round. |
| `fundingYear` | integer or null | Year the latest funding round was announced. |
| `fundingRoundsCount` | integer | Number of funding rounds. `0` when none are known. |
| `logoUrl` | string | Company logo URL. |

## Paginate with cursors

Pass `next_cursor` unchanged as `cursor` on the next items request. Keep the same Job and `page_size`. Stop when `next_cursor` is null, not when an individual page is empty. See [Async Jobs](https://docs.sixtyfour.ai/api-reference/async-jobs.md#read-every-item).

## Export search results

Use the [shared export and download flow](https://docs.sixtyfour.ai/api-reference/async-jobs.md#export-results) with the finished Search Job's ID as `from.job_id`.

## Download search results

The [file download step](https://docs.sixtyfour.ai/api-reference/async-jobs.md#export-results) uses the export Job's `result.output_file_id` to obtain a signed URL. It also explains how to refresh an expired URL without repeating research.

## CSV columns

Exports contain the successful items' result fields. Objects and lists use JSON text in CSV cells. Choose `json` or `ndjson` to keep structured values.

| Mode | Columns |
| - | - |
| `people` | `linkedinUrl`, `fullName`, `headline`, `summary`, `logoUrl`, `currentCompany`, `currentPosition`, `currentCompanyLogo`, `currentCompanyStartDate`, `currentPositionStartDate`, `previousCompany`, `previousPosition`, `locationName`, `locationCountry`, `industry`, `totalExperienceYears`, `education`, `degree`, `fieldOfStudy`, `graduationYear`, `skills`, `certifications`, `languages`, `connectionsCount`, `followersCount` |
| `company` | `linkedinUrl`, `name`, `industry`, `overview`, `tagline`, `website`, `domain`, `logoUrl`, `employeeCount`, `employeesOnLinkedIn`, `revenue`, `foundedAt`, `headquartersCity`, `headquartersCountry`, `headquartersRegion`, `locationCount`, `specialties`, `tags`, `fundingAmount`, `fundingType`, `fundingYear`, `fundingRoundsCount` |

### Spreadsheet-safe CSV

CSV exports escape spreadsheet formulas. JSON and NDJSON preserve the original values.

### Photo and logo URLs

People rows carry image URLs that need no credentials, so they can be embedded directly in an `<img>` tag, CRM record, or spreadsheet cell.

| Field | Contains |
| - | - |
| `logoUrl` | The person's profile photo URL. Use it exactly as returned, including its query string. Empty or `null` when the person has no photo. |
| `currentCompanyLogo` | The employer's LinkedIn logo. Empty when no company logo is available. |

When `logoUrl` holds a bare 32-character key instead of a URL, the photo is at `https://api.sixtyfour.ai/v1/media/profiles/{key}`. These URLs do not expire. See [Rate Limits](https://docs.sixtyfour.ai/api-reference/rate-limits.md#media) and [Handling Errors](https://docs.sixtyfour.ai/api-reference/errors.md).

## Replay a saved search

Start the same people or company search route with `{"search_id":"YOUR_SEARCH_ID","max_results":10}`. This starts a new Job. Read the original Job's items when you only need its existing results.

## Search limits

Read `GET /v1/people/search/fields` or `GET /v1/companies/search/fields` for `max_results` and query limits. See [Rate Limits](https://docs.sixtyfour.ai/api-reference/rate-limits.md).

> [card] [Try it](https://docs.sixtyfour.ai/api-reference/jobs/list-job-items.md)
>
> Open the List Job Items API Reference playground.

## Related

* [Async Jobs](https://docs.sixtyfour.ai/api-reference/async-jobs.md)
* [Handling Errors](https://docs.sixtyfour.ai/api-reference/errors.md)
* [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md#search)

> [!NOTE]
>
> For the original routes, see [Legacy Search Results](https://docs.sixtyfour.ai/api-reference/legacy/search-results.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.