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

> ## Agent Instructions
> The Exa API is served at https://api.exa.ai. Authenticate with `Authorization: Bearer $EXA_API_KEY` (or `x-api-key: $EXA_API_KEY`); create keys at https://dashboard.exa.ai/api-keys?utm_source=docs&utm_medium=docs&utm_campaign=markdown_instructions. Every way an agent can get access to Exa is described at https://exa.ai/auth.md.
> Prefer the official SDKs, `exa-py` (`pip install exa-py`) and `exa-js` (`npm install exa-js`); both read `EXA_API_KEY` from the environment.
> Tool-using agents can call Exa without writing code through the hosted MCP server at https://mcp.exa.ai/mcp, or install the Exa agent skill with `npx skills add exa-labs/agent-skills` (skill file: https://exa.ai/docs/skill.md).
> The OpenAPI specs at https://exa.ai/docs/exa-spec.yaml and https://exa.ai/docs/team-management-spec.yaml are the source of truth for request and response schemas.

# Jinko

> Flight and Hotel search with real-time pricing.

[Jinko](https://gojinko.com) is a travel search platform providing flight and
hotel search with real-time pricing. Search live flight offers for a route and
date, shop hotel rooms and rates for a destination or specific properties, and
explore destinations reachable from your departure airports.

Attach `jinko` to an [Exa Agent](https://exa.ai/docs/agent/quickstart.md) run through
[Exa Connect](https://exa.ai/docs/agent/connect/overview.md), and the agent queries
Jinko alongside Exa web search.

## Use it for

* Searching live flight offers with fares, baggage, and change policies for a route and date.
* Finding hotels with live room rates for a destination, or re-shopping specific hotels.
* Discovering destinations and flexible dates across date windows, cabin classes, and budgets.

## Provider ID

Use this value in `dataSources`:

```text theme={null}
jinko
```

## Example

Find beach destinations reachable from New York for under \$400 round-trip in March.

```python Python theme={null}
from exa_py import Exa

exa = Exa()
run = exa.agent.runs.create(
    query="Find beach destinations reachable from New York for under $400 round-trip in March.",
    data_sources=[{"provider": "jinko"}],
    output_schema={
        "type": "object",
        "required": ["destinations"],
        "properties": {
            "destinations": {
                "type": "array",
                "maxItems": 10,
                "items": {
                    "type": "object",
                    "required": ["city", "iataCode", "lowestFare"],
                    "properties": {
                        "city": {"type": "string"},
                        "iataCode": {"type": "string"},
                        "lowestFare": {"type": "number", "description": "round-trip fare in USD"},
                    },
                },
            }
        },
    },
)
run = exa.agent.runs.poll_until_finished(run.id)
```

```javascript JavaScript theme={null}
import Exa from "exa-js";

const exa = new Exa();
const run = await exa.agent.runs.create({
  query: "Find beach destinations reachable from New York for under $400 round-trip in March.",
  dataSources: [{ provider: "jinko" }],
  outputSchema: {
    type: "object",
    required: ["destinations"],
    properties: {
      destinations: {
        type: "array",
        maxItems: 10,
        items: {
          type: "object",
          required: ["city", "iataCode", "lowestFare"],
          properties: {
            city: { type: "string" },
            iataCode: { type: "string" },
            lowestFare: { type: "number", description: "round-trip fare in USD" },
          },
        },
      },
    },
  },
});
```

```bash cURL theme={null}
curl -s -X POST "https://api.exa.ai/agent/runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EXA_API_KEY" \
  -d '{
    "query": "Find beach destinations reachable from New York for under $400 round-trip in March.",
    "dataSources": [{ "provider": "jinko" }],
    "outputSchema": {
      "type": "object",
      "required": ["destinations"],
      "properties": {
        "destinations": {
          "type": "array",
          "maxItems": 10,
          "items": {
            "type": "object",
            "required": ["city", "iataCode", "lowestFare"],
            "properties": {
              "city": { "type": "string" },
              "iataCode": { "type": "string" },
              "lowestFare": { "type": "number", "description": "round-trip fare in USD" }
            }
          }
        }
      }
    }
  }'
```

## Pairs well with

* [Similarweb](https://exa.ai/docs/agent/connect/similarweb.md): research the travel sites and booking platforms behind a destination.
* [Particle](https://exa.ai/docs/agent/connect/particle.md): pull recent coverage and travel commentary for a place.

## Next steps

> [card] [Attach it to a run](https://exa.ai/docs/agent/connect/overview.md)
>
> The Exa Connect quickstart covers `dataSources`, pricing, and the full partner catalog.

> [card] [Combine providers](https://exa.ai/docs/agent/connect/combining-providers.md)
>
> Attach up to five partners to one run and shape the query so each one fires.

> [card] [Learn Exa Agent](https://exa.ai/docs/agent/quickstart.md)
>
> Create runs, stream progress, design output schemas, and control effort and cost.

> [card] [Get an API key](https://dashboard.exa.ai/api-keys?utm_source=docs\&utm_medium=docs\&utm_campaign=connect_provider_card)
>
> Create a key in the dashboard and run this page's example as-is. New accounts start with free credits.