> For the complete documentation index, see [llms.txt](https://docs.adsecure.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adsecure.com/docs/guides/select-a-specific-location.md).

# Select a specific Location

In this guide we're going to see how you can select a specific [location](/docs/development/concepts.md#location) when creating a new [analysis](/docs/development/concepts.md#analysis).

> If you're not familiar with GraphQL, please have a look at its [dedicated section](/docs/graphql/overview.md) in this documentation.

The AdSecure crawler is able to simulate in a different way a user that is going to interact with the web content you want to analyse. One of the key points of this feature is the selection of a specific [location](/docs/development/concepts.md#location).

In this guide, we're going to configure our analysis in order to be connected through a mobile connection in the United States.

## Prerequisites

Before starting this guide, please be sure that you're ready to use our service by following the steps illustrated in the [Quickstart](/docs/development/quickstart.md) section.

## Simple case

At AdSecure, a location is a combination of 3 parameters:

* The location's `country` which represent the [ISO 3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) code of a country.
* The connection's `type` you want to use. It could take one of the following values:
  * `STANDARD` for a connection issued by a data-center.
  * `RESIDENTIAL` for a connection issued by a private computer.
  * `MOBILE` for a connection issued by a mobile device.
* The `provider` which represent the connection's provider that is going to be used.

> The entire list of [`Location`](/api/graphql/enums.md#isoalpha3code) is available and can be retrieved by running the following query:
>
> ```
> query {
>  locations(first: 1000) {
>    nodes {
>      provider
>      country
>      name
>      type
>      enabled
>    }
>  }
> }
> ```

The next steps are quite similar to the one that we've done previous in the in the [First Analysis](/docs/guides/first-analysis.md) guide. From this previous example, we just need to fill the `input.location` field:

**Query**

```bash
mutation {
  createAnalysis(input: {
    content: "https://examples.adsecure.com/simple",
    location: {
      country: USA,
      type: RESIDENTIAL,
      provider: "OTHER"
    }
  }) {
    id
    location {
      country
      type
      provider
    }
  }
}
```

**Response**

```json
{
  "data": {
    "createAnalysis": {
      "id": "YW5hbHlzaXN8YThiYzk0M2ItNTY3ZS00NzA5LWIwOWItMTI1YmMzNGMxMjUwfDIwMTgtMDktMDI=",
      "location": {
        "country": "USA",
        "type": "RESIDENTIAL",
        "provider": "OTHER"
      }
    }
  }
}
```

The AdSecure crawler is going to be connected to a mobile device located in the United States with the AT\&T service.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adsecure.com/docs/guides/select-a-specific-location.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.