# Your First API Call

export const searchQueryParams = [
  {
    name: "time_frame",
    defaultValue: "24h",
    defaultActive: true,
  },
  {
    name: "limit",
    defaultValue: "10",
    defaultActive: true,
  },
  {
    name: "title",
    defaultValue: '"Software Engineer" OR "Data Scientist"',
    defaultActive: true,
  },
  {
    name: "location",
    defaultValue: '"New York, United States" OR "San Francisco, United States"',
    defaultActive: true,
  },
];

export const searchHeaders = [
  {
    name: "Authorization",
    defaultValue: "Bearer YOUR_API_KEY",
    defaultActive: true,
  },
];



Fantastic.jobs' API makes it easy to search active job listings with minimal delay.
To get started, let's search for `Software Engineer` or `Data Scientist` ATS jobs in
`New York, United States` or `San Francisco, United States` using the `title` and
`location` query parameters with `OR` to combine multiple values. We'll also limit
the response to `10` results from the last `24h`.

Use the playground below to send a `GET` request to
`https://data.fantastic.jobs/v0.9/active-ats` with your API key.

<OpenPlaygroundButton
  server="https://data.fantastic.jobs"
  method="get"
  url="/v0.9/active-ats"
  queryParams={searchQueryParams}
  headers={searchHeaders}
>
  Open in Playground
</OpenPlaygroundButton>

That's it. Open the playground, add your API key, and you should get back a filtered list of
ATS job listings that match this search.

## Try another search

To test other searches, keep the same endpoint and change just the `title` and `location`
parameters in the playground.

:::note{title="How to structure the `location` parameter"}

`location` requires **full names** (no abbreviations), for example:  
`California, United States`.\
Combine multiple locations with `OR`, quoting multi-word values:\
`"San Francisco" OR "New York"`.


For UK searches, include the constituent-country when searchin on a city level. For example: `Birmingham, England, United Kingdom`.


:::

## What's next?

Check out the full [`/api`](/api) reference to explore more filters like `organization`, `source`,
`seniority`, and AI-enriched fields.